Guides

Connect AppsFlyer

Connect AppsFlyer

Connect AppsFlyer to match your mobile app's install, event, LTV, cohort, and retention data with your ad spend and analyze it automatically. You'll create an AppsFlyer V2 API token and connect it to your workspace.

Each workspace can connect up to one iOS app and one Android app. You can't connect two apps on the same platform to one workspace at the same time. This setup is meant for comparing the iOS and Android versions of the same product, so use separate workspaces for different products or brands.

What you need

  • AppsFlyer Admin access — Only Admins can view and create V2 API tokens. If you don't have this access, ask your account admin to create one for you.

  • At least one app registered in AppsFlyer

Step 1 — Create a V2 API token

  1. In the AppsFlyer dashboard, open the account menu in the top-right corner and go to Security Center.

appsflyer-account-menu.png
Account menu (top right) → Security center
  1. In the AppsFlyer tokens section, open Manage your AppsFlyer tokens.

appsflyer-security-tokens.png
Security Center → AppsFlyer tokens
  1. Click New token to create a new token (API V2), or copy an existing one.

appsflyer-tokens-new.png
Tokens page → New token
  1. The token is a very long string. You can't view it again once you close the screen, so copy it right away and keep it somewhere safe (such as a password manager).

Official guide: Managing AppsFlyer tokens

Step 2 — Add Neuro's IP to the API allowlist (required if you use the allowlist)

AppsFlyer's API allowlist (a list of allowed IPs) is an account security setting. When it's on, data can only be pulled from the addresses you've registered. It's off by default, but many accounts turn it on for security. If the allowlist is active, loading the app list and connecting will fail, even with a valid token, unless you add the IP below.

Neuro connects from a single address, so that's the only one you need to add to the allowlist.

IP to add: 3.39.125.53

How to add it

  1. In the top-right corner of AppsFlyer, go to account menu (email dropdown) → Security Center.

  2. In the API allowlist section, click Manage allowlist.

appsflyer-security-allowlist.png
Security Center → API allowlist
  1. Click + Add and enter the IP above.

  2. Make sure the Active toggle is on, then click Save list. (Clicking Save list alone doesn't change the active status, so check the toggle separately.)

appsflyer-allowlist-page.png
① + Add → ② Enter the Neuro IP → ③ Check Active → ④ Save list
The allowlist is an account-level setting, so it applies to every app in the account at once (not per token). Only Admins can view and activate it.

If your account doesn't use the allowlist (it's inactive), you can skip this step and still connect. However, the token alone can then be used from any IP, so for security we recommend keeping the allowlist Active and adding the IP above.

Official guide: Set up your API allowlist

Step 3 — Connect in Neuro

  1. In your workspace, go to Data sources → AppsFlyer and click the card.

  2. Enter the V2 API token you created in Step 1 and click Load apps.

neuro-connect-appsflyer.png
Neuro AppsFlyer connection window — enter the token, then load apps
  1. If the token is valid, the apps in your account appear. You can select several apps at once to analyze (for example, the iOS and Android versions of the same app).

  2. Click Connect N apps and you're done. The token is encrypted and stored once in your workspace, and it's shared by all the apps you selected.

Example prompts

Once connected, you can ask for analysis in plain language in chat. The AI already knows which apps are connected, so you don't need to give it app IDs.

  • “Show this month's app installs by media source.”

  • “Compare 7-day retention between iOS and Android.”

  • “Which media source or campaign had the highest LTV this quarter?”

  • “Show the ROAS trend for our retargeting campaigns.”

The Cohort and Master APIs require separate access. The V2 API token works with Cohort API and Master API access, which are premium features available only if they're included in your plan. You can check this in the feature list on AppsFlyer's “My Plan” page. If your plan doesn't include them, cohort, LTV, and retention reports can't be loaded. Ask your AppsFlyer contact (integration manager or CSM) to turn them on. Basic install, event, and revenue reports still work.

Troubleshooting

Cohort, LTV, or retention reports don't load

This happens when your account plan doesn't include the Cohort API / Master API add-on. Rephrasing your request won't fix it. Check the feature list in AppsFlyer's “My Plan”, and if needed, ask your AppsFlyer contact to activate the add-on. (Install and event totals work without the add-on.)

It says the token is invalid

Tokens created a long time ago can't be used. Create a new token in Security Center and enter it again.

It says the token doesn't have permission to load the app list

This usually happens because Neuro's IP is missing from your account's API allowlist. Follow Step 2 to add the IP above under Security Center → API allowlist, and make sure you've turned on the Active toggle and clicked Save list. If the error continues, check that the user who created the token has Admin access.

I want to replace the token

Create a new token in AppsFlyer, disconnect your existing AppsFlyer connections, and then reconnect with the new token. Entering the same token again won't save a duplicate.

If you run into any issues connecting or using Neuro, contact us at pango_plat@pango-gy.com. We'll get back to you within 1–2 business days.