Skip to main content

Taboola Integration for Nodus

1. Introduction to the Taboola Integration​

What Is This Integration?​

The Taboola integration connects your Taboola advertising platform data with Nodus, allowing you to extract, analyze, and transform campaign performance metrics, content insights, and site-level performance data. This integration functions as a source connector, bringing your Taboola data into the Nodus ecosystem for advanced analytics and business intelligence.

Prerequisites:​

  • An active Taboola Ads account with appropriate access permissions
  • Taboola Account ID for the accounts you want to connect
  • Client ID and Client Secret (OAuth 2.0 Client Credentials)
  • Read permissions for the Taboola Backstage API

Connection Overview:​

The integration uses Taboola's Backstage API to extract advertising data and performance metrics. Authentication is handled through OAuth 2.0 Client Credentials (client_id/client_secret), and the connector extracts data based on predefined templates that specify which datasets to retrieve.

2. Platform Setup Documentation (Setup Form for Taboola)​

Purpose & Scope​

This section covers how to set up the initial connection between Nodus and Taboola by providing the necessary authentication credentials and account details.

Field-by-Field Breakdown:​

Integration Name​

  • Field Name & Label: Integration Name
  • Description & Purpose: A descriptive name to identify this Taboola integration within your Nodus account.
  • Validation Rules & Format: Text string, required field.
  • Examples: "Taboola - Main Account", "Taboola Marketing - Brand X"
  • Troubleshooting Tips: Use a descriptive name that clearly identifies the specific Taboola account or purpose.

Taboola Account ID​

  • Field Name & Label: Taboola Account ID
  • Description & Purpose: The unique identifier for your Taboola account, used to access campaign data.
  • Validation Rules & Format: Text string, required field.
  • Examples: "brand-network-123456"
  • Troubleshooting Tips: You can find your Account ID in the Taboola Backstage dashboard. Navigate to your account settings or check the URL when viewing your campaigns.

Client ID​

  • Field Name & Label: Client ID
  • Description & Purpose: The client ID for your Taboola OAuth 2.0 Client Credentials.
  • Validation Rules & Format: Text string, required field.
  • Examples: "your_client_id_here"
  • Troubleshooting Tips: You can find your Client ID in the Taboola Developer Portal.

Client Secret​

  • Field Name & Label: Client Secret
  • Description & Purpose: The client secret for your Taboola OAuth 2.0 Client Credentials.
  • Validation Rules & Format: Text string, required field.
  • Examples: "your_client_secret_here"
  • Troubleshooting Tips: You can find your Client Secret in the Taboola Developer Portal.
  • Link Label: "Access Taboola Backstage"
  • URL: https://backstage.taboola.com/
  • Purpose: Direct link to Taboola Backstage for account management and ID verification.

Step-by-Step Guide:​

  1. Log in to Taboola Backstage
  2. Navigate to Account Settings to locate your Account ID
  3. Enter your Integration Name, Account ID, Client ID, and Client Secret in the Nodus setup form
  4. Click Save/Authorize; Nodus will use OAuth 2.0 Client Credentials to obtain an access token
  5. No interactive consent is required; access is granted via your client credentials
  6. Verify connection and save the configuration

3. Extraction/Query Configuration (Extraction Form for Taboola)​

Purpose & Overview​

This section explains how to configure data extraction from Taboola. The platform offers various templates for extracting different types of advertising data and analytics.

Template & Field Documentation:​

Template Selection​

  • Field Name & Label: Select a template
  • Description & Purpose: Defines which type of Taboola data to extract
  • Validation Rules & Format: Dropdown selection, required field
  • Available Options:
    • Campaign Performance - Performance metrics for campaigns including impressions, clicks, and conversions
    • Campaign Dimensions - Campaign configuration and metadata
    • Campaign Site Performance - Performance metrics broken down by site/placement
    • Content Performance - Individual content item performance metrics
    • Account Performance - Account-level aggregated performance metrics

Lookback Range​

  • Field Name & Label: Lookback Range
  • Description & Purpose: Specifies how many days back to extract data
  • Validation Rules & Format: Dropdown selection, required field
  • Available Options:
    • 7-day Range
    • 14-day Range
    • 30-day Range (recommended)
    • 90-day Range
  • Troubleshooting Tips: Select a longer range for historical analysis or a shorter range for recent performance data. The recommended 30-day range provides a good balance of data completeness and recency. Note: Lookback range only applies to performance templates, not dimension templates.

Historic Date Selection​

  • Field Name & Label: Historic Date
  • Description & Purpose: For historical data extraction, specifies a custom date range
  • Validation Rules & Format: Date picker, required field
  • Troubleshooting Tips: Taboola maintains historical data, but some metrics may only be available for limited time periods.

Workflow & Examples:​

  1. Select the appropriate template (e.g., "Campaign Performance" for performance metrics)
  2. Choose a lookback period or specific historic date range
  3. Preview the query to confirm configuration
  4. Execute extraction

Example Use Cases:​

Campaign Performance Analysis:

  • Template: Campaign Performance
  • Metrics: Impressions, clicks, spend, conversions, CTR, CPC
  • Lookback: 30-day Range

Content Performance Analysis:

  • Template: Content Performance
  • Metrics: Content-level impressions, clicks, engagement metrics
  • Lookback: 30-day Range

Site-Level Analysis:

  • Template: Campaign Site Performance
  • Data: Performance metrics broken down by publisher site
  • Lookback: 14-day Range

Account Overview:

  • Template: Account Performance
  • Data: High-level account metrics and KPIs
  • Lookback: 90-day Range

4. Data Schema & Templates​

Available Templates:​

1. Campaign Performance

  • Time-series performance data at the campaign level
  • Includes: impressions, clicks, spend, conversions, CTR, CPC, CPA
  • Supports date range selection

2. Campaign Dimensions

  • Static campaign configuration data
  • Includes: campaign names, IDs, status, targeting settings
  • Does not use date range (dimension template)

3. Campaign Site Performance

  • Performance metrics broken down by publisher site/placement
  • Includes: site-specific impressions, clicks, conversions
  • Supports date range selection

4. Content Performance

  • Individual content/creative performance metrics
  • Includes: content IDs, titles, thumbnails, performance metrics
  • Supports date range selection

5. Account Performance

  • Aggregated account-level performance data
  • Includes: total spend, impressions, clicks, conversions
  • Supports date range selection

Data Refresh & Best Practices:​

  • Performance data is typically available with a 24-48 hour delay
  • Dimension data reflects current state and updates in real-time
  • For attribution analysis, allow 7+ days for conversion data to stabilize
  • Schedule regular extractions to maintain data freshness

5. Troubleshooting & FAQs​

Common Issues:​

Authentication Failures:

  • Ensure your Taboola account has API access enabled
  • Verify the Account ID is correct
  • Re-authorize if token has expired

Missing Data:

  • Check date range selection
  • Verify campaign is active during selected period
  • Allow for data processing delays

Template Selection:

  • Use dimension templates for static data
  • Use performance templates for time-series metrics
  • Combine multiple templates for comprehensive analysis

Support Resources:​