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

# Taboola Ads

> An introduction to the Taboola Ads marketing source

export const Icon = ({name}) => {
  return <div className="h-4 w-4 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle">
            <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/${name}.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
        </div>;
};

<Note> The Taboola marketing source allows you to see platform-specific metrics (e.g. Ad Spend) in Converge.
To send data from Converge to Taboola, check out the [Taboola Ads Destination](/destinations/integrations/taboola) instead.</Note>

## Set up the Marketing source

1. Navigate to the [Marketing Sources Tab](https://app.runconverge.com/-/ad-platforms) in your Converge dashboard.

2. Click on **Connect a new ad platform** and name your ad platform sync: e.g `Taboola | {Taboola Ads Account ID}`.

3. Select **Taboola** from the drop-down list and sign in with your Taboola Account.

4. Once the Taboola account has been linked, you can **select your Taboola Ads Account**.

5. After pressing **Create** your Taboola Ads metrics will stream into Converge.

***

## Converge functionality

This integration supports the following Converge marketing source functionality.

| Converge Feature                                                                                                                                                                                             | Supported             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------- |
| Sync Frequency                                                                                                                                                                                               | Every hour            |
| <Tooltip tip="Whether spend is available on a per-hour basis. When unsupported, Converge pulls in the daily spend and uniformly distributes it over the hours of the day.">Hourly Spend Breakdowns</Tooltip> | <Icon name="xmark" /> |
| Custom Conversions                                                                                                                                                                                           | <Icon name="xmark" /> |

***

## Set up your Converge tracking parameters

<Note> If you have already set up the [Taboola Destination](/destinations/integrations/taboola) in Converge, then you might already have the tracking parameters set up correctly. </Note>

1. Open the Taboola Ads Manager and navigate to **Campaigns**.

2. Click on the <Icon name="pencil" />-icon next to the campaign for which you want to modify the tracking parameters to open the campaign settings.

3. Add the following in the **Tracking** section:

```
utm_source=taboola&utm_medium=paid&utm_campaign={campaign_name}&tblcid={click_id}&cvg_source=taboola&cvg_adid={campaign_item_id}&cvg_cid={campaign_id}
```

4. Click **Submit** to save your changes.

<Warning> You will need to change the URL of **all** of your campaigns following steps 1-4 above. **You should add these parameters for every new campaign as well**.  </Warning>

***

## Supported metrics

We support a variety of metrics to help you analyze your ad performance on Taboola Ads. Click on each category to expand and see the specific metrics available.

<AccordionGroup>
  <Accordion icon="chart-column" title="Overview Report">
    The Attribution Overview Report provides a high-level snapshot of your ad performance, including efficiency and engagement metrics.

    | Metric          | Description                                                                           |
    | --------------- | ------------------------------------------------------------------------------------- |
    | **Ad Spend**    | The total amount of money spent on your Taboola ads.                                  |
    | **ROAS**        | The attributed revenue generated for every unit of currency spent on Taboola ads.     |
    | **CTR**         | The average percentage of people who clicked on your Taboola ad after seeing it.      |
    | **CPA**         | The average cost associated with actions from your Taboola ads.                       |
    | **CPC**         | The average cost per click on your Taboola ads.                                       |
    | **CPM**         | The average cost per thousand impressions of your Taboola ads.                        |
    | **Conversions** | The number of Taboola-attributed purchases that happened because of your Taboola ads. |
    | **Clicks**      | The total number of clicks on your Taboola ads.                                       |
    | **Impressions** | The number of times your Taboola ads were on-screen.                                  |
  </Accordion>

  <Accordion icon="network-wired" title="Channels Report">
    The Channels Report tab provides a detailed comparison of performance metrics across advertising channels, campaigns, ad sets, and ads, helping you understand the most effective elements.

    | Metric        | Description                                                            |
    | ------------- | ---------------------------------------------------------------------- |
    | **Purchases** | The total number of purchases as attributed by Taboola to Taboola ads. |
    | **Revenue**   | The total revenue generated as attributed by Taboola to Taboola ads.   |
    | **ROAS**      | The return on ad spend as attributed by Taboola to Taboola ads.        |
    | **CPA**       | The cost of acquiring a conversion as attributed by Taboola.           |
    | **Ad Spend**  | The total expenditure on Taboola Advertising.                          |
  </Accordion>
</AccordionGroup>
