Skip to main content

AppsFlyer integration

Written by David Rolenc
Updated over 2 weeks ago

This guide shows you how to attribute Trackdesk traffic in AppsFlyer and how to send installs and in-app events back to Trackdesk via postbacks. To begin the integration, you will need to provide AppsFlyer with both an attribution link URL and a postback URL.


1. The Attribution Link (iOS & Android)

This link is used to track clicks and attribute them to your Trackdesk campaigns.

Template

https://app.appsflyer.com/<APP_ID>?pid=trackdesk&clickid={cid}&c={offerId}&af_siteid={affId}

What to replace:

  • <APP_ID>: Replace this with your Android package name (e.g., com.example.app) or your iOS bundle ID (e.g., com.example.iosapp).

  • The other parameters (pid, clickid, c, and af_si) are pre-configured to ensure Trackdesk and AppsFlyer communicate correctly.


2. Offer Setup in Trackdesk: Conversion Types

AppsFlyer calls Trackdesk using specific conversionTypeCode values. Before testing your integration, you must ensure these conversion types exist and are enabled for your offer in Trackdesk.

  1. Create/Add conversion types:

    • Install: Use this for first-open or install events.

    • In-app events: Create a conversion type for each event you want to track (e.g., purchase, signup, level_achieved). The name in Trackdesk must exactly match the event name configured in AppsFlyer.

  2. Enable the types: Attach these conversion types to your offer and ensure they are active.

  3. Revenue reporting (Optional): If you plan to report revenue, ensure your conversion types are configured to accept value input. AppsFlyer will pass this as amount.value.

  4. Save your changes: Postbacks will only be accepted and categorized correctly once these types exist in your system.


3. Postback URLs (AppsFlyer → Trackdesk)

Once the offer is set up, you will need to configure the postback URLs in AppsFlyer so they can send data back to Trackdesk.

⚠️ Important: Replace tenantID in the URLs below with your actual Trackdesk Tenant ID.

iOS Postbacks

Install

https://tenantID.trackdesk.com/tracking/conversion/v1?conversionTypeCode=install&cid={clickid}&customParams.advS1={idfa}

In-app event

https://tenantID.trackdesk.com/tracking/conversion/v1?conversionTypeCode={event-name}&cid={clickid}&amount.value={event_value}&customParams.advS1={idfa}

Android Postbacks

Install

https://tenantID.trackdesk.com/tracking/conversion/v1?conversionTypeCode=install&cid={clickid}&customParams.advS1={android_id}

In-app event

https://tenantID.trackdesk.com/tracking/conversion/v1?conversionTypeCode={event-name}&cid={clickid}&amount.value={event_value}&customParams.advS1={android_id}

Note: {clickid} and {event-name} are AppsFlyer macros. {event_value} is the event’s numeric value (if available).


4. Final Step: Activation

Once you have prepared your attribution link and postback URLs, provide them to AppsFlyer support to start the integration on their end.

Did this answer your question?