Testing

Before you go live, confirm that when someone installs your app AppsFlyer sees it, and that in-app actions like a purchase or a signup get recorded. This page walks you through verifying installs, events, attribution, and user IDs from your phone and the AppsFlyer dashboard.

Enable AppsFlyer in your Despia app settings and turn on debug mode before testing. Turn debug mode off again before you submit to the App Store or Google Play, otherwise every install is marked as a test install and your real attribution data is not recorded.

Installation

Bundle
CDN

npm install despia-native

pnpm add despia-native

yarn add despia-native

import despia from 'despia-native';

<script src="https://cdn.jsdelivr.net/npm/despia-native/index.min.js"></script>

<script type="module">
    import despia from 'https://cdn.jsdelivr.net/npm/despia-native/+esm'
</script>

How it works

When your app is running, Despia passes data to AppsFlyer natively. To check that it is working, you register your test phone with AppsFlyer, install the app on that phone, and watch a live feed in the AppsFlyer dashboard to confirm the data comes through. Gate any test code behind the canonical user agent check so it only runs inside the app.

const isDespia = navigator.userAgent.toLowerCase().includes('despia')

if (isDespia) {
    // send a test purchase to confirm AppsFlyer is receiving data
    const purchase = { af_revenue: 9.99, af_currency: "USD" }
    despia("appsflyer://log_event?event_name=af_purchase&event_values=" + encodeURIComponent(JSON.stringify(purchase)))
}

Register your test device

AppsFlyer ignores data from unknown devices during testing to keep your real data clean, so you register your phone first. The easiest way is the free My Device ID app by AppsFlyer: open it, tap register, log in with your AppsFlyer account, and your phone is added automatically.

My Device ID, iPhone

Download on the App Store

My Device ID, Android

Download on Google Play

You can also add your phone manually in the AppsFlyer dashboard under Settings > Test Devices > Add device.

Install your app

You do not need a Mac, Xcode, or Android Studio. Install the app the normal way for each platform.

iPhone
Android

After you deploy in Despia, the build is uploaded to TestFlight automatically. Open TestFlight on your iPhone and install the latest build. Before installing, delete any existing version of the app so AppsFlyer registers a fresh install.

Watch installs in real time

AppsFlyer has a live feed that shows installs and events as they happen on your test phone.

Open the Live Event Viewer

In the AppsFlyer dashboard, go to Settings > SDK Integration Tests, click Live Events, pick your app, pick your test phone, and click Continue.

Open the app on your phone

The install should appear on the dashboard within a few seconds.

To confirm the attribution arriving in your app is correct, add this and open the app. A popup shows exactly what AppsFlyer knows about where the install came from.

const isDespia = navigator.userAgent.toLowerCase().includes('despia')

if (isDespia) {
    alert("Where did this user come from: " + despia.appsFlyerReferrer)
    alert("AppsFlyer user ID: " + despia.appsFlyerUID)
    alert("Full attribution data: " + JSON.stringify(despia.appsFlyerAttribution, null, 2))
}

Check that events are recorded

With the Live Event Viewer still open, trigger some actions and watch them appear. Each event shows up with its name and a status of 200 OK, which means AppsFlyer received it.

const isDespia = navigator.userAgent.toLowerCase().includes('despia')

if (isDespia) {
    // a purchase
    despia("appsflyer://log_event?event_name=af_purchase&event_values=" + encodeURIComponent(JSON.stringify({ af_revenue: 9.99, af_currency: "USD" })))

    // a login
    despia("appsflyer://log_event?event_name=af_login&event_values=" + encodeURIComponent("{}"))

    // finishing onboarding
    despia("appsflyer://log_event?event_name=complete_onboarding&event_values=" + encodeURIComponent("{}"))
}

Check that your user ID is sent

When a user logs in, you want AppsFlyer to know who they are so you can match events to real users. Add this after your login flow and confirm the event shows up in the Live Event Viewer with the customer user ID attached.

const isDespia = navigator.userAgent.toLowerCase().includes('despia')

if (isDespia) {
    const userId = "test_user_123"
    despia("appsflyer://set_user_id?customer_user_id=" + encodeURIComponent(userId))

    // send an event right after so you can see the ID is attached
    despia("appsflyer://log_event?event_name=af_login&event_values=" + encodeURIComponent("{}"))
}

Test deep links

Deep links resolve natively and arrive through window.onAppsFlyerDeepLink, so verify them by watching the callback, not the page URL. Register the handler early and log what it receives, then open your app from a OneLink or install fresh after clicking one.

window.onAppsFlyerDeepLink = function (payload) {
    alert("Deep link payload: " + JSON.stringify(payload, null, 2))
}

On a fresh install, the deferred deep link arrives on first launch, and on iOS after the App Tracking Transparency prompt is answered. See Deep Linking for the full routing contract.

Before you go live

Turn off debug mode

Turn off debug mode in your Despia AppsFlyer settings. Debug mode is only for testing. If you leave it on, all installs are marked as test installs and your real attribution data is not recorded.

Rebuild and submit

Rebuild the app in Despia for both iOS and Android and submit the new builds. The change does not take effect until users install the new version.

Remove test alerts

Remove any alert() calls you added during testing so they do not appear for real users.

Turning off debug mode requires a fresh native build. If you skip the rebuild, the app users install still runs in debug mode and marks every install as a test install, so no real attribution data is recorded.

Resources

NPM Package

despia-native

Support

support@despia.com

Deployment

Best Practices

Local Ecosystem

Authentication

Payments

Analytics

Connectivity

Machine Learning

Wallets

Native Features

Editor

Roadblocks

Store Rejections

Platform Support

Installation

How it works

Register your test device

My Device ID, iPhone

My Device ID, Android

Install your app

Watch installs in real time

Check that events are recorded

Check that your user ID is sent

Test deep links

Before you go live

Resources

NPM Package

Support

​Installation

​How it works

​Register your test device

My Device ID, iPhone

My Device ID, Android

​Install your app

​Watch installs in real time

​Check that events are recorded

​Check that your user ID is sent

​Test deep links

​Before you go live

​Resources

NPM Package

Support

Installation

How it works

Register your test device

Install your app

Watch installs in real time

Check that events are recorded

Check that your user ID is sent

Test deep links

Before you go live

Resources