> ## Documentation Index
> Fetch the complete documentation index at: https://data-foundation.rockerbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Outbrain

> Learn how to set up Outbrain integration with Rockerbox for native display tracking

## Setup Process

1. Contact [support@rockerbox.com](mailto:support@rockerbox.com) to enable the integration. Let the team know the launch date and the [tier structure](https://help.rockerbox.com/article/obce43haen-1-hierarchy-mappings) you'd like applied
2. 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
3. Authenticate your Outbrain account in Rockerbox to enable API spend ingestion (see API Spend section below)
4. 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:**

```text wrap theme={null}
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}}
```

<Accordion title="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                                                      |
</Accordion>

### Impression Pixel

```text wrap theme={null}
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](https://app.rockerbox.com/v3/settings/account).

<Accordion title="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                  |
</Accordion>

## 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](https://lp.outbrain.com/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:

1. Log in to [my.outbrain.com](https://my.outbrain.com)
2. 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

1. Go to the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page in Rockerbox
2. Select Outbrain from the list and click "Connect"
3. Enter your Marketer ID when prompted
4. Complete the authentication process

## Verification

After setup:

1. Verify impression pixels are firing correctly
2. Validate click tracking parameters are populating
3. Confirm spend data appears in Rockerbox within 24-48 hours
4. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance