Welcome!
Welcome to the Marin Software Support Center. We're glad you're here. Here's what you can look forward to:
  • Real-time search so you can find what you need faster than ever.
  • Easy-to-follow video guides for our most popular articles.
  • Interactive simulations and Live Screenshots to make learning easy.
  • Regular content updates to ensure every word you read is accurate and up-to-date.

Revenue and Conversion Tracking

Home > English > Revenue and Conversion Tracking > Tracking IDs & Parameters > How To Articles: Tracking IDs & Parameters > Tracking Parameters and the Tracking ID Parser

Tracking Parameters and the Tracking ID Parser

Introduction

Once you have set up tracking parameters in the URL Builder in Marin, you can then identify each tracking parameter so that the platform knows where to look to find an object's tracking ID, creative ID, keyword text, placement, match type, and more information from within a URL. This helps the platform identify the relevant tracking information in order to attribute revenue to the appropriate object(s).

You can find the full list of supported parameters toward the end of this article. 

Note: If you do not use Marin Tracker, you will only need to set up Marin IDs (Tracking & Sitelink) in the Tracking ID Parser. 

How to Set Up Tracking Parameters

If you would like to learn more about tracking parameters, check out our Tracking Parameters Advanced Guide.

We would like to identify the tracking parameters that are used in the URL Builder and then update our Tracking IDs with the relevant parameters. 

In this scenario, the URL Builder has been set up to include the following parameters:

mkwid=[distribution][uniq_id]&pcrid=[creative_id]

 

Below is the process you need to follow to set up Tracking IDs in MarinOne. We've used this URL Builder setup as an example, but if your own URL Builder setup is different, simply swap out the example parameters for your own. 

 

  1. The first step, as always, is to log into MarinOne. 
     
  2. Next, click on the Admin tab in the bottom-left navigation. 
     

    m1idp1.jpg


     
  3. From the top navigation, select Revenue & Tracking
     

    m1idp2.jpg


     
  4. Then, select the Tracking IDs sub-tab. 
     

    m1idp3.jpg


     
  5. To add a new Tracking ID, click on the Create button ('plus sign' icon)m1idp4.jpg
     
  6. From the Parameter Type drop-down, select the ad information you'd like Marin to start tracking (i.e. Keyword, Ad, etc.). 

     

    m1idp5.jpg


     
  7. Under Parameter Name, you can provide the string that uniquely identifies where in the URL this information can be found. This will be the name portion of the name=value pair. 

    For example, if your full parameter is mkwid=[distribution][uniq_id], then the Parameter Name would be mkwid
     
  8. Next, from the Stop Character drop-down, select the stop character you would like to use. This indicates the character immediately following your parameter value and it tells the parsing system when to stop looking for a certain piece of information. This is optional for some types of parameters and required for other types of parameters.

    In the example used above:  

    mkwid=[distribution][uniq_id]&pcrid=[creative_id] 

    T
    he stop character for our mkwid parameter is is &
     

    m1idp6.jpg


     
  9. For some tracking parameters, we will also require that you populate the Value Separator character, selecting the character you would like to use from the drop-down. This will indicate the character that comes between the parameter name and the parameter value. 

    For example, if your full parameter is mkwid=[distribution][uniq_id], then the Value Separator would be = ('equal sign').
     
  10. When you're ready to add your new parameter, select Apply
     

    m1idp7.jpg


     
  11. If you'd like to add another parameter, simply click on the Create button ('plus sign' icon) once more and repeat the process until all of your parameters have been added. 

    In our example parameter, we have one more parameter to add, which would be set at the Ad level using the Parameter Name of pcrid. There is no Stop Character required for this example. 
     

    m1idp13.jpg

     

    Note: When using the Platform Tracker, you need to fill out all of the sections (i.e. Tracking ID, Keyword, Creative, Match Type, etc.) for them to appear in the revenue file. If you are on any other integration method, you only need to fill out the Tracking ID.
     
  12. When all of your new parameters have been added, select Save in the bottom right-hand corner of the page.
     

    m1idp9.jpg


     
  13. If you do not wish to save your changes, simply click Revert in the bottom right-hand corner of the page (next to the Save button).
     

    m1idp10.jpg


     
  14. If you try to navigate away from the Tracking IDs tab without hitting Save, you will receive a notification indicating that there are unsaved changes. You will have an opportunity to either Discard Changes or Save Changes
     

    m1idp11.jpg
     

  15. To delete any previously-created parameters, simply select the check-box next to the parameter and choose the Delete button ('trash can' icon). m1idp12.jpg

    Then, as normal, you will still need to select Save in the bottom-right in order to finalize this update. 

    Note: Approach this step with caution, as there is not currently a way to restore deleted parameters, however if you have not yet saved your updates, you can simply click Revert

