AppsFlyer

Step-by-step guide to ingest your event data from AppsFlyer into RudderStack.

AppsFlyer is an industry-leading mobile attribution and marketing analytics platform, provided as a Software-as-a-Service (SaaS). It offers exciting features to understand your customers better through intuitive dashboards, real-time data reports, and a unique deep linking technology.

This document guides you in setting up AppsFlyer as a source in RudderStack. You can send your AppsFlyer events by simply adding an endpoint that points to RudderStack, with AppsFlyer's Push API option. With this integration, you can also capture and send events such as re-engagement, reattribution, in-app install events, etc. to RudderStack.

Getting Started

In order to add AppsFlyer as a source in RudderStack, please follow these steps:

  • From your RudderStack dashboard, click on Add Source. From the list of sources, select AppsFlyer, as shown:

Choose AppsFlyer as a source
  • Enter the name of your source, and click on Next.

Provide source name
  • Head over to your AppsFlyer account and navigate to the API Access section under Integration from the sidebar. Look for the Push API section, as shown:

  • Under the Endpoint Configuration, add an endpoint URL pointing to RudderStack in the following format:<DATA_PLANE_URL>/v1/webhook?writeKey=<your_AppsFlyer_source_write_key>

An example URL should like the following:

https://hosted.rudderlabs.com/v1/webhook?writeKey=1bCenS7ynqHh8ETX8s5Crjh22J

Make sure you add the writeKey as query parameter to the URL. This is required to prevent the webhook from failing for the lack of a valid write key.

You can validate the endpoint using the Send Test button.

Endpoint Configuration
  • Finally, save the endpoint.

RudderStack Event Transformation

The Push events from AppsFlyer are ingested into RudderStack after converting it into the RudderStack event format. For example, the customer_user_id set by AppsFlyer is set as userId .

Also, RudderStack populates the following properties from AppsFlyer event payload to the RudderStack event:

AppsFlyer Property

RudderStack Property

customer_user_id

userId, context.traits.userId

event_name

event

event_time

timestamp, originalTimestamp

ip

context.ip

selected_timezone

context.timezone

user_agent

context.userAgent

bundle_id

context.app.namespace

app_version

context.app.version

app_name

context.app.name

device_type

context.device.model

wifi

context.network.wifi

carrier

context.network.carrier

platform

platform, context.os.name

idfa

context.device.advertisingId for iOS

android_id

context.device.advertisingId for android

appsflyer_id

context.externalId[0].value

os_version

context.os.version

city

traits.address.city, context.traits.address.city

postal_code

traits.address.zip, context.traits.address.zip

country_code

traits.address.country, context.traits.address.country

Contact Us

If you come across any issues while configuring AppsFlyer as a source with RudderStack, please feel free to contact us. You can also start a conversation on our Slack channel - we will be happy to talk to you!