Skip to main content

AppsFlyer integration

Written by David Rolenc
Updated this week

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?