For the complete documentation index, see llms.txt. This page is also available as Markdown.

🕊️AppsFlyer

Attribute app installs and in-app activity to your marketing campaigns using AppsFlyer.

What is AppsFlyer?

AppsFlyer is a mobile attribution and marketing analytics platform that helps you understand where your app installs come from and how users move through their journey after installing. It supports campaign management, conversion attribution, audience segmentation, and retention tracking.

iOS attribution via SKAdNetwork is supported, letting ad campaigns be linked to iPhone installs in compliance with Apple's attribution requirements.

Prerequisits

AppsFlyer Configuration

  1. Go to My Apps in AppsFlyer and click Add app.

  2. Select the Android, AndroidTV, Fire platform.

  3. Indicate your app's Google Play status:

    • In Store - select this and enter your app's Google Play URL.

    • Pending approval/not published - select this and enter your Package ID, found in the Natively Dashboard under Publish > Android Build > Bundle Identifier.

  4. Select your app's currency, and whether it's targeted at a kids audience.

  5. On the success screen, copy the generated Dev Key.

Step 1
Step 2-3
Step 4
Step 5
  1. Go to My Apps in AppsFlyer and click Add app.

  2. Select the iOS, tvOS, MacOS platform.

  3. Indicate your app's App Store status:

    • In Store - select this and search for your published app.

    • Pending approval/not published - select this if your app isn't live yet.

  4. Select your store country, then enter your App ID - found in the Natively Dashboard under Publish > iOS Build > App Store App ID, or directly in App Store Connect.

  5. Select your app's currency, and whether it's targeted at a kids audience.

  6. On the success screen, copy the generated Dev Key.

Step 1
Step 2-4
Step 5
Step 6

Natively Dashboard Setup

  1. Open your Natively app dashboard and navigate to Features > Analytics > AppsFlyer.

  2. Toggle the feature to Enabled.

  3. Enter the Dev Key you copied from AppsFlyer.

  4. (iOS only) Enter the Permission Description.

  5. Click Save.

  6. Rebuild your app(s).

The Permission Description is the text shown to iOS users when the OS asks them to grant tracking permission (App Tracking Transparency). This field only applies to iOS. Explain clearly why your app needs this permission - for example: "We use your data to provide personalized advertisements that are relevant to your interests."

Implementation

Natively doesn't expose a dedicated AppsFlyer-specific method - app install tracking and attribution happen automatically once configured, with no additional call required.

For any event beyond the automatic install event - such as registration_completed or profile_completed - you must send it yourself using Custom Event. These events cannot be configured entirely within the AppsFlyer or Meta dashboard; the dashboards can map, report, and optimize on events, but your app must actually send each event at the moment the action happens.

🕵️Custom Event

How to use

Track installs automatically, no setup needed

Once configured, AppsFlyer tracks app installs and attribution on its own - you don't need to call any method for this to work.

Use Custom Event for everything beyond installs

For engagement, feature usage, or funnel tracking, use Custom Event - it's forwarded to AppsFlyer automatically once configured.

Verify your integration before launching campaigns

Use AppsFlyer's SDK Integration Test tool (see Testing on the Custom Event page) to confirm installs and events are actually reaching AppsFlyer before you spend budget attributing campaigns to it.

Troubleshooting

Installs aren't showing up in AppsFlyer

Go through this checklist:

  • Confirm the feature is enabled and the Dev Key is correcly entered in the Natively Dashboard.

  • Confirm the app has been rebuilt.

  • Confirm you've allowed enough time for data to propagate.

Installs or events stop appearing after working previously

Check whether your AppsFlyer Welcome Package has expired or been exhausted. New AppsFlyer accounts get 12,000 free conversions usable within their first 12 months - once that window closes or the conversion limit is hit, tracking on the Zero plan may stop or require a plan upgrade. Check your plan status under AppsFlyer > Account > Plan before assuming the integration itself is broken.

Not working in a web browser or the Natively Preview app

This is a native feature and does not work in a standard web browser or in the Natively Preview app. Test on a real device using a full Natively build.

Last updated