Northbeam DashboardQuestions? Reach out to our team!
Technical Guides

Tracking for TradeDesk

This guide will show you how to connect your TradeDesk account and pull the following metrics:

  • Spend and Impressions enabling click-based tracking and attribution.

Setting up TradeDesk within Northbeam involves four steps:

Step 1: Getting Ready

Step 2: Inserting Click and Impressions UTMs

Step 3: Creating a Scheduled Report

Step 4: Notify our Support Team

Step 1: Getting Ready

Before starting, it's important to have the following information ready for fastest and easiest integration setup.

  • Your Northbeam Client ID
  • Your Website
  • Your Collector Subdomain
  • Email Address (for Reports)

Northbeam Client ID

Your Northbeam Client ID is a unique string of letters and numbers that represent your Northbeam dashboard.

To find your ID, log into your dashboard and find it in your URL.

Example in bold: dashboard.northbeam.io/87aaeb29-3b46-4ddf-b824-11e6e3b9d3a7

Your Website

This is your Website URL connected to your Northbeam Dashboard.

To find it, log into your Northbeam Dashboard:

  1. Navigate to Settings
  2. Find it in Profile, under Domain Name

Example: northbeam.io

Your Collector Subdomain

This is the hostname of the A-Record that was set up during onboarding.

To find it, log into your Northbeam dashboard:

  1. Navigate to Settings
  2. Click on Setup DNS Entry
  3. Find the subdomain listed (ex. i, i2, i3, or i4.)

Example: i

Email Address for Reports

This is the email address that you'll be sending scheduled reports to. We use this data to plug into our model and attribute TradeDesk performance.

Use the following email: [northbeam-client-id][email protected]

Example:

Client ID: 925161f8-ecc3-4457-8c3e-b75fe5dbf0ac

Email Address: 925161f8-ecc3-4457-8c3e-b75fe5dbf0aczzznbzzztradedesk@robot.northbeam.io

Step 2: Inserting Click and Impressions UTMs

Step-by-Step Guide

Click UTMs

We'll need the following UTMs on your Click Thru URLs:

nb_platform=tradedesk&nb_campaignid=%%TTD_CAMPAIGNID%%&nb_adsetid=%%TTD_ADGROUPID%%&nb_creativeid=%%TTD_CREATIVEID%%&nb_devicefamily=%%TTD_DEVICEOSFAMILY%%&nb_devicetype=%%TTD_DEVICETYPE%%&nbt_site=%%TTD_SITE%%&nbt_vendor=%%TTD_SUPPLYVENDOR_INT%%

Example Click UTM

https://[YOUR_WEBSITE]?nb_platform=tradedesk&nb_campaignid=%%TTD_CAMPAIGNID%%&nb_adsetid=%%TTD_ADGROUPID%%&nb_creativeid=%%TTD_CREATIVEID%%&nb_devicefamily=%%TTD_DEVICEOSFAMILY%%&nb_devicetype=%%TTD_DEVICETYPE%%&nbt_site=%%TTD_SITE%%&nbt_vendor=%%TTD_SUPPLYVENDOR_INT%%

Please Note

It’s important to ensure your UTM begins with “&” or “?”.

If you are using existing parameters, please use “&”:
Ex) northbeam.io?utm_source=tradedesk&nb_platform=tradedesk…

If you are not using existing parameters, please use “?”:
Ex) northbeam.io?nb_platform=tradedesk…

Impression UTMs

Impression UTMs need to be populated with your Subdomain, Website, and Client ID.

We'll need the following UTMs on your Pixel Impression Tracking URLs:

https://<COLLECTOR_SUBDOMAIN>.<CLIENT_WEBSITE>/i?aid=<CLIENT_ID>&e=se&se_ca=northbeam&se_ac=impression&se_la=tradedesk&se_pr=%%TTD_CAMPAIGNID%%%7C%3A%7C%%TTD_ADGROUPID%%%7C%3A%7C%%TTD_CREATIVEID%%%7C%3A%7C%%TTD_DEVICEOSFAMILY%%%7C%3A%7C%%TTD_DEVICETYPE%%%7C%3A%7C%%TTD_SITE%%%7C%3A%7C%%TTD_SUPPLYVENDOR_INT%%

Example Impression UTM

https://i.northbeam.io/i?aid=925160f8-ecc3-4457-8c3e-b75fe5dbf0ac&e=se&se_ca=northbeam&se_ac=impression&se_la=tradedesk&se_pr=%%TTD_CAMPAIGNID%%%7C%3A%7C%%TTD_ADGROUPID%%%7C%3A%7C%%TTD_CREATIVEID%%%7C%3A%7C%%TTD_DEVICEOSFAMILY%%%7C%3A%7C%%TTD_DEVICETYPE%%%7C%3A%7C%%TTD_SITE%%%7C%3A%7C%%TTD_SUPPLYVENDOR_INT%%

For a step-by-step guide on inserting our UTMs, reference the video above.

Step 3: Creating a Scheduled Report

Step-by-Step Guide

Metrics need to be sent daily to our robot email address. In order to send us the data, please create a scheduled CSV.

  • Create a TSV/CSV report
  • Template Name: northbeam_scheduled_report
  • Type: Performance (100 days, All Metrics)

Add the following fields, metrics, and conversions:

Add Fields:

Date
Ad Group
Ad Group ID
Campaign
Campaign ID
Creative
Creative ID
Advertiser Currency Code
Media Type

Add Metrics: 

Clicks
Impressions
Advertiser Cost (Adv Currency)
Advertiser Cost (USD)

Add Report Column:
01

Add Conversions:

Click Conversion
Click Conversion Revenue
View Through Conversion
View Through Conversion Revenue

Please configure additional fields:

  • Filter by Partner or Advertiser > select your brand name
  • Date Range: Last 30 Days
  • Date Format: Sortable
  • Numeric Format: US
  • Time Zone: UTC
  • File Format: CSV
  • Include Headers
  • Email this report to: [your_client_id][email protected]
  • Recurring Scheduling > Schedule for recurring > Daily

Hit Save and Run, and that’s it!

Step 4: Notify Our Support Team

Once the UTMs are inserted and scheduled reports are created, please reach out to our team here.

We'll enable the TradeDesk integration in your dashboard. Once enabled, we'll start reporting Spend and impression data, as well as Clicks + Views performance in the following data refresh.


📘

TradeDesk View-Based Modeling Update

Supported Channels

Our current TradeDesk supports the following channels on a click-basis:

  • Display
  • Video
  • Native Display
  • Native Video

Supported Attribution Models

For these click-based channels, the following attribution models are supported:

  • First Touch
  • Last Time
  • Last Non-Direct Touch
  • Linear
  • Clicks-Only

Channels with limited attribution

The following channels generally don't lead directly to website clicks and will see minimal tracking and performance data:

  • TV
  • Digital Out Of Home
  • Audio

Unsupported Attribution Models

The above placements are not supported by our view-based attribution models including:

  • Clicks + Views
  • Clicks + Views enhanced

Scheduled reports (Step 3) will continue to function as normal, so you can expect to see spend data pulling in as usual.

Updated about 2 months ago