# UpPromote

> Learn how to integrate Uppromote with AnyTrack for automated conversion tracking. Set up postback URLs to track affiliate conversions and send data to your ad platforms for campaign optimization.

## UpPromote Integration Overview

The UpPromote and AnyTrack integration is a very powerful combination for marketing teams. Our unified solution offers a automatic link between the two solutions, allowing marketers to easily track conversions from their campaigns. The conversion data sent by UpPromote flows directly into AnyTrack, which then forwards it to platforms like Google Ads, Facebook `Conversion API` and TikTok API—ensuring that no important performance metrics are lost in transition.

<Prerequisites
  title="Before you begin"
  items={[
    { label: "You have an AnyTrack account with a paid subscription", done: true },
    { label: "You have an active UpPromote affiliate account", done: true },
    { label: "The AnyTrack <code>Tracking Tag</code> is installed on your website", done: true },
  ]}
/>

### How does the UpPromote AnyTrack integration work:

1. **Traffic**: When visitors land on your website, AnyTrack collects traffic source data and First Party data.
2. **Engagements**: When visitors click on your UpPromote affiliate links, AnyTrack does a few things:
   1. Collects granular data tied to the `OutboundClick`.
   2. Triggers Event Tracking API requests to your Tracking Tags and analytics.
3. **Conversions:** When visitors convert on the merchant's website, AnyTrack receives real time conversion data through Postback URL.
4. **Attribution:** AnyTrack processes the conversion data and reports it across various reporting sections of the AnyTrack Dashboard.
5. **`Conversion API`:** AnyTrack then sends your conversions to your **Ad Platforms' `Conversion API`** so you can feed your ad platform's Machine Learning, AI and automatic optimization according to 100% of your conversion data.

### Technical details

| Reference       | Value          | Information                                                                        |
| --------------- | :------------- | :--------------------------------------------------------------------------------- |
| Tracking Group  | `uppromote`    | The Tracking Group reference can be used to activate <Glossary>AutoTag</Glossary>. |
| Subid Parameter | `sca_source`   | The Subid Parameter used to pass the AnyTrack `click_id`.                          |
| Tracking Method | `Postback URL` | -                                                                                  |

### Standard Conversions

| Event Name      | Details                                            | Data Source     |
| :-------------- | :------------------------------------------------- | :-------------- |
| `OutboundClick` | When a visitor clicks on UpPromote offer links.    | AnyTrack JS Tag |
| `Lead`          | When a free registration is recorded in UpPromote. | Postback URL    |
| `Purchase`      | When a user generates a commission in UpPromote.   | Postback URL    |

### The UpPromote Postback URL

The Postback URL is fully pre-defined and ready to be implemented with your UpPromote account.

```http
https://t1.anytrack.io/hBtoE3hN/collect/uppromote-test?affiliate_id={affiliate_id}&program_id={program_id}&sca_source={sca_source}&`order_id`={`order_id`}&total_sales={total_sales}&total_commission={total_commission}
```

## Setup Guide

### Step #1: Add UpPromote to your AnyTrack Account

