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

export const OutboundLink = ({linkText, linkTarget}) => {
  return <a target="_blank" href={linkTarget}> {linkText} 
    <div className="inline h-3 w-3 fill-gray-500 dark:fill-gray-100 text-gray-500 dark:text-gray-300 ml-1 mr-1">
      <svg className="inline w-2.5 h-2.5 bg-gray-500 dark:bg-gray-300" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/up-right-from-square.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }}></svg> 
    </div>
    </a>;
};

export const IconText = ({name, text, iconSource = "mintlify", iconLocation = "before", iconType = "solid"}) => {
  const sourceUrl = iconSource === 'local' ? `url('/images/icons/${name}.svg')` : `url('https://mintlify.b-cdn.net/v6.5.1/${iconType}/${name}.svg')`;
  return <>
            <div className="inline-block pl-2">
                {iconLocation === 'before' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 " style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
                <span className="inline-block align-middle font-semibold fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 pl-1 pr-2">{text}</span>
                {iconLocation === 'after' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 pr-3" style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
            </div>
        </>;
};

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>;
};

## Overview

Destination Type: <IconText text="Server-side" name="server" iconType="duotone" iconLocation="after" />

***

## Installation instructions

1. Navigate to your <OutboundLink linkTarget="https://ads.taboola.com/" linkText="Taboola Ads Manager" /> and choose **Tracking** from the top-bar.
   <Frame>
     <img src="https://mintcdn.com/converge/crQaBntMCFTIm3T-/images/destinations/taboola/taboola-1.png?fit=max&auto=format&n=crQaBntMCFTIm3T-&q=85&s=1ed0d323db23dcbfc7080ac4a74111b7" alt="taboola-sidebar" width="418" height="75" data-path="images/destinations/taboola/taboola-1.png" />
   </Frame>

2. Click on **New Conversion** in the top right corner.

3. Choose a name for your conversion and choose **Event** as the Conversion Type.
   <Frame>
     <img src="https://mintcdn.com/converge/crQaBntMCFTIm3T-/images/destinations/taboola/taboola-2.png?fit=max&auto=format&n=crQaBntMCFTIm3T-&q=85&s=007f69651f42304d12477fe0f95a95aa" alt="taboola-conversion-type" width="652" height="382" data-path="images/destinations/taboola/taboola-2.png" />
   </Frame>

4. Scroll down, you can ignore the "Fixed Value"-field. Choose the Category that fits your event best, for a `Placed Order` event this would be **Make Purchase**.

5. Choose your Event Name, e.g. `converge_placed_order`.
   <Frame>
     <img src="https://mintcdn.com/converge/crQaBntMCFTIm3T-/images/destinations/taboola/taboola-3.png?fit=max&auto=format&n=crQaBntMCFTIm3T-&q=85&s=314c057b47bed097b6e0ecae407c4771" alt="taboola-event-name" width="652" height="447" data-path="images/destinations/taboola/taboola-3.png" />
   </Frame>

6. Keep all the other fields in default settings, and click on the **Create**-button at the bottom of the page.

7. In the Converge sidebar, click on <IconText name="arrow-right-from-line" text="Event streams" /> and then click **Create new Destination**.

8. Select the **Taboola** destination and click **Next**.

9. Give your destination a **name** (e.g. Taboola Destination) and click **Next**.

10. Click **Next** on the Configuration page. You don't have to enter anything.

11. Click on <IconText name="plus" text="Add new mapping" /> and select Placed Order as the source event.

12. In the Forward As value enter `converge_placed_order`.

13. Select **Server** as the Forwarding Mode and click **Next**.

14. Add other conversion events in Taboola following steps 2-6 above and map them in your destination by following steps 11-13. Then click **Next**.

<Frame>
  <img src="https://mintcdn.com/converge/crQaBntMCFTIm3T-/images/destinations/taboola/taboola-custom-mapping-example.png?fit=max&auto=format&n=crQaBntMCFTIm3T-&q=85&s=4094ae5ed1c889ead25bcc3049ca5b84" alt="taboola-4" width="1257" height="277" data-path="images/destinations/taboola/taboola-custom-mapping-example.png" />
</Frame>

15. Select the sources you want to forward events from, then click **Next**.

<Note>This is a server-side destination, meaning that only server-side sources can be used with this destination. You can still select client-side sources but the events will not be sent to Taboola.</Note>

16. Review any issues and click **Submit**.

17. Navigate to the Campaigns overview in Taboola.

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

19. 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}
```

20. Save your modification by clicking the Submit button.

***

## Converge functionality

This integration supports the following Converge destination functionality.

| Converge Feature                                     |       Supported       |
| ---------------------------------------------------- | :-------------------: |
| Custom Events                                        | <Icon name="xmark" /> |
| Filters                                              | <Icon name="check" /> |
| Server-side Conversions                              | <Icon name="xmark" /> |
| [Conversion amount](/destinations/conversion-amount) | <Icon name="check" /> |

***

## FAQ

<AccordionGroup>
  <Accordion title="Why do I need to change my tracking parameters for the Taboola Destination and in-platform attribution to work?">
    Taboola's in-platform attribution works based on Taboola Click IDs. If a purchase gets sent to Taboola without a Click ID, it won't get attributed.

    Unfortunately, Taboola doesn't add the Click ID automatically to the landing page URL (as opposed to other ad platforms such as Google Ads or Facebook Ads). You need to manually make sure that all links include a click ID by modifying the tracking parameters for **every** ad you run.
  </Accordion>
</AccordionGroup>

***

## Event mapping

Events are not automatically mapped, you need to configure the mapping of the [Converge event spec](/sources/converge-spec) to your Taboola conversions manually.
We recommend the following mapping to the Event Type:

| Converge Event Name                                             | Taboola Event Type           |
| --------------------------------------------------------------- | ---------------------------- |
| [Added To Cart](/sources/converge-spec#added-to-cart)           | `converge_add_to_cart`       |
| [Started Checkout](/sources/converge-spec#started-checkout)     | `converge_initiate_checkout` |
| [Added Payment Info](/sources/converge-spec#added-payment-info) | `converge_add_payment_info`  |
| [Placed Order](/sources/converge-spec#placed-order)             | `converge_placed_order`      |