# Taboola Data Connector User Guide

> **Note:** Taboola is a powerful native advertising platform that helps marketers reach their target audience through sponsored content and product recommendations. This guide will walk you through the process of connecting your Taboola account to Power My Analytics, enabling you to automate your data collection and create insightful reports. By following these steps, you'll be able to streamline your reporting process and gain valuable insights into your Taboola campaigns.

## Prerequisites

Before you begin, make sure you have:

- Your Taboola account ID (found at the end of the URL in Taboola Backstage)
- Your Taboola account password

### Find Your Taboola Account ID

To find your account ID, go to Taboola Backstage and find the number at the end of the page URL, for example, [https://backstage.taboola.com/backstage/](https://backstage.taboola.com/backstage/)**123456**.

## Adding Taboola as a Data Source

1. Log in to your Power My Analytics hub.
2. Navigate to the **Sources** section in the main menu.
3. Click on **\+ New Data Source**.
4. Select Taboola from the list of available data sources.
5. Enter your Taboola account ID in the **Client ID** field.
6. Enter your Taboola account password in the **Client Secret** field.
7. Click **Connect** to establish the connection.

## Creating a Data Studio Report

Follow these steps to create a Data Studio report using your Taboola data:

1. After adding Taboola as a data source, go to **Reports > Data Studio** in your PMA hub
2. Select Taboola under Create Data Studio Report (this will open the official Data Studio application in a new window)
3. Google Data Studio Configuration:

    - Step 1:

        - Name your data source (e.g., "Taboola - Your Organization Name")
        - Choose your Power My Analytics hub from the dropdown menu
        - Optional: Leave "Use report template for new reports" checked to use the PMA demo template
        - Click **Next**

    - Step 2:

        - User Account: Select your Taboola account (for real data) or "Sample Account" (for sample data)
        - Click **Next**

    - Step 3:

        - Choose "Accounts" for reports
        - Optional: Allow "Accounts" modification in reports
        - Click **Connect** in the top right to complete the data source configuration

    - Step 4:

        - Click **Create Report** in the top right
        - Include "today" in your report's date range to begin historical data storage

For a quick start, use our pre-built [Taboola demo template](https://lookerstudio.google.com/reporting/6887acce-f08a-4d5b-b7df-08604821b425).

## Key Reports and Fields

Taboola data in Power My Analytics offers a wide range of metrics and dimensions for your reports. Some popular metrics include:

- Campaign Metrics: Spent, actual CPC, impressions, clicks, STR, click conv., conversion rate, conversions value - all, conversions and CPA by campaign
- Geo Metrics: Spent, impressions, clicks, CTR, conversions and CPA by country
- Sites Performance Metrics: Spent, actual CPC, impressions, clicks, CTR, click conversions and CPA by site name
- Platform Metrics: Spent, actual CPC, impressions, clicks, CTR, click conversions, click conversion rate and CPA by platform
- Campaign Top Content Metrics: Impressions, vCTR, clicks, CPC, vCPM, conv. rate, conv., CPA and spent by ID, image, top item, URL and campaign name

For a complete list of available Taboola fields, refer to the [Schema Explorer](https://hub.powermyanalytics.com/resources/schema/taboola).

## Limitations and Important Considerations

- **Cached Data Requests with Unique Metrics and Date Dimension:** When a unique metric is paired with the date dimension, this will result in a request for cached data instead of a request for live data. For more information, please see [Understanding Cached and Live Data Requests](https://knowledge.powermyanalytics.com/support/faq/understanding-cached-and-live-data-requests/#a-special-case-unique-metrics-paired-with-the-date-dimension).
- **Backfilling:** Power My Analytics can backfill up to 2 years of historical data from Taboola. When you first connect your Taboola account, an initial backfill of 13 months of data will be performed.
- **Reporting by country and date:** Country and date cannot be used as dimensions simultaneously.

### Unavailable Data

- Custom fields

## Troubleshooting

See our article [Basic Troubleshooting](https://knowledge.powermyanalytics.com/application/troubleshooting/basic-troubleshooting/) for information on issues that may affect the Taboola connector.
