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 > URLs & URL Builder > How To Articles: URLs & URL Builder > The MarinOne URL Builder

The MarinOne URL Builder

Introduction

The URL Builder allows you to create, apply, and manage Tracking Templates, Custom Parameters, Redirects and more across publishers and tracking solutions in MarinOne.

In this article, we'll show you how the URL Builder works in MarinOne, how it differs from the tool that's available in Marin Search, and how you can use it to streamline your tracking across publishers.

If you are currently using the URL Builder in Marin Search, all of your settings will be visible in MarinOne automatically. There is no migration required. 

Supported Publishers

Currently, the MarinOne URL Builder supports two publisher options:
 

  • Google
  • Other
     

Google URL Builder settings can be managed locally in MarinOne, while the 'Other' publishers option will serve as a Quick Link back to the URL Builder in Marin Search. All non-Google URL Builder settings should be managed via the 'Other' option. To manage your URL Builder settings for publishers other than Google, please refer to our dedicated article

We plan to gradually roll out URL Builder settings for the remaining publishers locally in MarinOne in future releases, so stay tuned for additional information. 

You can navigate between publishers using the Publisher drop-down in the top-left of the URL Builder.
 

urlb1.jpg

Navigating to the URL builder


You can navigate to the URL Builder in MarinOne by following the instructions below. 

 

  1. The first step, as always, is to log into MarinOne.
     
  2. Next, click on the Admin tab ('gear' icon) in the bottom-left corner of the platform. 
     

    urlb2.jpg
     

  3. Then, click on the Revenue & Tracking tab along the top navigation. 
     

    urlb3.jpg
     

  4. From here, click on the URL Builder sub-tab. 
     

    urlb4.jpg
     

how to set up the URL Builder


Though your precise settings may vary from one MarinOne Client Account to the next, in general you will set up the URL Builder as follows:

  1. Select the publisher for which you want to define tracking settings. 
  2. Define revenue integration parameters and any redirect settings
  3. Select specific objects to which you want the URL Builder to add tracking information (e.g. build account-level tracking templates, as well as campaign, keyword, creative-level custom parameters, campaign- and account-level Final URL Suffix, and more).

Once these steps are complete, new objects and objects that you edit will automatically have these URL Builder settings applied.

Tracking Templates


Think of your URL Tracking Templates as the "building blocks" of a tracking template. Typical integrations see one Tracking Template for one set of query string parameters. If redirects are used, the redirect can also be part of Tracking Templates. 

For more information from Google on Tracking Templates, check out this Google Help Article

Parameter encoding

Marin will automatically encode the value of [_lpparams] appropriately, depending on the settings specified in the Redirect Panel.

selecting the object level for your tracking template

The default tracking template level is Account, but you can add or edit tracking templates at any object level.

The object level you have selected will determine which level template you are working on. You'll see your existing Tracking Templates along the top navigation as sub-tabs. 
 

urlb5.jpg
 


If you have defined templates at different levels, the template from the lower hierarchy level will apply. For example, If a template is set both at the Account and Creative level, if a user clicks on the creative, the keyword which triggered the creative will inherit the creative-level template.

list of supported google object levels

 

  1. Account Template: Defines a PCA tracking template. Applies to all PCAs.
     
  2. Campaign Template: Defines a campaign tracking template. Applies to all campaigns.
     
  3. Group Template: Defines a group tracking template. Applies to all ad groups.
     
  4. Keyword Template: Defines a keyword tracking template. Applies to all keywords.
     
  5. Creative Template: Defines a creative tracking template. Applies to all creatives.
     
  6. Product Target Template: Defines a product target tracking template. Applies to all product targets.
     
  7. Placement Template: Defines a placement tracking template. Applies to all placements.
     
  8. Sitelink Template: Defines a sitelink tracking template. Applies to all sitelinks.
     

Creating a new tracking template

