Campaigns

Connect your TikTok and Meta ad accounts to AppsFlyer for accurate install attribution, event postbacks, and ROAS reporting per campaign. Combined with conversion events from the Events page, this gives you a full picture of which campaigns drive the most valuable users, not just the most installs.

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>

Connect Partners in AppsFlyer

For install attribution and event postbacks to flow to Meta and TikTok you need to connect them as integrated partners.

Open Integrated Partners

In your AppsFlyer dashboard, go to Configuration > Integrated Partners.

Connect Meta

Find Meta ads, click Edit, enable the integration, and enter your Meta App ID.

Map conversion events

Under In-App Events, map af_purchase, af_subscribe, and any other conversion events you want Meta to optimize for.

Repeat for TikTok

Find TikTok for Business and repeat the same process.

Set event postbacks to All media sources including organic for the Install event. This ensures Meta and TikTok receive data for all installs, not just their own attributed ones.

Custom Attribution Links

Create campaign-specific OneLink URLs to track performance per campaign, ad set, or creative.

Open OneLink Management

Go to Engage > OneLink Management in your AppsFlyer dashboard.

Create a link

Select your OneLink template and click Add Link.

Configure the link

Set the media source, campaign name, and any custom parameters like deep_link_value or page_id.

Use in your ads

Paste the generated link directly into your TikTok or Meta ad creative as the destination URL.

https://yourapp.onelink.me/xxxx?pid=tiktokads_int&c=summer_2025&deep_link_value=product&page_id=sneaker_42

To route users to the right page when they open the app from one of these links, see Deep Linking.

Ad Revenue Tracking

Report impression-level ad revenue back to AppsFlyer per platform. This enables LTV and ROAS reporting per acquisition channel, so you can see which campaigns drive the most revenue, not just the most installs. Use log_ad_revenue each time an ad is shown to the user.

Meta / Facebook
TikTok
AdMob

const metaRevenue = {
    ad_platform: "facebook",
    currency: "USD",
    revenue: 0.008,
    ad_type: "interstitial",
    ad_unit_id: "your_unit_id"
}
despia("appsflyer://log_ad_revenue?" + new URLSearchParams(metaRevenue).toString())

const tiktokRevenue = {
    ad_platform: "tiktok",
    currency: "USD",
    revenue: 0.005,
    ad_type: "banner",
    ad_unit_id: "your_unit_id"
}
despia("appsflyer://log_ad_revenue?" + new URLSearchParams(tiktokRevenue).toString())

const admobRevenue = {
    ad_platform: "admob",
    currency: "USD",
    revenue: 0.012,
    ad_type: "rewarded",
    ad_unit_id: "ca-app-pub-xxx/yyy"
}
despia("appsflyer://log_ad_revenue?" + new URLSearchParams(admobRevenue).toString())

string

required

Ad network name. Accepted values: "facebook", "tiktok", "admob".

string

required

3-character ISO 4217 currency code, e.g. "USD", "EUR", "AED". Defaults to "USD" if omitted.

number

required

Revenue amount for this ad impression. No commas or currency signs.

string

Type of ad served. Accepted values: "banner", "interstitial", "rewarded", "native".

string

Your ad unit ID from the ad network.

For best practices on impression-level reporting, see the Ad Revenue page.

Web-to-App Attribution

If users discover your app through your website before installing, add the AppsFlyer Smart Banner to stitch the web visit to the app install. Without this, users who visit your site and later install the app appear as organic in AppsFlyer. Add this to your website <head>:

<script>
!function(t,e,n,s,a,c,i,o,p){t.AppsFlyerSdkObject=a,t.AF=t.AF||function(){
(t.AF.q=t.AF.q||[]).push([Date.now()].concat(Array.prototype.slice.call(arguments)))},
t.AF.id=t.AF.id||i,t.AF.plugins={},o=e.createElement(n),p=e.getElementsByTagName(n)[0],o.async=1,
o.src="https://websdk.appsflyersdk.com?"+(c.length>0?"st="+c.split(",").sort().join(",")+"&":"")+(i.length>0?"af_id="+i:""),
p.parentNode.insertBefore(o,p)}(window,document,"script",0,"AF","banners",{banners:{key:"YOUR_WEB_KEY"}});
AF('banners', 'showBanner');
</script>

Replace YOUR_WEB_KEY with the web key from your AppsFlyer dashboard under Settings > Brand Bundles > Web dev key. This is a web-only change, no native code changes are required.

Frequently Asked Questions

Why use AppsFlyer instead of the Meta and TikTok SDKs directly?

If you install the Meta SDK and TikTok SDK separately, each platform only sees its own data and will overclaim credit for the same install. AppsFlyer acts as a neutral middleman. It determines which channel actually gets credit using last-click attribution and reports back to each platform what it earned, so your ROAS numbers become trustworthy.

Will Meta and TikTok numbers always match AppsFlyer?

No, and that is expected. Meta and TikTok use their own attribution models, which typically show higher install counts than AppsFlyer. AppsFlyer’s numbers are more accurate for your own budget decisions. Use AppsFlyer to decide where to spend, and use the Meta and TikTok dashboards to manage creatives.

What events should I map for TikTok and Meta optimization?

Map af_complete_registration, af_purchase, and af_subscribe at minimum. These give the ad algorithms enough signal to find users likely to convert. If you only map installs, the algorithms optimize for install volume, which rarely correlates with revenue.

Resources

NPM Package

despia-native

Smart Banners Docs

AppsFlyer Smart Banner SDK reference

Meta Ads Integration

Meta ads event mapping guide

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

Connect Partners in AppsFlyer

Custom Attribution Links

Ad Revenue Tracking

Web-to-App Attribution

Frequently Asked Questions

Resources

NPM Package

Smart Banners Docs

Meta Ads Integration

Support

​Installation

​Connect Partners in AppsFlyer

​Custom Attribution Links

​Ad Revenue Tracking

​Web-to-App Attribution

​Frequently Asked Questions

​Resources

NPM Package

Smart Banners Docs

Meta Ads Integration

Support

Installation

Connect Partners in AppsFlyer

Custom Attribution Links

Ad Revenue Tracking

Web-to-App Attribution

Frequently Asked Questions

Resources