1. Go to the **[Integration Catalog](https://dashboard.anytrack.io/catalog/)**, search for UpPromote.

2. Now click on the [UpPromote card](https://dashboard.anytrack.io/catalog/uppromote)and then Click on Install.

### Step #2: Connect your UpPromote account

1. Copy the Postback URL from above
2. Go to your [UpPromote affiliate account](https://af.uppromote.com).
3. Go to **Settings > Integration > Postback URL**
4. Paste the Postback URL
5. Save changes

### Step #3: Adjust the Conversion Event Mapping

The Event Mapping allows you to define which events to track and map them to Conversion Events you will forward to your Ads Integrations (e.g., Facebook `Conversion API`)

***

## Validate your integration

This section will enable you to validate the main aspects of your setup.

<Callout icon="🔎" theme="default">
  ### Install the AnyTrack Pixel Helper Extension

  Install the [AnyTrack Pixel Helper](https://chromewebstore.google.com/detail/anytrack-pixel-helper/ojmhkmdpagjeopleoeihbhgejcfoijjn) Chrome extension to verify the AnyTrack Tag is installed on your website. It also shows connected ad platforms and browser-side events. [View the Pixel Helper guide](/docs/anytrack-chrome-extension).
</Callout>

### Link tracking

Since Tracking starts when visitors clicks on offer links, you verify that your links are tracked and AutoTagged.

### AutoTag Methods

<Callout icon="🔥" theme="default">
  ### Reminder about AutoTag:

  **AutoTag** is a function that is enabled by default through the AnyTrack Tracking Tag, and that appends `sca_source` & `click_id` data to affiliate links. Learn [more about AutoTag](/docs/autotag).
</Callout>

* **Default**: By default, AnyTrack automatically identifies and AutoTags UpPromote links found on your website.
* **AutoScan**: AnyTrack scans links that are embedded in redirects plugins and AutoTags them accordingly.
* **Manual**:
  * **Tracking Group Attribute**: You add the tracking group attribute to links according to their tracking requirements. For example: `data-tracking-group="uppromote"` or `rel="uppromote"`. More about [Tracking Group](/docs/tgid).
  * **Click ID Token:** You Manually append the `subid`: `&sca_source=--CLICK-ID--` to the offer link.

Once the links are set up, you can check in your UpPromote account reports and see whether the `sca_source` parameters are passed to the offer links.

**Here is an example of how you would manually update links from`uppromote`:**

```html
<a href="https://example.foo/goto/uppromote" data-tracking-group="uppromote">Hover on theUpPromote Demo   
Link to see the AnyTrack `click_id`</a>
```

<HTMLBlock html={"\n<a href=\"https://example.foo/goto/uppromote\" data-tracking-group=\"uppromote\">Hover on the UpPromote Demo Link to see the AnyTrack <code>click_id</code></a>\n"} />

> 📘 **Tracking**
>
> Tracking Group refers to the integration technology. For example, UpPromote <Glossary>Tracking Group</Glossary> tracking group is `uppromote` and ClickBank is `ClickBank`. <Glossary>The Tracking Group</Glossary>

### Conversion Tracking

To validate your setup, you wait for a conversion or trigger a test conversion yourself and inspect the conversion logs.

**UpPromote conversion payload example**

```json

{
  "AnyTrack": "1100l35864",
  "customer_type": "existing",
  "country": "US",
  "referer": "https://www.chewy.com/",
  "search_keyword": null,
  "search_engine_id": null,
  "conversion_time": "1684692689",
  "`conversion_id`": "1011l2002827904",
  "publisher_reference":"mz7yYainzaN6hkc52QVBg",
  "publisher_commission": "10.57",
  "creative_id": "0",
  "source_referer": null,
  "advertiser_reference": null,
  "conversion_type": "1",
  "creative_type": "0",
  "conversion_reference": "1354998698",
  "metadata_query_string": null,
  "currency": "USD",
  "tracking_method": "clickref",
  "value": "52.85",
  "items": [
    {
      "item_code": null,
      "item_id": "1011l860699483",
      "item_sku": "332503",
      "item_commission": "3.5720",
      "item_type": "S",
      "item_gp": null,
      "item_publisher_commission": "3.5720",
      "item_meta": null,
      "item_status": "1",
      "item_value": "17.8600",
      "item_category": "11130",
      "item_vertical": null
    },
    {
      "item_code": null,
      "item_id": "1011l860699484",
      "item_sku": null,
      "item_commission": "0.0000",
      "item_type": "S",
      "item_gp": null,
      "item_publisher_commission": "0.0000",
      "item_meta": null,
      "item_status": "1",
      "item_value": "0.0000",
      "item_category": "COMMISSION",
      "item_vertical": null
    },
    {
      "item_code": null,
      "item_id": "1101l859617416",
      "item_sku": "677350",
      "item_commission": "6.9980",
      "item_type": "S",
      "item_gp": null,
      "item_publisher_commission": "6.9980",
      "item_meta": null,
      "item_status": "1",
      "item_value": "34.9900",
      "item_category": "2802",
      "item_vertical": null
    }
  ],
  "campaign_id": "1100l517",
  "query_string": null,
  "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.4 Mobile/15E148 Safari/604.1"
}

```

***

<FaqAccordion
  title="FAQ and Troubleshooting"
  icon="fa-duotone fa-circle-question"
  items={[
    {
      question: "Can I import past conversions into AnyTrack?",
      answer: "No. AnyTrack can only ingest conversions that have been triggered following a visitor session on your website."
    },
    {
      question: "Can I track direct linking campaigns?",
      answer: "Yes, but this requires a custom setup. Please refer to this <a href='/docs/deeplink'>article</a>."
    },
    {
      question: "Can I use a different <code>subid</code> parameter than the one predefined by AnyTrack?",
      answer: "No."
    },
    {
      question: "Can I track conversions without the <code>click_id</code>?",
      answer: "No. The <code>click_id</code> passed to the UpPromote links is required to track conversions."
    },
    {
      question: "The Conversion Event Name is not what I am expecting, how can I change it?",
      answer: "You can update the Event Mapping in the Integration page.  "
    }
  ]}
/>