Quantcast
Channel: AdRoll Support » Implementation
Viewing all 11 articles
Browse latest View live

Guide to Segmenting Clicks with AdRoll

$
0
0

AdRoll’s SmartPixel allows for powerful URL-based segmentation, but there are instances where code might be needed to segment your audience.

Internal Site Page Clicks

If you have two links that direct visitors to the same internal page, such as different buttons on different landing pages, you can segment the traffic from the different buttons.

Clicks on links that direct visitors to internal pages on your site can be tracked by adding internal campaign tracking codes.

Most marketers are familiar with the practice of adding external campaign tracking codes to their external marketing links for tracking purposes.  Google Analytics has a standard which use uses utm tracking codes for tracking. You can view the AdRoll article on adding external tracking codes for more information.

Internal links can also be tracked and segmented with tracking codes, but instead of using utm codes, advertisers should add distinct tracking code parameters to internal links they want to segment.

Edit your internal links to add a query parameter such as link_tracking=<link identifier> to the end of the destination URL.  Make sure the destination URL has the AdRoll pixel code.

<a id="link1" href="http://example.com/path/page?link_tracking=link1">Link #1</a>

<a id="link2" href="http://example.com/path/page?link_tracking=link2">Link #2</a>

Both these links have the same destination and user experience but can be segmented separately in AdRoll.

In-page javascript and AJAX

You can track links that don’t prompt the browser to change it’s location, by executing additional javascript.

Include the AdRoll pixel on the page.

Setup and name a segment within the AdRoll dashboard

When the link is clicked, executing the following javascript:

__adroll.record_user({"adroll_segments": "segment_name"});

Be sure to populate the segment name in the code with the corresponding value you setup in the AdRoll dashboard.

External destination link clicks

To track pages that direct visitors to destination pages where you cannot place AdRoll pixel code, you have to use javascript to track the click as the click happens.  This is accomplished by intercepting the click, tracking the action, adding a small 250 millisecond delay to the user to allow tracking and then forwarding the user to their destination.

javascript version:

<script type="text/javascript">
	function trackExternalLink(link, segment) {
		try {
			__adroll.record_user({"adroll_segments": segment});
			setTimeout('document.location = "' + link.href + '"', 250)
		} catch(err){}
	}
</script>

<a id="free_ticket" href="http://www.google.com/" onClick="trackExternalLink(this, 'example_segment_name');return false;">example anchor text</a>

jQuery version:

<script type="text/javascript">
	// Requires jQuery 1.7 or higher (use .live if using a lower version)
	$("#example_segment_name").on('click',function(e){
		try {
			__adroll.record_user({"adroll_segments": $(this).attr(id)});
			var newtab = (e.metaKey || e.ctrlKey) ? true : false;
			if (!newtab) {
				e.preventDefault();
				setTimeout('document.location = "' + $(this).attr("href") + '"', 250);
			}
		} catch (err) {}
	});
</script>

<a id="example_segment_name" href="http://www.example.com/page">example anchor text</a>

Enhanced Conversion Tracking

__adroll.record_user({"adroll_segments": "example_segment_name",
"adroll_conversion_value_in_dollars": "16.44", "order_id": "12345"});

The post Guide to Segmenting Clicks with AdRoll appeared first on AdRoll Support.


Why Isn’t My Pixel Firing?

$
0
0

Great question. Our SmartPixel is a container pixel that “hosts” the pixels and tags provided by our partner networks. They are loaded dynamically when a page is accessed. This allows for just one SmartPixel to be placed across your entire site and is much easier than placing scripts for each page.

That’s why it’s so smart! Here are the potential reasons and why your SmartPixel isn’t firing and a few quick tips on how to fix it:

Pixel is not placed directly before the closing body tag, </body>.  It is always best practice to include the SmartPixel directly before the </body> tag across your site. This ensures that AdRoll’s script is the last item on the page to load, and will have minimal effect on the rendering of page content.

Pixel has been modified.  The SmartPixel should be placed on all pages of your site, exactly the way you’ve copied it from your AdRoll dashboard. Please do not add to or edit the script in any way.

The wrong pixel has been placed.  If you have multiple advertiser profiles, please ensure the correct pixel is associated with the correct profile’s domain.

Our system hasn’t registered your pixel yet.  It can take up to 24 hours for your pixel to be recognized. It will not always be instantaneous!

If you believe you’ve met all of the outlined requirements and your pixel is still not firing, please email delight@adroll.com, and we’ll address the issue right away.