You can create a new Tracking Template by following the instructions below. 
 

  1. From the MarinOne URL Builder, click on the hamburger menu ('three lines' icon) in the top-right. 
     
  2. Select Create New Template
     

    urlb6.jpg
     

  3. To create a new Tracking Template, select the level at which you'd like to place your new template. The available options in this list will show the levels at which a Tracking Template does not yet exist. For example, if you have already created Tracking Templates at the Account, Campaign, and Group levels, this list might include Keyword, Creative, Sitelink, Product Group, and Placement.

    If you don't see a Tracking Template option included in this list, check the available Tracking Templates that have already been created in your account. From there, you can make any required edits. We'll talk more about editing Tracking Templates in the next section of this article.

    Once a Tracking Template has been created for a given object level, you will not be able to create a new Tracking Template at the same level. 
     
  4. From your desired Tracking Template, you can add redirects and Landing Page Parameters as needed. Toggle the Redirect Level buttons to NoneSingle, or Double.

    You can click directly into the Landing Page text box to apply any parameters needed.

    From here you will find a variety of handy Tracking IDs, ValueTrack Parameters, Marin Macros, and Stop Characters along the bottom of the edit pane to make building out your Custom Parameters quick and simple. 
     

    urlb7.jpg
     

  5. Once you've started adding to your Tracking Template, the Apply button will appear in the bottom right-hand corner of your editing pane. Click this to add your latest changes to the Final Template or Final URL Suffix fields at the bottom of your Tracking Template, in the Preview section. This will help you to see the structure your Tracking Template will use. 

    You can apply changes periodically while working in the URL Builder or all at once when your changes are complete -- this is entirely up to your personal preference. 
     
  6. Should you change your mind in the middle of adding to your Tracking Template, prior to clicking Save, you can click Revert in the bottom right-hand corner of the page to revert your Tracking Template to the previously-saved version.
     

    urlb8.jpg


    Note: The Revert button only works when you are mid-edit. Once your changes have been Saved, this button will no longer roll back your recent changes. You can also hit Cancel in the bottom-right of the edit pane to accomplish the same task. Revert will roll back changes to the entire page, while Cancel will roll back changes for this specific field.

     

    urlb9.jpg

     

  7. Once you've finished making edits to your Tracking Template, have applied your changes, and are happy with the Final URL at the bottom of the page, click Save in the bottom right-hand corner of the page.
     

    urlb10.jpg

Editing a Tracking Template

You can edit an existing Tracking Template by following the instructions below.

 

  1. From the MarinOne URL Builder, click on the desired Tracking Template. You'll see your existing Tracking Templates along the top navigation as sub-tabs. 
     

    urlb11.jpg
     

  2. Next, go ahead and make any necessary updates to your Redirects, Landing Page, encoding, and Final URL Suffix.
     
  3. Should you change your mind in the middle of applying edits to your Tracking Template, prior to clicking Save, you can click Revert in the bottom right-hand corner of the page to revert your Tracking Template to the previously-saved version.

    Note: The Revert button only works when you are mid-edit. Once your changes have been Saved, this button will no longer roll back your recent changes. You can also hit Cancel in the bottom-right of the edit pane to accomplish the same task. Revert will roll back changes to the entire page, while Cancel will roll back changes for this specific field.
     
  4. Once you've finished making edits to your Tracking Template, have applied your changes, and are happy with the Final URL at the bottom of the page, click Save in the bottom right-hand corner of the page.
     

    urlb10.jpg

Deleting a tracking template

You can delete an existing Tracking Template by following the instructions listed below. 

 

  1. From the MarinOne URL Builder, click on the desired Tracking Template. You'll see your existing Tracking Templates along the top navigation as sub-tabs. 
     

    urlb11.jpg

  2. Once you're on the desired Tracking Template, click on the hamburger menu ('three lines' icon) in the top-right. 
     
  3. Select Delete Template
     

    urlb12.jpg
     

  4. From the Confirmation pop-up, select OK
     

    urlb13.jpg


    Note: Use caution when deleting Tracking Templates, as there is not currently a way to restore previously-deleted templates. 

Applying The Tracking Template  

When creating new objects (Campaigns, Groups etc.), if a Tracking Template exists at the level of that object, it will be applied right away during the creation process. The URL Builder value will override Tracking Template settings established during the creation process, even if left blank. If no Tracking Template exists at the level of the new object, a template will not be applied. 

