Skip to content

Tealium: Set up Parse.ly tracking

  1. In your Tealium dashboard, go to the “Tags” section.
  2. In the “Manage Your Tags” section of the dashboard, click the “Add” button to add a new tag.
  3. In the “Tag Marketplace” dialogue that appears, input “Parse.ly” in the status bar. When the Parse.ly tag appears, click the “Add” button next to it to add the tag to your Tealium tag collection.
  4. In the “Tag Configuration” page, you will want to select the “Dom-Free” option in the “Tag Version” selection dropdown- in most cases, the rest of the options can be left to their default values. For more information on the other configuration options, please see below in the “Tag Configuration” section.
  5. In the “Load Rules” section, make sure that “Load on all pages” is checked. We highly recommend that you load the Parse.ly tag on every page in your site, but if you wish to create custom rules as to when the tag loads you may do so here according to Tealium’s normal tag rules.
  6. The “Data Mapping” tab can normally be left blank. If, however, your Parse.ly Site ID is different from the domain you are installing the tag on, you may map the Parse.ly Site ID here to another domain on the page.
  7. Click finish, and your Tealium tag manager is now loading the Parse.ly Javascript on your site.

Note that you cannot use Tealium to implement your Parse.ly metadata; that must be done by your dev team. Tealium simply injects the basic tracker code. The documentation for implementing Parse.ly metadata is here.

Advanced Options

Tag Version

This should always be DOM-Free- the standard version is used only in very rare cases, and you will be instructed by Parse.ly support if this is the case.

Publish Locations

These are the locations you want to publish the tag to, if applicable. These should be any location or deployment environment that you want the Parse.ly tag to appear in.

Advanced Settings

These are the standard advanced settings, and in most cases all of these need to be set to their default values. For more information on what these advanced settings do, please visit the Tealium documentation.

Dynamic Tracking

Parse.ly’s default Tealium integration does not include dynamic tracking, since these functionalities can vary highly between publishers and websites. However, you can use the event tracking you already have set up within Tealium to instrument Parse.ly’s Dynamic Tracking on your site.

In general, for each dynamic event (for example, clicking “next” on a slideshow, or any infinite scroll article views) you’ll want to call PARSELY.beacon.trackPageView with updated information as specified in our Dynamic Tracking integration setup. The only difference when integrating with Tealium is using their event tracking system, instead of manually adding these events to your page.

For now, please contact your Tealium Account Manager, who can help you modify your Parse.ly template to take advantage of dynamic tracking.

Data Mapping

For the most part, the Parse.ly Tealium tag is smart enough to figure out your Site ID based on the URL of your site. However, there are certain cases where the Site ID does not match the domain of the the site you’re installing the tag on- in these cases, you’ll have to manually specify the Site ID. To do so, follow these steps:

  1. declare a variable on your page inside a script tag with the site ID: var site_id = “example.com”;
  2. In the Tealium Data Mapping section of your Parse.ly tag, click “Define and Map New Data Source”.
  3. In the “Source” box, type the name of the variable you created. Select “JavaScript Variable”in the dropdown, and hit “apply”.
  4. In the mappings column, select your new variable, and in the text box to its right type in “site_id”. Click “Apply”, and your tealium tag will now have the correct Site ID (apikey).

Last updated: August 16, 2023