The post Why Isn’t My Pixel Firing? appeared first on AdRoll Support.

Miva Merchant Implementation & Custom Parameter Passing

$
0
0

We work well with others.

Implementing our SmartPixel with ecommerce platforms is easy, and Miva Merchant is no exception. Follow the steps outlined below to get started. It is important to note that the following steps assume that none of the default Miva Merchant store variables have been altered. If they have, you’ll have to consult the developer who implemented those new variables in order to get the right ones.

1.     Log into your Miva Merchant Store Admin
2.     On the left side column, select the link with your store’s name on it

3.     Select the Global Footer Tab

4.     Insert your SmartPixel in the Global Footer. This will cause the pixel to be placed across the entire site.

Your AdRoll SmartPixel is now installed across the entire website.

AdRoll Custom Parameter Passing Instructions

We know that our advertisers often times want more insight into their customers’ conversion data. To that end, we’ve put together customer parameter passing instructions for those Miva Merchant users who want to know about order id, order value, etc.

1.     Log into your Miva Merchant Store Admin
2.     Select “Pages” on the left hand column

3.     Search “INVC” to find your Invoice template, and select Edit.

4.     On the following page, scroll to the bottom and place the custom parameters code as well as the custom conversion segment. Make sure to copy and paste the exact code and place before the closing </body> tag.
5.     After you’ve inputted the code, select Update.

After you’ve completed the previous steps, you should be all set to go with your conversion tracking.

<script type="text/javascript">
	adroll_conversion_value_in_dollars = &mvt:order:total;
	adroll_custom_data = {"ORDER_ID": "&mvt:order:id;", "USER_ID" : "&mvte:order:ship_email;"}
</script>

The post Miva Merchant Implementation & Custom Parameter Passing appeared first on AdRoll Support.

Implementing Our SmartPixel: 3rd Party Ecommerce Platforms

$
0
0

ASPDotNetStorefront

Placing the AdRoll pixel on the ASPDotNetStorefront system requires modifying the template.ascx file, located in the App_Templates// directory. Within this file, simply find the closing body tag, and add the AdRoll pixel immediately before the tag. Save the file and reupload it to the proper directory if edited on your local machine.

3DCart

To place the AdRoll Smart Pixel in the 3dCart System, log in to your 3dCart page and navigate to the Admin page. Locate the column on the left side of the page and select Settings > Design > Header & Footer. In the Global Footer box, paste the AdRoll pixel at the end of the existing code on a new line. Click save and you can head back to AdRoll to finish setting up your campaign.

BigCommerce

To place the smartpixel code on your site, log into your BigCommerce Control Panel and click the Store Design link at the top of the page. Then, click the Browse Template Files button to open the Quick Edit editor in a new window. Next, select the footer.html template, and add the smartpixel code just before the tag. Select the Save button, and you can head back to AdRoll to finish setting up your campaign.

CoreCommerce

To place the AdRoll pixel on your CoreCommerece hosting platform, go to your Admin Panel, and click on Design, then Manage Design, then Edit HTML/CSS and edit the “footer.html” template. You can then add the AdRoll SmartPixel directly before the end /body tag.

FoxyCart

With Foxycart shopping cart hosting, you can edit the templates for your cart, checkout and receipt pages though your admin panel on foxycart.com. Simply login to your account, select the relevant template from the top menu, select the ‘Use a specific template’ radio button, then add the AdRoll pixel immediately before the closing body tag. Update your template and then verify that your cart, checkout, and receipt URLs match the URL rules set up on your AdRoll Retargeting Pixel page on your dashboard.

Joomla 1.5 & 1.51

First log on to http://www.yoursite.com/administrator. In the top menu, select “extensions” and “template manager.” Now, select the template marked default and click “edit.” In the template edit page, click “edit HTML.” Once in your template’s HTML, scroll down to the bottom of the code. On the second to the bottom line, you should see the tag </body>. Paste your AdRoll tracking code just before the tag and click “save.” AdRoll is not installed on your site.

Joomla 2.5

Navigate to your “Template Manager” and click on the name of the template you have currently activated. Under “Template Master Files”, clicked on “Edit Main Page Template.” Once there, scroll down to the end of the source code to get to the </body> tag. Paste our SmpartPixel JavaScript code right before this tag and click save and close. You have completed the pixel install!

Magento

To place the AdRoll pixel on the Magento system, first log in to your Magento account and click the System tab. From here, select Configuration. Next, under the General tab, select Design. Paste the AdRoll pixel code in the Miscellaneous HTML text field. Click the Save Config button to complete placement.

Miva Merchant (see our Miva Merchant Implementation Guide here)

Shopify

Shopify customers can automatically place the AdRoll pixel on their site by installing the AdRoll Retargeting App from the Shopify App Store. This app also entitles you to a free two-week trial of AdRoll Retargeting automatically.
To place the SmartPixel on your Shopify conversion page, you will need to access the Additional Content & Scripts section. You can do this by going to Preferences >> Checkout & Payment page. In the Order processing section, and selecting the Additional Content & Scripts box”. That box is where you add the AdRoll SmartPixel.

Ultracart

Log in to your Ultracart account and navigate to Configuration -> Screen Branding -> Screen Tab -> Select Theme. If you are using Single Page Checkout you only need to edit one screen. Once selected, go to the footer section at the bottom of the page and paste the AdRoll code immediately before the closing body tag. If you are using Multiple Page Checkout, simply select the option to copy to multiple pages or repeat the placement process for each screen of your checkout.

Vendio

To add the AdRoll pixel to your Vendio store, simply log in to the Vendio site and open the Template Editor. Once you have loaded the preview of your store click the Advanced menu and select Enable Advanced Mode. Then select the Edit HTML submenu and select to edit the __pagetpl.html file. When the code appears, scroll to the bottom and find the closing body tag. Paste the AdRoll pixel immediately before this tag and save the template.

WordPress

To add the AdRoll pixel to your self-hosted WordPress page, go to your dashboard and select Appearance and then Editor. From there, you can view your Templates, followed by php files. Select the “footer.php”, scroll down to the closing body tag, and place the pixel directly above it.

Yahoo Stores

To correctly place the AdRoll pixel, use the Store Editor in Yahoo!. You can enter or paste HTML within the large text boxes in your store pages and Final-text fields. Use the store editor to add the AdRoll retargeting pixel to all the shopping cart pages as well. Read more here: http://help.yahoo.com/l/us/att/smallbusiness/store/edit/regular/regular-02.html

ZenCart

To place the AdRoll pixel on the ZenCart system requires modifying the main site template file, tpl_main_page.php, located in includes/templates//common. Within this file, simply find the closing body tag, and add the AdRoll pixel immediately before the tag. Save the file and reupload it to the proper directory if edited on your local machine.

Don’t see your provider listed here? Tell delight@adroll.com whom you use, and our team can develop a solution for you.

The post Implementing Our SmartPixel: 3rd Party Ecommerce Platforms appeared first on AdRoll Support.

Open Cart Implementation and Custom Parameter Passing

$
0
0

Implementing our SmartPixel with ecommerce platforms is easy, and OpenCart is no exception. Follow the steps outlined below to get started. It is important to note that these instructions assume the default theme. If you’re using a theme other than the default, you’ll most likely need to replace “default” with your theme in the given file path.

Installing our SmartPixel

1. Open up the footer.tpl file found in  /catalog/view/theme/default/template/common/footer.tpl

2. Paste your SmartPixel right above the </body> tag.

AdRoll Custom Parameter Passing Instructions

We know that our advertisers often times want more insight into their customers’ conversion data. To that end, we’ve put together customer parameter passing instructions for those OpenCart users who want to know about order id, order value, etc.

1. Open up the success.php file found in /catalog/controller/checkout/success.php

