​
Overview

Rockerbox offers a direct API integration with Taboola to automatically ingest your advertising spend data and track campaign performance.

​
Prerequisites

Before setting up the integration, you’ll need:
  • An active Taboola advertiser account
  • Client ID and Client Secret from your Taboola representative
  • Access to your Taboola campaign management interface

​
Getting API Credentials

  1. Contact your Taboola representative to request your API credentials
  2. You will need to obtain:
    • Client ID
    • Client Secret
These credentials are required to authenticate your Taboola account in Rockerbox.

​
URL Parameters

​
Parameter Configuration

  • Add Rockerbox tracking parameters to your campaign URLs
  • Parameters use macros that are dynamically filled by Taboola
  • Follow Taboola’s URL structure guidelines

​
Available Dynamic Macros

Taboola supports these dynamic macros:
  • {campaign_id} - Campaign ID
  • {campaign_name} - Campaign Name
  • {site_id} - Site ID
  • {site_name} - Site Name
  • {placement_id} - Placement ID
  • {publisher_id} - Publisher ID
  • {campaign_item_id} - Campaign Item ID

​
Implementation Steps

  1. Add parameters to all active campaigns
  2. Use Taboola’s dynamic macros
  3. Test parameter population
  4. Verify tracking implementation

​
Impression Tracking

  • Apply impression pixels to your ads
  • Ensure proper implementation across all campaigns
  • Test pixel firing and data collection

​
Setting Up the Integration

  1. Go to the Advertising Platforms page in your Rockerbox account
  2. Find and select Taboola from the list of available platforms
  3. Click “Connect” to start the authentication process
  4. Enter your Taboola Client ID and Client Secret when prompted
  5. Complete the authentication process

​
Post-Setup Steps

  1. Contact support@rockerbox.com with the following information:
    • Your channel name
    • Launch date
    • Desired tier structure for this marketing activity

​
Verification

After setting up the integration:
  1. Rockerbox will begin pulling your Taboola spend data automatically
  2. The data will be available in your Rockerbox reporting within 24-48 hours
  3. One day after launch, verify that tracking is properly applied to all your ads using the Digital Advertising page
  4. Check that URL parameters are properly configured on all campaigns

​
Multiple Accounts

If you have more than one Taboola account:
  1. Repeat the authentication process for each account
  2. Use the “Add Authorization” option for additional accounts
  3. Ensure each account has its own Client ID and Client Secret
  4. Configure URL parameters for each account separately

​
Best Practices

  1. Implementation
    • Follow URL structure guidelines
    • Test tracking parameters before launch
    • Verify impression pixel placement
    • Monitor tracking consistency
  2. Maintenance
    • Regularly audit tracking implementation
    • Check for missing parameters
    • Monitor spend data accuracy
    • Update tracking as needed

​
Troubleshooting

If you encounter any issues:
  • Verify that your Client ID and Client Secret are correct
  • Ensure your Taboola account has active campaigns with spend
  • Check that tracking parameters are properly applied to all ads
  • Confirm impression pixels are firing correctly
  • Contact Rockerbox support if you need additional assistance