Supported parameters

The full list of parameters that are supported in the Tracking ID Parser is listed below. 

  • Marin tracking ID
  • Marin sitelink ID
  • Publisher creative ID
  • Publisher keyword text
  • Publisher placement
  • Publisher match type
  • Publisher device
  • Publisher product ID
  • Publisher group ID
  • Publisher target IDs
  • Publisher audience ID

Guidelines for keyword ID parameters

  • Parameters are case insensitive.
  • Distribution parameters ({ifsearch:s}{ifcontent:c}, {MatchType}) can be used as part of the Tracking ID.

Things To Consider 


Single Vs. Multiple Parameters 

Multiple parameters is preferred for readability and future compatibility. Use single parameters with systems like in-house tracking, Omniture, or Google Analytics where only one parameter can be captured. Note that with single parameter, you generally will still have a delimiter and identifying parameter.
 

Multiple-Parameter
http://www.url.com?mkwid=SU23saCZ6&pcrid={creative}

Single-Parameter
http://www.url.com?mkwid=SU23saCZ6!pcrid!{creative}
 

Parameter Name

Value

Purpose

mkwid

SU23saCZ6

Unique Keyword/ Creative Level tracking ID

pcrid

1234567

Creative ID dynamically inserted at the publisher

Keyword-Level Vs. Creative-Level URLs 

You can manage your URLs at the keyword-level, creative-level or both. Your URL setup depends on the revenue integration and sometimes preference. There are a few items to be aware of to manage your URLs corectly.

  • When using keyword-level URLs, you need a unique id and creative id. You may also include the keyword text, MatchType and Device.
  • If you tag your keywords, then the creative will inherit the keyword URL.
  • When using creative-level URLs, you need a creative id, keyword text and MatchType parameter. You may also need a unique ID and device parameter.
  • For Microsoft keyword-level urls, you need to use {Param1} for all creatives.

Beyond keywords and creatives, your Shopping Campaigns, Microsoft PLAs, placements and ad extensions will require tracking if your revenue integration requires tracking. Specific tracking requirements for each of these objects can be found in the relevant Support Center articles.

 

Parameter Name

Value

Purpose

kw

{keyword}

Dynamic insertion parameter for Google/Microsoft keyword

matchtyp

{matchtype}

Dynamic insertion parameter matchype on Google/Microsoft

pcrid

{creative}|{adid}

Dynamic insertion parameter for Google|Microsoft

crid

(static ID)

static ID built by Marin

mkwid

(static ID)

static ID built by Marin

Marin Redirect URLs 

Marin supports URL re-directs for revenue integrations that require re-directs. Tracking parameters are required for these integrations. A re-direct URL is comprised of two parts - the re-direct and the landing page URL.

Depending on the revenue integration, tracking params may be required in the re-direct, the landing page portion or both. You can review the integration documentation for specific re-direct requirements or submit a support case to review your re-direct setup.

Are Tracking Parameters Required? 

If you solely rely on publisher tracking via Microsoft, Google and/or Facebook, then you do not need tracking parameters. If you rely on another revenue source, such as Tracker, Google Analytics, etc, then you will likely need tracking parameters.

Important notes

  • If you use a distribution parameter with your Tracking ID, the application will save IDs with and without the distribution string. For example, if the tracking id for a keyword is {ifsearch:s}{ifcontent:c}123abc, then the application will save s123abc, c123abc, and 123abc as IDs for the keyword.
  • When using the Platform Tracker, you need to fill out all of the sections (i.e. Tracking ID, Keyword, Creative, Match Type, etc.) for them to appear in the revenue file. If you are on any other integration method, you only need to fill out the Tracking ID.
  • Parameters must have a non-alphanumeric character on either side to delimit them, for example ?mkwid= , /mkwid/, -mkwid= etc. By default the value is assumed to be terminated by the next &. You can specify a different character by entering it in the stop after sequence for the Tracking ID.
  • Our application does not support positional values (where the parameter is implied by the location of the value in the URL).
  • Please do not consecutively click Save on this setting multiple times because this will take a longer time for the system to process each request. After you have clicked Save once, please wait for this job to finish processing before clicking Save again. This job can be monitired by checking on the spinning tasks that appears on the upper-right corner of the Platform.
  • If you're using Product-level tracking for Google Shopping Campaigns, please refer to our dedicated Support Center article for more information
Last modified

Tags

Classifications

Complete
MarinOne
Complete

 

wiki.page("Internal/Mindtouch_Launch_Sandbox/js.cookie.js")