# Onboarding

Taboola channels offer a straightforward setup process using Query Key and event mapping to link your Taboola account with EdgeTag seamlessly. This connection enables your site to stream conversion events to Taboola, providing accurate campaign attribution and optimization. Let's walk through the steps.

### Video Guide

{% embed url="<https://www.loom.com/share/fb37b4eafe3840839ea91f5b224854cf?sid=387d69ea-47c6-4da0-bd40-b72c920a4897>" %}

### Add Channel <a href="#add-channel" id="add-channel"></a>

To add a channel, begin by entering the channel's name. We recommend choosing a name that clearly describes the channel you are adding. This will assist with debugging if any issues arise. Once you have entered the name, you'll need to configure click ID tracking and map your conversion events.

<figure><img src="/files/lSvbX09KTpqY1BgeIqcU" alt=""><figcaption></figcaption></figure>

### Set Up Click ID Tracking <a href="#set-up-click-id-tracking" id="set-up-click-id-tracking"></a>

Navigate to the **Campaigns** tab in your Taboola dashboard and select the campaign you wish to track with EdgeTag.&#x20;

<figure><img src="/files/lYObutNPfyq61QOnXJrn" alt=""><figcaption></figcaption></figure>

Once the campaign is selected, scroll down to the **Tracking** section. In the tracking section, add the following parameter to capture click IDs: `tabclid={click_id}`. This parameter allows EdgeTag to track conversions back to specific Taboola clicks.

{% hint style="info" %}
Make sure the click ID parameter is added to all campaigns you want to track.
{% endhint %}

<figure><img src="/files/PSvrqY5OSsiRhxJBNKo1" alt=""><figcaption></figcaption></figure>

You can use any parameter name you prefer (such as `custom_click_id` or `tbl_click`). Whatever parameter name you use in your Taboola campaign tracking, make sure to input the exact same parameter name into EdgeTag's **Query Key** field for proper tracking.

<figure><img src="/files/dyg6Kn6ish3wN1yn3smC" alt=""><figcaption></figcaption></figure>

### Create Conversion Events in Taboola <a href="#create-conversion-events-in-taboola" id="create-conversion-events-in-taboola"></a>

Navigate to the **Tracking** section in your Taboola account from the left sidebar menu.  Click **New Conversion** to begin creating your first conversion event.

<figure><img src="/files/E2UNjpS0EZlCACmAgAXg" alt=""><figcaption></figcaption></figure>

Select **"Create conversions using code"** and click **"Continue"**.

<figure><img src="/files/71Aeoi7bMwgzdztCMcFb" alt=""><figcaption></figcaption></figure>

Configure your conversion event with the following settings:

* **Conversion Name**: Use a descriptive name like "Blotout Purchase" for easy identification
* **Conversion Type**: Select **Event**
* **Category**: Choose the appropriate category based on your event type (e.g., "Make Purchase" for purchase events)

<figure><img src="/files/07ZPtkQAH5oU6APWKNXr" alt=""><figcaption></figcaption></figure>

For the **Event Name** field, you'll need to copy the exact event name from EdgeTag. Navigate to your EdgeTag event mapping section, add the appropriate event mapping, and copy the exact **Taboola Event Name.**

<figure><img src="/files/X7ZpbzyinL6NU06N4kyZ" alt=""><figcaption></figcaption></figure>

Copy the event name from EdgeTag (e.g., `blotout_purchase`) and paste it into the **Event Name** field in Taboola. This ensures proper mapping between EdgeTag and Taboola events.

<figure><img src="/files/2x6jg3MsWR370od5TWIK" alt=""><figcaption></figcaption></figure>

Configure additional settings like attribution windows based on your preferences, then click **Create** to save your conversion event.

After configuring your Query Key and mapping all desired events, click **Save & Deploy** to finalize the integration.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.edgetag.io/channels/taboola/onboarding.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
