Resource Center

Appsflyer Mobile Tracking Integration

__________________________________________________________________________________________________________________

 This article will show you:

  • How to integrate Appsflyer into your Partnerize campaigns
  • How to capture Appsflyer activity within the Partnerize platform

__________________________________________________________________________________________________________________

Index

Overview

Appsflyer is a mobile measurement solution that provides advertisers with the necessary tooling in order to provide their users with an enhanced mobile experience.

When an advertiser opts to work with Appsflyer, the default method of deep linking and tracking is changed, with the reliance instead being on Appsflyer, and because of this, an integration with Appsflyer is required in order to tie Partnerize and Appsflyer together.

The integration can be split into the following steps;

  1. Enablement of the Partnerize integration
  2. Embedding the Appsflyer tracking link
  3. Capture of Partnerize referred in-app purchases 

__________________________________________________________________________________________________________________

Enablement of the Partnerize integration

First, the Partnerize integration must be enabled within Appsflyer so that Appsflyer knows where the data is coming from, so as to then know where to attribute any further information.

  1. Login to the Appsflyer platform
  2. Go to Configuration ➤ Integrated Partners
  3. Search for Partnerize and enable the integration
  4. Ensure the integration is enabled for in-app event postbacks
  5. Click on Permissions and ensure the following are enabled;
    1. Permission to view integration
    2. Permission to control postback configuration 

__________________________________________________________________________________________________________________

Embedding the Appsflyer tracking link

Now you've activated the Partnerize integration, you need to embed the Appsflyer tracking link into your Partnerize campaign in order to redirect your traffic through to Appsflyer.

In Appsflyer

You will now need to generate a cross-platform OneLink, which is a single link which can be used across all of your apps.

  1. From the Appsflyer dashboard, click on Link Management
  2. Now click on Add Custom Attribution Link
  3. Select Multi Platform OneLink
  4. Here, you can now fill in your link information;
    Link name The name can be anything, we'd recommend using Partnerize in here to make it easily distinguishable across all of your other links
    OneLink template Select the template of which you would link the OneLink to be based around. If you don't have a OneLink template, you will have to create one which you can do in OneLink Templates from the dashboard
    Media Source Here, you need to insert partnerize. This is the most important step as this is what will attribute all in-app events back to Partnerize
    Re-Targeting Campaign Toggle this value on
    Advanced > Customize Lookback Window Map this value to the same value as your cookie period
  5. When complete, click on Generate Link
  6. Now copy the content of the Long Link and head over to the Partnerize platform

In Partnerize

  1. Go to the settings of your campaign you wish to integrate with Appsflyer
  2. Paste the Appsflyer tracking link you just copied from the previous step into the Prepend URL input field
  3. Add the following to the link;
&clickid=__CLICKREF__&af_r=__DESTINATION__&af_web_dp=

Which should make your complete link look something like this;

https://molimo.onelink.me/O6Pf?pid=partnerize_int&is_retargeting=true&clickid=__CLICKREF__&af_r=__DESTINATION__&af_web_dp=

__________________________________________

NOTES:

  • The click attribution is done via the __CLICKREF__ parameter which is what Appsflyer uses to tie subsequent events to and send that information back to Partnerize.
  • The destination handling is done via the __DESTINATION__ parameter, which is what Appsflyer will inject into the App to resolve the in-app user journey.
  • Only Universal Linking methods or deep linking are supported by the Partnerize integration. Custom URI schemes (e.g. partnerize://) are not supported.

__________________________________________________________________________________________________________________

Capture of Partnerize referred in-app purchases

Now you have enabled the Partnerize integration and have setup the redirection of all Partnerize campaign traffic through Appsflyer, the only thing left to do is for Appsflyer to tell Partnerize when a sale occurs in-app on the back of a Partnerize click.

Fortunately, Appsflyer will do this automatically and the only thing you need to do is enable the Appsflyer integration within Partnerize and setup the relevant data mappings.

Determine the data mappings

The Appsflyer integration guide recommends that items are sent through in list format, which is also the method supported by the Partnerize Appsflyer module.

For example, if you have the following in-app Purchase event setup with Appsflyer which sends the following data to the Appsflyer event;

{
    "af_content": null,
    "af_receipt_id": "ORDER-123",
    "af_content_id": [
        "JNS-123",
        "BLT-123"
    ],
    "af_content_type": [
        "JEANS",
        "SHOES"
    ],
    "af_currency": "GBP",
    "af_price": [
        "89.00",
        "23.10"
    ],
    "af_quantity": [
        "1",
        "2"
    ],
    "af_validated": "SALE10OFF"
}

The mappings of the above data would resolve to;

Appsflyer Key Partnerize Key
af_receipt_id clickref
af_content_id sku 
af_content_type category 
af_currency currency 
af_price value 
af_quantity quantity
af_validated voucher

Once you have determined the appropriate data mappings from you Appsflyer purchases, you can then pass these onto our support team in the next step.

Enable the Appsflyer integration

  1. Contact our support team to enable the Appsflyer integration for your campaign
  2. Provide the team with your data mappings

__________________________________________________________________________________________________________________

Testing

If the above has been setup correctly, you should start to see in-app events appearing in the Partnerize console.

__________________________________________________________________________________________________________________

TOP TIP: Rather than setting the Appsflyer tracking link for your whole campaign, you can test with a single partner by clicking on "Partners" and selecting your partner of choice, then click "Campaign overrides" and adding the tracking link to the "Prepend Click URL" which will only impact that single partner and not every partner on your campaign

__________________________________________________________________________________________________________________

FAQ's

Please refer to our Appsflyer FAQ guide here: Appsflyer FAQ's

__________________________________________________________________________________________________________________

Questions

If you have any technical questions regarding this document please get in touch with our Integration team at integrations.support@partnerize.com   

Was this article helpful?

5 out of 5 found this helpful

Have more questions? Submit a request