Outbrain

Setup Process

Contact support@rockerbox.com to enable the integration. Let the team know the launch date and the tier structure you’d like applied
Append click-through URL parameters to your landing page URLs and apply the impression pixel to all active ads using the instructions below. Parameters use macros and do not need to be manually replaced
Authenticate your Outbrain account in Rockerbox to enable API spend ingestion (see API Spend section below)
Allow at least one full day of data collection after launch, then let Rockerbox know you have launched so they can QA your URL and impression pixels

URL Tracking Parameters

In the Outbrain platform, open the campaign editor and append the parameters below in the Tracking section’s Suffix box. Example Parameter String:

o_campaign=[YOUR_CAMPAIGN_NAME]&o_campaignid={{campaign_id}}&o_ad={{ad_title}}&o_adid={{ad_id}}&o_doc={{doc_title}}&o_docid={{doc_id}}&o_docauthor={{doc_author}}&o_publishdate={{publish_date}}&o_requestid={{req_id}}&o_sourceid={{source_id}}&o_linkid={{promoted_link_id}}&o_section={{section_name}}&o_sectionid={{section_id}}&o_publisher={{publisher_name}}&o_publisherid={{publisher_id}}&o_userid={{uuid}}&o_clickid={{ob_click_id}}&o_androidid={{android_id}}&o_iosid={{idfa}}

Parameter Details

Parameter	Macro	Description
`o_campaign`	`[YOUR_CAMPAIGN_NAME]`	Campaign Name (manual entry, replace spaces with underscores)
`o_campaignid`	`{{campaign_id}}`	Campaign ID (required)
`o_ad`	`{{ad_title}}`	Ad Title
`o_adid`	`{{ad_id}}`	Ad ID
`o_doc`	`{{doc_title}}`	Document Title
`o_docid`	`{{doc_id}}`	Document ID
`o_docauthor`	`{{doc_author}}`	Document Author
`o_publishdate`	`{{publish_date}}`	Publish Date
`o_requestid`	`{{req_id}}`	Request ID
`o_sourceid`	`{{source_id}}`	Source ID
`o_linkid`	`{{promoted_link_id}}`	Promoted Link ID
`o_section`	`{{section_name}}`	Section Name
`o_sectionid`	`{{section_id}}`	Section ID
`o_publisher`	`{{publisher_name}}`	Publisher Name
`o_publisherid`	`{{publisher_id}}`	Publisher ID
`o_userid`	`{{uuid}}`	User ID
`o_clickid`	`{{ob_click_id}}`	Outbrain Click ID
`o_androidid`	`{{android_id}}`	Android ID
`o_iosid`	`{{idfa}}`	iOS IDFA

Impression Pixel

https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=outbrain&tier_two={{campaign_id}}&tier_three={{ad_id}}&tier_four={{publisher_id}}&tier_five={{section_id}}&auction_id={{ob_click_id}}&referrer={{publisher_name}}

Note: [SOURCE] is a hardcoded value that must be obtained from Rockerbox. It’s your company’s Account ID.

Parameter Details

Parameter	Macro	Description
`tier_one`	`outbrain`	Platform identifier (hardcoded)
`tier_two`	`{{campaign_id}}`	Campaign ID (required)
`tier_three`	`{{ad_id}}`	Ad ID
`tier_four`	`{{publisher_id}}`	Publisher ID
`tier_five`	`{{section_id}}`	Section ID
`auction_id`	`{{ob_click_id}}`	Outbrain Click ID
`referrer`	`{{publisher_name}}`	Publisher Name

API Spend

Rockerbox pulls spend data directly from Outbrain via API. You will need to authenticate your Outbrain account in the Rockerbox platform.

Requesting API Access

If your Outbrain account does not have API access, apply through Outbrain’s partner API form. For platform-specific questions, use the following answers:

Question	Answer
Do you operate your own proprietary technology?	No
Does your technology provide a self-serve interface?	No
Do you offer a SaaS or managed service product?	Other
Description for ‘Other’	We use the Rockerbox Attribution Platform and need API credentials
Anticipated API calls per day	Fewer than 10
Additional information	Rockerbox already has API spend ingestion for other Outbrain clients

Finding Your Marketer ID

Your Marketer ID is required to authenticate in Rockerbox:

Log in to my.outbrain.com
Your Marketer ID is the string of zeros in the dashboard URL that starts with “00”:

https://my.outbrain.com/amplify/site/marketers/0000000000000000000000000000000000/reports/campaigns

Connecting to Rockerbox

Go to the Advertising Platforms page in Rockerbox
Select Outbrain from the list and click “Connect”
Enter your Marketer ID when prompted
Complete the authentication process

Verification

After setup:

Verify impression pixels are firing correctly
Validate click tracking parameters are populating
Confirm spend data appears in Rockerbox within 24-48 hours
Contact support@rockerbox.com for QA assistance

Supported Vendors

Marketing

Setup Process

URL Tracking Parameters

Impression Pixel

API Spend

Requesting API Access

Finding Your Marketer ID

Connecting to Rockerbox

Verification

​Setup Process

​URL Tracking Parameters

​Impression Pixel

​API Spend

​Requesting API Access

​Finding Your Marketer ID

​Connecting to Rockerbox

​Verification

Setup Process

URL Tracking Parameters

Impression Pixel

API Spend

Requesting API Access

Finding Your Marketer ID

Connecting to Rockerbox

Verification