> ## 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.

# Taboola

> Learn how to set up Taboola 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 Taboola 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 Taboola Campaign Management page, click the pencil icon for an existing campaign and append the parameters below in the Tracking Code box.

**Example Parameter String:**

```text wrap theme={null}
t_campaign={campaign_name}&t_campaignid={campaign_id}&t_campaignitemid={campaign_item_id}&t_site={site}&t_siteid={site_id}&t_thumbnail={thumbnail}&t_title={title}&t_platform={platform}
```

<Accordion title="Parameter Details">
  | Parameter          | Macro                | Description            |
  | ------------------ | -------------------- | ---------------------- |
  | `t_campaign`       | `{campaign_name}`    | Campaign Name          |
  | `t_campaignid`     | `{campaign_id}`      | Campaign ID (required) |
  | `t_campaignitemid` | `{campaign_item_id}` | Campaign Item ID       |
  | `t_site`           | `{site}`             | Site Name              |
  | `t_siteid`         | `{site_id}`          | Site ID                |
  | `t_thumbnail`      | `{thumbnail}`        | Thumbnail URL          |
  | `t_title`          | `{title}`            | Ad Title               |
  | `t_platform`       | `{platform}`         | Platform Type          |
</Accordion>

### Impression Pixel

To add the impression pixel in Taboola:

1. Open the Campaign Management page and click the pencil icon for an existing campaign
2. In the **Tracking > 3rd Party Tags** section, click "Add Tag"
3. Set Tag Type to **3rd Party Pixel** and Event Type to **Impressions**
4. Paste the pixel below into the Tag field

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=taboola&tier_two={campaign_id}&tier_three={campaign_item_id}&tier_four={site}&tier_five={platform}&auction_id={timestamp}&referrer={site_domain}
```

**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`   | `taboola`            | Platform identifier (hardcoded) |
  | `tier_two`   | `{campaign_id}`      | Campaign ID (required)          |
  | `tier_three` | `{campaign_item_id}` | Campaign Item ID                |
  | `tier_four`  | `{site}`             | Site Name                       |
  | `tier_five`  | `{platform}`         | Platform Type                   |
  | `auction_id` | `{timestamp}`        | Timestamp                       |
  | `referrer`   | `{site_domain}`      | Site Domain                     |
</Accordion>

For more information about adding Taboola tracking parameters, see [Taboola's documentation](https://help.taboola.com/hc/en-us/articles/115006030688-Creating-and-Adding-URL-Parameters-for-Tracking).

## API Spend

Rockerbox pulls spend data directly from Taboola via API. You will need a Client ID and Client Secret from your Taboola representative.

1. Contact your Taboola representative to request your **Client ID** and **Client Secret**
2. In Rockerbox, navigate to the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page
3. Select Taboola from the list and click "Connect"
4. Enter your Client ID and Client Secret when prompted
5. Complete the authentication process

If you manage multiple Taboola accounts, repeat the authentication process for each account using separate Client ID and Client Secret credentials.

## 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