2. Copy the following 2 lines and paste them immediately after the line that says if (isset($this->session->data['order_id'])) {

$this->session->data['AddShoppersAmount'] = $this->cart->getTotal();  $this->session->data['AddShoppersOrderID'] = $this->session->data['order_id'];

3. Open up the success.tpl file found in /catalog/view/theme/default/template/common/success.tpl

4. Paste your AdRoll CPP code in this file and save.

 

<script =”text/javascript”>
adroll_conversion_value_in_dollars = <?php echo $this->session->data['AddShoppersAmount']; ?>;
adroll_custom_data = {“ORDER_ID” : ”<?php echo $this->session->data['AddShoppersOrderID']; ?>”};
</script>

The post Open Cart Implementation and Custom Parameter Passing appeared first on AdRoll Support.

Shopify Parameter Passing & Test Transactions

$
0
0

Parameter Passing

Setting up custom parameter passing with Shopify is simple – follow these short steps to enable!

1. Navigate to “Preferences” and click “Checkout & Payment.” 

shopifypp2 shopifypp1

2. Add parameter passing code (and custom segment conversion tracking code).

shopifypp2

<script type="text/javascript">
    var conversion_value = '{{ total_price }}';
    conversion_value = conversion_value / 100;
    adroll_conversion_value_in_dollars = conversion_value;
    adroll_custom_data = {
        "ORDER_ID": "{{ id }}",
        "USER_ID": "{{customer.name}}"
    };
</script>

3. Save updated settings.

Test Transactions

Shopify makes it easy to test transactions with the Bogus Gateway. Don’t worry, no funds will get transferred into your Payment Gateway and you won’t be charged a fee. To use:

1. Navigate to “Settings” and click on “Checkout.”

ShopifyTT1

2. Scroll down to the “Payment Gateway” section and choose “Bogus Gateway” from the drop-down menu.

ShopifyTT2

3. Fill out required information as follows:

  • Credit Card Number: Input either 1 (successful transaction), 2 (failed transaction), or 3 (an Exception – Gateway is down error message will show) depending on what result you want. 
  • CSV: Use any 3 digit number (Ex. 111).
  • Expiry Date: Any date in the future will work.

The post Shopify Parameter Passing & Test Transactions appeared first on AdRoll Support.

Implementing with AdRoll’s Google Tag Manager Integration

$
0
0

In Google Tag manager, create a new tag and select AdRoll Smart Pixel under Certified Remarketing.

select-adroll-certified

Get your AdRoll smart pixel adroll_adv_id and adroll_pix_id values from the AdRoll Dashboard.

get-smart-pixel

Click “Get Smart Pixel” on the right of the dashboard home screen.

Your ids are listed in the javascript code.

adroll-pixel-code

Insert your adroll_adv_id and adroll_pix_id into the appropriate fields.

pixel-fields-tag-manager

Optionally pass conversion value.

You can optionally pass conversion value on conversion pages by setting up a macro for the conversion value field. Since your AdRoll tag will likely fire on all pages, make sure the macro only is populated on the conversion page.

conversion-value-tag-manager

The conversion value macro can be populated from various elements such as a javascript variable, DOM text or attribute, or a URL component. For more information on setting up Google Tag Manager macros, visit the Google Tag Manager’s macro reference article.

Optionally pass custom data.

Additionally you can pass custom data at conversion. You can setup a macro for each custom data field

custom-data-tag-manager

Add a rule to fire the tag on all pages.

Click the button to Add Rule to Fire Tag, so that you can tell Google to load the AdRoll tag on All Pages

firing-rule-tag-manager

Save this tag.

Now you’ll update your Tag by clicking “Create Version” in the top right corner.

create-version-tag-manager

You can then preview your changes, and when ready, click “Publish”.

publish-tag-manager

You’re done!

Additional resources on Google Tag Manager:
- Google Tag Manager Support
- Google Tag Manager Developer Guide
- All About Google Tag Manager – Justin Cutroni Blog
- Preview and Publish Tags with Google Tag Manager – Justin Cutroni Blog

The post Implementing with AdRoll’s Google Tag Manager Integration appeared first on AdRoll Support.

Volusion Parameter Passing

$
0
0

To set up parameter passing with Volusion, follow these easy steps:

1. Log into your admin panel, navigate to the “Design” tab and click “Site Content.”

VolusionPP1

2. Select “Article 130 OrderFinished.asp” and insert the attached script in the “Article Body”.

VolusionPP2

Script:

<script type=”text/javascript”>

var conversion_value = Order[2];

var order_id = Order[0];

adroll_conversion_value_in_dollars = conversion_value;

adroll_custom_data = {‘ORDER_ID’ : order_id}

</script>

3. Save.

The post Volusion Parameter Passing appeared first on AdRoll Support.


3D Cart Parameter Passing

$
0
0

To set up Parameter Passing in 3D Cart:

  1. Login to your Store Manager
  2. Go to Settings >> Design >> Titles & Content
  3. Look for “Checkout 4” and click the Edit button
  4. Add Script to the footer seciont.
  5. Save Changes.

3dcart1

Script: 

<script type=”text/javascript”>

adroll_conversion_value_in_dollars = [cost];

adroll_custom_data = {“ORDER_ID” : “[invoice-number]“}

</script>

The post 3D Cart Parameter Passing appeared first on AdRoll Support.

Yahoo! Customer Parameter Passing

$
0
0

Assuming that the pixel is already placed, just follow these short steps: 

  1. Navigate to the “Store Manager”
  2. Click “Checkout & Registration Manager”
  3. Click “Checkout Wrapper”
  4. Insert Pixel and parameter passing instructions into Footer
  5. Click “Save”
  6. And finally, publish Order Settings

Script:

<script type=”text/javascript”>

adroll_conversion_value_in_dollars = orderTotal;

adroll_custom_segments = {“ORDER ID” : “ids[0]”};

</script>

The post Yahoo! Customer Parameter Passing appeared first on AdRoll Support.

Enhanced Conversion Tracking

$
0
0

Instructions to pass additional data during a conversion

AdRoll’s SmartPixel and dashboard provide an easy way to setup and track conversions based upon success URLs.  For example, any time a visitor requests the page: http://www.example.com/thankyou a conversion event could be triggered and attributed to your advertising.

You can pass additional data about conversions by adding additional javascript code to your success pages.

How to Pass Revenue Value of Conversions

Because revenue is the most commonly used attribute that can be passed with conversions, AdRoll has implemented a specific conversion variable for order values that is recognized by the AdRoll SmartPixel.  When a value is assigned to this variable, it will show up in your AdRoll dashboard.

ECT 1

On the success page, add a javascript variable named adroll_conversion_value_in_dollars  and assign the variable that represents the revenue value for the conversion. This revenue variable used is unique to each website and ecommerce platform, so make sure to refer to the proper documentation for your respective platform.

adroll_conversion_value_in_dollars = 49.95;

Complete Example

<html>
<head><title>Thank you for your purchase</title></head>
<body>

<script type="text/javascript">
  adroll_conversion_value_in_dollars = 49.95;

  adroll_adv_id = "XXXXXXXXXXXXXXXXXXXXXX";
  adroll_pix_id = "XXXXXXXXXXXXXXXXXXXXXX";
  (function () {
    var oldonload = window.onload;
    window.onload = function () {
      __adroll_loaded = true;
      var scr = document.createElement("script");
      var host = (("https:" == document.location.protocol) ? "https://s.adroll.com" : "http://a.adroll.com");
      scr.setAttribute('async', 'true');
      scr.type = "text/javascript";
      scr.src = host + "/j/roundtrip.js";
      ((document.getElementsByTagName('head') || [null])[0] || document.getElementsByTagName('script')[0].parentNode).appendChild(scr);
      if (oldonload) {
        oldonload()
      }
    };
  }());
</script>
</body>
</html>

How to Pass Additional Custom Values

Any additional attributes about conversions can also be passed to AdRoll, and these values can then be accessed via a granular report provided by your AdRoll account manager.

Additional variables are passed by setting a javascript object with the name adroll_custom_data which encapsulates custom variables and values.

Below is an example of passing values for Order ID, and User ID.

adroll_custom_data = {"ORDER_ID": "12345", "USER_ID": "98765"};

Complete Example

<html>
<head><title>Thank you for your purchase</title></head>
<body>

<script type="text/javascript">
  adroll_custom_data = {"ORDER_ID": "12345", "USER_ID": "98765"};

  adroll_adv_id = "XXXXXXXXXXXXXXXXXXXXXX";
  adroll_pix_id = "XXXXXXXXXXXXXXXXXXXXXX";
  (function () {
    var oldonload = window.onload;
    window.onload = function () {
      __adroll_loaded = true;
      var scr = document.createElement("script");
      var host = (("https:" == document.location.protocol) ? "https://s.adroll.com" : "http://a.adroll.com");
      scr.setAttribute('async', 'true');
      scr.type = "text/javascript";
      scr.src = host + "/j/roundtrip.js";
      ((document.getElementsByTagName('head') || [null])[0] || document.getElementsByTagName('script')[0].parentNode).appendChild(scr);
      if (oldonload) {
        oldonload()
      }
    };
  }());
</script>
</body>
</html>

Passing Order Value and Custom Values Together

If you’d like to pass AdRoll both types of data, you can set both variables for revenue and custom values at the same time. Simply set adroll_conversion_value_in_dollars and adroll_custom_data variables consecutively in javascript.

<script type="text/javascript">
  adroll_conversion_value_in_dollars = 49.95;
  adroll_custom_data = {"ORDER_ID": "12345", "USER_ID":"98765"}
</script>

The post Enhanced Conversion Tracking appeared first on AdRoll Support.

Viewing all 11 articles
Browse latest View live