From 201c62a47ac9d7a371db21f8ad4a52d2fe5416ac Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 3 Jun 2026 23:58:13 +0000
Subject: [PATCH] docs: add AppsFlyer integration guide
---
docs.json | 3 +-
docs/integrations/appsflyer.mdx | 65 +++++++++++++++++++++++++++++++++
2 files changed, 67 insertions(+), 1 deletion(-)
create mode 100644 docs/integrations/appsflyer.mdx
diff --git a/docs.json b/docs.json
index d9d1ae79..49c92d17 100644
--- a/docs.json
+++ b/docs.json
@@ -50,7 +50,8 @@
"docs/integrations/google-tag-manager",
"docs/integrations/shopify",
"docs/integrations/hubspot",
- "docs/integrations/segment"
+ "docs/integrations/segment",
+ "docs/integrations/appsflyer"
]
}
]
diff --git a/docs/integrations/appsflyer.mdx b/docs/integrations/appsflyer.mdx
new file mode 100644
index 00000000..9abe2e73
--- /dev/null
+++ b/docs/integrations/appsflyer.mdx
@@ -0,0 +1,65 @@
+---
+title: "AppsFlyer"
+"og:title": "How to track mobile app conversion events with AppsFlyer and Dub"
+description: "Learn how to track mobile app conversion events with AppsFlyer and Dub."
+---
+
+
+ This feature is only available on [Business plans and
+ above](https://dub.co/pricing/partners).
+
+
+Dub's AppsFlyer integration lets you attribute mobile app installs, in-app leads, and purchases back to the Dub partner that drove them – powering accurate payouts in your [Dub Partners](https://dub.co/partners) program.
+
+## Prerequisites
+
+Before you start, make sure you have:
+
+- A [Dub Partners](https://dub.co/partners) program set up.
+- An AppsFlyer account with admin access to the app you want to track.
+- A configured [OneLink template](https://support.appsflyer.com/hc/en-us/articles/207032246-OneLink-links-and-experiences) in AppsFlyer.
+
+## Step 1: Install the AppsFlyer integration
+
+Head to your [AppsFlyer integration settings](https://app.dub.co/settings/integrations/appsflyer) in Dub and install the integration to your workspace.
+
+## Step 2: Configure the partner link destination URL
+
+In AppsFlyer, configure the OneLink template you want to use for your Dub program, then set it as the **partner link destination URL** in your Dub program settings.
+
+When choosing your attribution link type, select **Use OneLink** and pick the OneLink template you configured.
+
+## Step 3: Configure event mappings
+
+In your [AppsFlyer integration settings](https://app.dub.co/settings/integrations/appsflyer), map the in-app events you want to track to Dub's `lead` and `sale` events, and set the **including** option to **Values & revenue** so that revenue data is forwarded to Dub.
+
+| AppsFlyer event | Mapped to partner event | Including |
+| --- | --- | --- |
+| Your lead-style event (e.g. `af_complete_registration`) | `lead` | Values & revenue |
+| Your purchase event (e.g. `af_purchase`) | `sale` | Values & revenue |
+
+## Step 4: Test the integration
+
+Before going live, run a few test installs to make sure events are flowing into Dub correctly.
+
+
+
+ AAP delays and aggregates postbacks, which makes individual test events hard to verify. Turn AAP **off** both globally and for the Dub integration during testing.
+
+ See AppsFlyer's guide on [applying the Aggregated Advanced Privacy framework](https://support.appsflyer.com/hc/en-us/articles/360018515798-Apply-Aggregated-Advanced-Privacy-framework) for details.
+
+
+ Remember to re-enable AAP once you're done testing and ready to go live.
+
+
+
+
+ Register your device's IDFA (iOS) or GAID (Android) as a test device in AppsFlyer so that your test installs and events are recognized.
+
+ Follow AppsFlyer's guide on [registering test devices](https://support.appsflyer.com/hc/en-us/articles/207031996-Registering-test-devices#register-a-device-manually) to add your device manually.
+
+
+
+ Click a Dub partner link on your test device, install the app, and trigger the in-app events you mapped in Step 3. The corresponding lead and sale events should appear on your Dub partner's profile shortly after.
+
+