The same is not true for existing objects -- saving the URL Builder will not apply the Tracking Template to existing objects. To apply the saved URL Builder settings, you will need to perform a single edit or multi-edit in the platform. You can learn how it's done in the steps below. 

 

  1. Click on the tab associated with the level of the Tracking Template you wish to apply. For example, if you'd like to apply an account-level Tracking Template, click on the Publishers tab. If you'd like to apply a campaign-level Tracking Template, click on the Campaigns tab, etc.
     
  2. Next, select the check boxes next to one or more Google objects where you wish to apply your Tracking Template. .
     
  3. Click on the Edit button and kick off any single or multi-edit you wish. This could be a small adjustment to the Search Bid or Daily Budget -- any single or multi-edit on the selected objects will do the trick. 

    Note: It it not currently possible to edit your Tracking Template directly from a single or multi-edit, however, kicking off any single or multi-edit on the objects where you wish to apply your Tracking Template will trigger the URL Builder to run and the Tracking Template to be applied. 
     
  4. Then, hit Apply.
     
  5. Once you've applied your changes, check the Activity Log, find and select the corresponding activity, and post the Tracking Template to Google. If you do not manually post this activity to the publisher, not to worry -- it will post automatically during the nightly sync. 

redirect Levels


The Redirect Panel allows you customize your URL setup in your Tracking Templates by specifying whether or not you have URL redirects enabled as well as the precise redirect you plan to use. If you are using redirects, you can also specify the encoding level of your redirect URLs and landing page. 

The available redirect settings are:
 

  • None: Select this option if no redirects are needed.
  • Single: For URLs with a single redirect.
  • Double: For URLs with a double redirect.
     

If you select Single or Double, a corresponding redirect field will show up in your Tracking Template along with the encoding options. You will see encoding buttons for N (None), S (Single), and D (Double) next to your redirect settings. 

enabling redirects

To enable redirects, follow the instructions below.

 

  1. From the MarinOne URL Builder, click on the desired Tracking Template. You'll see your existing Tracking Templates along the top navigation as sub-tabs. 
     

    urlb11.jpg
     

  2. Select whether you are using Single or Double redirects and click the corresponding button. 
     

    urlb14.jpg
     

  3. Enter the Redirect URL you are using For example, if you're using Marin Tracker, your redirect might be: tracker.marinsm.com/rd?. The precise redirect you use will vary depending on the type of tracking you're using. 
     

    urlb15.jpg
     

  4. Input the necessary Connector Parameter (i.e. lp= ) directly into your redirect text box or boxes. 
     
  5. Select the necessary encoding using the N (None), S (Single), and D (Double) boxes next to your redirect settings. 
     

    urlb16.jpg
     

  6. Fill in the remaining Tracking Template settings as needed and then click Save in the bottom right-hand corner of the page.
     

    urlb10.jpg

the Final Template (Preview Field)


As you build out your landing page, redirects, and custom parameters, you will see your Final Template start to build out at the bottom of your Tracking Template.

 

urlb17.jpg

 

This template is a combination of three things:
 

  • Redirect URL (if used)
  • Landing Page
  • Landing Page parameters
     

If you are using the Final URL Suffix, which we'll learn more about in the next section, these parameters will be visible in a separate preview field.


This field is also color-coded to help you easily identify the Landing Page Parameters and redirects that are being used to build out the Final Template. Note that the color box next to the field name corresponds with the highlight used in the Final Template. 
 

urlb18.jpg

Final URL Suffix


In Google Ads, the Final URL Suffix allows you to enter parameters that will be appended to the end of your Landing Page URL in order to track where users go after they click on your ad. This helps separate your Landing Page Parameters from your Tracking Template.

The Final URL Suffix is currently available in the Account and Campaign Tracking Templates within the MarinOne URL Builder. Encoding will not be applied to your Final URL Suffix, since it is not part of a Tracking Template.

Note: The Marin Search URL Builder does not yet support editing of the Final URL Suffix, so if you'd like to make edits to the Final URL Suffix via the URL Builder, this will need to be done in MarinOne. You are still able to edit the Final URL Suffix in Marin Search outside of the URL Builder via either multi-edit (for Accounts) or bulk upload (for Campaigns). 

how to enable final uRL Suffix

