UpPromote

UpPromote Integration Overview

The UpPromote and AnyTrack integration is an incredibly powerful combination for marketing teams. Our unified solution offers a seamless 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. With this integration you can confidently measure your ROI across multiple channels with ease!

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 pixels 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

Standard Conversions

The UpPromote Postback URL

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

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}

❗️

Before you begin

The UpPromote integration requires that the AnyTrack Tracking Tag in the head section of your website or landing pages. Learn now to Install the AnyTrack Tag on your website.

Setup Guide

Step #1: Add UpPromote to your AnyTrack Account

1. Go to the Integration Catalog, search for UpPromote.

2. Now click on the UpPromote cardand then Click on Install.

Step #2: Connect your UpPromote account

1. Copy the Postback URL from above
2. Go to your UpPromote affiliate account.
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 (ex: Facebook Conversion API)

Validate your integration

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

🔎

Install the AnyTrack Pixel Helper Extension

Install the AnyTrack Pixel Helper Chrome extension to verify the AnyTrack Tag is installed on your website. It also shows connected ad networks and browser-side events. Learn more.

Link tracking

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

AutoTag Methods

🔥

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.

• 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.
  • 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:

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

📘

Tracking Group

Tracking Group refers to the integration technology. For example, UpPromote Tracking Group tracking group is uppromote and ClickBank is clickbank. The Tracking Group

Conversion Tracking

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

UpPromote conversion payload example

{
  "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"
}

FAQ & Troubleshooting

• Can I import past conversions into Anytrack?

  No. Anytrack can only ingest conversions that have been triggered following a visitor session on your website.

• Can I track direct linking campaigns?

  Yes, but this requires a custom setup. Please refer to this article.

• Can I use a different subid parameter than the one predefined by AnyTrack?

  No.

• Can I track conversions without the click_id?

  No. The click_id passed to the UpPromote links is required to track conversions.

• The Conversion Event Name is not what I am expecting, how can I change it?

  You can update the Event Mapping in the Integration page.

Take these steps to troubleshoot errors you encounter in AnyTrack

• General troubleshooting

  • Verify that your tracking tag is set in the head section of your website.
  • If you're on the free plan, verify that you didn't reach the monthly traffic limit and upgrade if needed.

• Conversion sources

  When you are not tracking conversions, or most conversions trigger an error follow the guidelines below.

🚧

Before you reach out to the tech support, please inspect the conversion log to see what type of errors you are getting and try to fix the integration by following these troubleshooting guidelines.

• Native integrations

  Native integrations refer to platforms that are predefined in the catalog and should provide an error-free data flow.
  The most common error is that the click_id is unknown or missing. It happens when AutoTag could not be activated.
  • Check that your links are not hidden behind some javascripts or double redirects.
  • Check that the links are in a standard a element.
  • Try to manually set the tracking group attribute (check the integration guidelines).
  • Check whether your offers are not getting traffic from websites where the AnyTrack Tag isn't set.
  • If you just installed AnyTrack, errors might be from traffic that wasn't tracked by AnyTrack.

  • Conversion data doesn't trigger an error 🔴, but is not validated 🟢:

    • Check that the Postback URL you've set in the integration matches the pre-defined Postback URL we provide.
    • Copy the Event Reference from the Conversion Event Log and contact the support.

  • You're not getting any conversions:

  • Check that the Postback URL is set and active in your platform.
  • Check that you're passing the correct AutoTag sca_source parameter to the offer link.
  • Check that the Postback URL is correctly inserted in the custom integration.