Ask or enter a search term here

    How do I add UTM tracking to my campaign?

    What is UTM tracking?

    UTM tracking is one of the most important aspects of a successful campaign because it allows you to precisely review your performance and optimize accordingly.

    Begin building your UTM string here.

    Our recommended tracking code is:


    Replace “your-campaign-name” with the name of your campaign.

    Your UTM tracking code can be changed at any time during campaign creation or after submitting it. Locate the campaign and click the pencil icon to open the campaign’s settings. You may adjust or add a new UTM code in the “Tracking” section.

    Save your modification by clicking on the “Save Changes” button at the bottom of the screen. Your tracking code will automatically append to all headlines within the campaign.

    Recommended UTM Parameters

    This reflects engagement data per traffic source. Outbrain is sending you visits, so the source can be listed as “Outbrain.” The utm_source parameter is a required parameter for UTM tracking.

    This reflects engagement data per advertising medium. Outbrain is a content discovery network, so the medium can be listed as “Discovery.”

    This reflects engagement data per campaign. You’ll be able to drill down on the performance by campaign to understand their unique engagement levels. Be sure to change ‘your-campaign’ to the actual name of the campaign you are tracking.

    Recommended Dynamic UTM Parameters

    This reflects engagement data per the specific headlines in your campaign. You’ll be able to view which headlines are driving the most engaged audiences to make appropriate optimization decisions.

    These reflect engagement data per publisher source. You’ll be able to view which publishing sections are sending the most engaged traffic and optimize your campaigns with these insights in mind.

    UTM Best Practices

    • The suffix should not contain ?, @, or multiple #
    • When using two dynamic parameters together, always use separators. Example:  {{publisher_name}}_{{section_name}}
    • When you submit a URL as content, do NOT add the UTM parameters there. Instead, always add any UTM parameters to the Tracking section.
    • Avoid adding a backslash (/) at the end of your submitted URL. Backslashes can cause reporting issues when used with UTM parameters.
    • Always make sure you’re using utm_source=outbrain in your tracking code.

    Complete List of Outbrain Parameters for All Tracking:

    Macro Prefix/Suffix/UTM Click Pixel Impression Pixel Definition
    doc_title x x Document title
    doc_author x Document author
    doc_id x x x Document ID
    ad_title x x Ad title
    publish_date x Publish date
    req_id x x x Required ID
    promoted_link_id x x x External source ID
    time_stamp x x x Timestamp
    campaign_id x x x Campaign ID
    section_id x x x Referrer section ID
    section_name x x x Referrer section name
    publisher_id x x Referrer publisher ID
    publisher_name x x x Referrer publisher name
    ob_click_id x Server-to-server multiple conversion ID
    android_id x Android unique device ID
    idfa x iOS unique device ID
    campaign_name x Campaign name
    gdpr x x x Value of 0 or 1 depending on whether GDPR applies for the click or impression.
    0= GDPR does not apply
    1= GDPR applies
    gdpr_consent x x x An encoded value that includes the consented-to purposes and the vendor consent string.
    gdpr_consent_[IAB GVL ID] x x x An encoded value that includes the consented-to purposes and the vendor consent string.
    gdpr_pd x x x URL parameter that indicates that the URL contains personal data.
    0 = No personal data
    1 = Personal data is passed
    The default value of 1 is always passed for OB imps or clicks.
    aid x x Advertiser ID


    Feel free to reach out to our DIY Customer Success team if you want to learn more about this.

    Need Further Help?

    Speak to an Outbrain expert

    Contact Us