You can enable Final URL Suffix by following the instructions below. 

 

  1. From the MarinOne URL Builder, create a new Tracking Template or edit an existing template by following the instructions listed in the Tracking Template section earlier in this article. 
     
  2. From your Tracking Template, cllick the Use Final URL Suffix check-box to enable Final URL Suffix. 
     

    urlb19.jpg
     

  3. Click the Save button in the bottom right-hand corner. 
     
  4. After this, you will see a confirmation dialog box. Select Okay to proceed or Cancel to revert. 

    Note: Once Final URL Suffix has been enabled and saved, it cannot be disabled, but it can be edited.
     

Once the Final URL Suffix check-box has been enabled, the Landing Page field becomes the Final URL Suffix field and only the parameters are visible in this field, rather than the Landing Page and the associated parameters. The encoding for this field becomes N (None), regardless of the redirects that have been set. 

If redirects are not enabled and Final URL Suffix is enabled, this will leave your Tracking Template blank and append your parameters after the Tracking Template. 

If single redirects have been enabled with Final URL Suffix, your Tracking Template will essentially be the Redirect 1 field. If double redirects have been enabled with Final URL Suffix, your Tracking Template is formed using a combination of the Redirect 1 and Redirect 2 fields. 

final uRL Suffix Preview

If Final URL Suffix is enabled for a particular level, at the bottom of the page, you can see your Final URL Suffix preview in addition to your Final Template. The Final Template represents the Tracking Template. The Final URL Suffix, on the other hand, represents only the parameters that will be applied as part of the suffix after the Tracking Template. 
 

urlb20.jpg
 

Applying the Final URL Suffix

Once your Final URL Suffix settings have been created, you will still need to apply it at the appropriate object level. 

To learn more about applying the Final URL Suffix, check out our dedicated article

Custom Parameters


Google Custom Parameters allow a user to specify URL snippets (in the form of key/value pairs) that can be substituted by Google when the ad is served on Google properties. Custom parameters will not be substituted into a Tracking Template unless they are explicitly referenced.

For example, if your Tracking Template is defined as:

http://www.example.com?mkwid={_mkwid}

and your keyword custom parameter is defined as: {_mkwid}=abc123, when Google Ads serves an ad on that keyword, the URL will contain the resolved custom parameter:

http://www.example.com?mkwid=abc123

where the specific object (Keyword, Placement, Product Group, etc.) is defined by the string abc123.

Custom Parameters can be set by Bulk Upload for any Google objects, however, by defining them in the URL Builder, you can let Marin add them automatically. Because Custom Parameters are used to contain URL snippets that differ across objects, most custom parameters defined in the URL Builder will have values that are Marin Macros. Read more about these macros here: Platform URL Parameters

To set up the URL Builder so that all keywords are given a custom parameter containing Marin’s unique tracking parameter, you would define: {_mkwid}=[uniq_id] in the URL Builder and the appropriate value will then be substituted into each keyword when the URL Builder settings are applied. In the case above, the example keyword’s [uniq_id] resolved to “abc123”.

Navigating to custom parameters

You can navigate to your existing Custom Parameters by following the instructions below. 

 

  1. From any Tracking Template in the URL Builder, click on the Custom Parameters button on the right-hand side of the page. 
     

    urlb21.jpg
     

  2. This will show you the Custom Parameters that have been set up at all Tracking Template levels. This is a change in behavior compared with the Marin Search URL Builder, where it was necessary to drill into the specific Tracking Template first. Now, you can see all of your Custom Parameters in a single spot. 
     

    urlb22.jpg
     

Creating a new custom parameter

You can create a new Custom Parameter by following the instructions below. 

 

  1. From the MarinOne URL Builder, click on the Custom Parameters button on the right-hand side of the page. 
     

    urlb23.jpg
     

  2. Click on the orange +New button on the right-hand side. 
     

    urlb24.jpg
     

  3. Give your Custom Parameter a Name, define its Level (Campaign, Group, Keyword, etc.), and then you can set up your Custom Parameter based on your specific needs.
     

    urlb25.jpg
     

  4. Along the bottom of the text box you will find a variety of handy Tracking IDs, ValueTrack Parameters, Marin Macros, and Stop Characters to make building out your Custom Parameters quick and simple. 
     

    urlb26.jpg


    Using the example we saw earlier in this article:
     
    http://www.example.com?mkwid={_mkwid}

    In this example, give your Custom Parameter the name mkwid. Then, using the Marin Macros drop-down, you can select [uniq_id]. Then, the appropriate value will then be substituted into each keyword when the URL Builder settings are applied at the specific object level.

    Note: Due to a Google limitation, you can create a maximum of three custom parameters per object level. This means three at the campaign level, three at the group level, and so forth down the account hierarchy. 
     
  5. When all of the appropriate information has been filled in for your new Custom Parameter, click Save at the bottom-right of the dialog box. 
     

    urlb10.jpg

