Voluum Documentation

Tracking Your Mobile Apps in AppsFlyer With Voluum

Appslyer 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.

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.

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.

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. This 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 the Offers tab.

  2. Click the New offer button and select the Create new offer option from the drop-down menu.

    new_offer.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.