Tracking Your Mobile Apps in AppsFlyer With Voluum

AppsFlyer is a mobile attribution platform that helps you keep track of all app-related events that are generated by clients. Thanks to their lightweight SDK (Software Development Kit), you can recognize a sales channel a client has gone through and also record everything a client does inside an app that may be of value to you. Passing data that was generated by AppsFlyer to Voluum adds an additional layer of analysis and reporting options that you can use to maximize your profits. The following guide describes how to use the Voluum and AppsFlyer integration.

Caution

Voluum Note: If you are tracking Apple Store apps that use iOS 14.5 and above privacy mechanisms, you have to make additional steps in order to make conversion tracking work. Read the Accepting postbacks with no click IDs article to learn more.

Table of Contents
How Does It Work?

AppsFlyer requires you to submit your app and install their SDK in your app. This piece of code will ping AppsFlyer and send data. There are two types of events recognized by AppsFlyer: app install and in-app events. The first one occurs when a visitor downloads and installs an app. The second event type occurs on occasions defined in the SDK, such as reaching a certain level in a game or making an in-app purchase.

AppsFlyer supports various media sources, such as:

  • Self-Reporting Networks (SRNs), for example, Google or Facebook

  • Owned media

  • Attribution links

Tracking

Tracking with Voluum works when you use an attribution link as a media source and submit it to Voluum as an offer link. You will then be able to use this offer in your Voluum campaign funnel and generate a campaign URL.

When a visitor activates this campaign URL, he or she will be directed through Voluum to AppsFlyer attribution link. This will be counted as a visit. When a visitor triggers any pre-defined event (such as app install or in-app purchase), AppsFlyer will report this as a conversion. Reporting conversions is configured by simply submitting your Voluum tracking domain name to AppsFlyer.

Custom conversions

To distinguish between different conversion types (that may have a different value to you), you need to set up custom conversions in Voluum that will correspond with those events from AppsFlyer. Custom conversions allow you to assign different names and payout values to conversions. For example, you will be able to see different events, such as app install and in-app purchase in separate columns with different payout values. Read the Custom Conversions article to learn more.

If you only track app installs, you don't need to set up custom conversions. Default postback is good enough. However, in the example below, we will use custom conversions to track various conversion types.

Information flow

From Voluum's perspective, AppsFlyer will be treated as an affiliate network, with your apps in AppsFlyer being added as offers in Voluum. In this setup, you will be able to track visits (activations of a campaign URL) and various types of conversions. No clicks will be tracked, This is because clicks in Voluum are activations of a click URL on a landing page and there are no landing pages included in AppsFlyer campaign funnel.

Advanced privacy for the tracking of iOS 14.5 and above devices

Beucase of the recent changes that Apple has introduced in the iOS 14.5 update that block access to IDFA by default, conversions are now handled by Apple, and not AppsFlyer. This causes that AppsFlyer does not have access to user identifying data. So, if you want to track conversions from such devices with AppsFlyer and Voluum, you have to:

  • Set Voluum postback in a way that allows Voluum to record conversions with no click ID.

  • Submit this postback to AppsFlyer and enable Advanced privacy.

Once you do so, conversion tracking will work but you will lose some conversion details in the process. More information about this topic can be found in the Accepting postbacks with no click IDs article.

Before You Start

This guide focuses on the integration and Voluum setup parts. Adding an app to AppsFlyer and installing their SDK will not be covered in this article. So make sure you have the following:

  • An active AppsFlyer account, with at least one app submitted and accepted and the SKD installed.

  • An active Voluum account, with a tracking domain that has an SSL certificate enabled. The SSL certificate is crucial, as AppsFlyer does not accept non-secure communication.

Once you have everything ready, proceed to the next step of this guide.

I. Set Up the Voluum Integration in AppsFlyer

In the first step, you need to set up an integration with Voluum by submitting your Voluum tracking domain name to AppsFlyer. First, you have to get your domain name from Voluum. Follow the steps below to do that:

1. Get a domain name from Voluum

  1. In Voluum, click the profile_settings.png button to go to the Settings page.

  2. Go to the Tracking URLs tab.

    appsflyer1.png
  3. Select a tracking domain from the Main domain drop-down menu and copy the domain name to the clipboard.

2. Configure AppsFlyer

The domain name has to be submitted to AppsFlyer. To do so, follow the steps:

  1. In AppsFlyer, select your app from the Available apps section.

    appsflyer2.png
  2. Go to the Integrated partners view.

  3. Search for Voluum.

  4. In the search results, click the Voluum platform.

    appsflyer3.png
  5. In the integration tab, make sure that the Active Partner toggle is turned on.

  6. Paste the secure domain name that you have copied from Voluum in both Domain name text fields.

  7. Select an SDK Event Name from the drop-down menu and provide a custom value, that will be shown as a custom conversion in Voluum, in the Partner Event Identifier text field.

  8. Additionally, you may add more events in the same way.

  9. Click the Save Integration button.

    appsflyer4.png
  10. Go to the Attribution link tab.

  11. In the Attribution Link Parameters section, you have the option to pass additional pieces of information from Voluum to AppsFlyer, such as campaign name or ad name. These pieces of information can be either static text, numerical values or Voluum dynamic tokens. The list of Voluum tokens that you can pass in this attribution link (which will be your offer link) is available in the offers form in Voluum.

    To pass information, select a parameter name from the Parameter Name drop-down menu, and provide a value (text or token) in the Value text field.

    You can add additional parameter by clicking the Add Parameter button.

    The parameter dedicated for passing the click ID value has already been configured automatically and is included in the link.

  12. Click the appsflyer5.png button to copy the attribution link to the clipboard.

    appsflyer6.png
II. Set Up Custom Conversion Events in Voluum

Because AppsFlyer sends conversion-type events, you need to distinguish them somehow in Voluum. To do this, you need to set up custom conversions. To do so, perform the following steps:

  1. In Voluum, click the profile_settings.png button to go to the Settings page.

  2. Go to the Custom conversions tab.

  3. In the AVAILABLE CUSTOM CONVERSIONS section, click the Add new button.

    appsflyer7.png
  4. In the Custom conversion event name text field, provide the same SDK Event Name that you have selected in AppsFlyer.

  5. In the Values of the et parameter text field, provide the same Partner Event Identifier that you have used in AppsFlyer.

  6. Click the Save button.

    appsflyer9.png

A custom conversion has been added to Voluum.

appsflyer8.png

Add as many custom conversions as you have set SDK Event Names.

III. Add an Offer with AppsFlyer Attribution Link to Voluum

For the last step, you need to add an offer element that will direct visitors via the attribution link to AppsFlyer. In order to do so, perform the following steps:

  1. In Voluum, go to Offers.

  2. Click the Create button and select the Offer option from a drop-down menu.

    new_offer_screen.png
  3. In the new offer form, provide a name for the offer in the Offer name text field.

  4. Paste the attribution link that you have copied from AppsFlyer in the Offer URL text field.

  5. Click the Save button.

    appsflyer10.png

You have added an offer element with an AppsFlyer attribution link to Voluum. You can use this element in your campaign funnels.

IV. Setting up Conversion Tracking

In order to track conversion, you need to submit your postback to AppsFlyer. The example below will also apply to iOS 14.5 devices that send postbacks with no click ID.

  1. Go to Postback Management.

    appsflyer12.png
  2. Provide Voluum postback with no parameters, for example: https://voluum_dedicated.domain.com/postback, in the Install postback and In-app event postback text fields.

  3. Add the caid token to Campaign ID parameter.

    appsflyer13.png
  4. Add a custom parameter attribution and provide cid-caid as the value.

    appsflyer14.png
  5. Click the Save button.

The last thing to do is to make sure that Advanced privacy is turned on in Integrated partners / Voluum / Integration.

appsflyer15.png