Editing a Custom parameter

You can edit an existing Custom Parameter by following the instructions below. 

 

  1. From the MarinOne URL Builder, click on the Custom Parameters button on the right-hand side of the page. 
     

    urlb23.jpg
     

  2. Once you've identified the desired Custom Parameter that you'd like to edit, click on the Edit button ('pencil' icon) on the right-hand side of the page. 
     

    urlb27.jpg
     

  3. From here, you can make any changes that you need to make to your Custom Parameter. 
     
  4. When your changes are complete, click Save
     

    urlb10.jpg
     

Deleting a custom parameter

You can delete an existing Custom Parameter by following the instructions below. 

 

  1. From the MarinOne URL Builder, click on the Custom Parameters button on the right-hand side of the page. 
     

    urlb23.jpg
     

  2. Once you've identified the desired Custom Parameter that you'd like to delete, click on the Edit button ('pencil' icon) on the right-hand side of the page. 
     

    urlb27.jpg
     

  3. From here, click the red Delete ​​​​​​button in the bottom-left corner. 
     

    urlb28.jpg


    Note: Use caution when deleting Custom Parameters, as there is not currently a way to restore previously-deleted Custom Parameters. 
     
  4. From the Confirmation pop-up, select OK
     

    urlb29.jpg
     

Applying Custom Parameters  

When creating new objects (Campaigns, Groups, etc.), if Custom Parameters exist at the level of that object, they will be applied right away during the creation process. The URL Builder value will override Custom Parameter settings established during the creation process, even if left blank. If no Custom Parameters exist at the level of the new object, no Custom Parameter settings will be applied. 

The same is not true for existing objects -- saving the URL Builder will not apply Custom Parameters to existing objects. To apply the saved URL Builder settings, you will need to perform a single edit or multi-edit in the platform. You can learn how it's done in the steps below. 

 

  1. Click on the tab associated with the level of Custom Parameter you wish to apply. For example, if you'd like to apply a campaign-level Custom Parameter, click on the Campaigns tab. If you'd like to apply a group-level Custom Parameter, click on the Groups tab, etc.

    Note: Custom Parameters do not exist at the account level.
     
  2. Next, select the check boxes next to one or more Google objects where you wish to apply your Custom Parameters. 
     
  3. Click on the Edit button and kick off any single or multi-edit you wish. This could be a small adjustment to the Search Bid or Daily Budget -- any edit on the selected objects will do the trick. 

    Note: It it not currently possible to edit your Custom Parameters directly from a single or multi-edit, however, kicking off any single or multi-edit on the objects where you wish to apply your Custom Parameters will trigger the URL Builder to run and the Custom Parameters to be applied. 
     
  4. Then, hit Apply.
     
  5. Once you've applied your changes, check the Activity Log, find and select the corresponding activity, and post it to Google. If you do not manually post this activity to the publisher, not to worry -- it will post automatically during the nightly sync. 

autocorrect

The URL Builder can apply URL settings to objects every time they are synced into Marin. To learn more about URL Autocorrect, check out our dedicated article

How to enable autocorrect

You can enable Autocorrect by following the instructions below. 

 

  1. From any Tracking Template or tab in the MarinOne URL Builder, navigate to Autocorrect Preferences at the bottom of the page. 
     

    urlb30.jpg
     

  2. From here, set Autocorrect to OnOff, or Warn. 
     

    urlb31.jpg
     

  3. Finally, click Save. Your Autocorrect settings will apply to your entire MarinOne Client Account.

 

 

 

Last modified

Tags

Classifications

This page has no classifications.

 

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