AppsFlyer and Adjust postbacks

The in-app setAttribution call can be lost (app killed, offline, callback never fired). A server-to-server postback from the MMP is the backup: AppsFlyer or Adjust tells Rovenue about the install directly. Both feed the same write-once attribution record, so using both is safe.

To send Rovenue's revenue back out to Advenue instead, see the Advenue integration.

URLs

Owners copy both URLs from Acquisition › Settings after saving:

The token in the path is the credential. Rotating the URLs invalidates the old ones immediately; an unknown token answers 404. Only install events are used; other events are acknowledged and skipped.

AppsFlyer

Add a Push API endpoint (Integration › Push API, account owner) with the AppsFlyer push URL, and select the install event. The dashboard path and the Push API field names here are taken from third-party integration guides; AppsFlyer's own support article could not be fetched, so check them against AppsFlyer's current Push API documentation.

Adjust

In AppView, set the Adjust callback URL as the server callback for installs. The generated URL already carries the placeholders Rovenue reads, all from Adjust's placeholder list: activity_kind, adid, tracker_name, network_name, campaign_name, adgroup_name, creative_name, environment and is_organic. Adjust drops a placeholder it has no value for.

Adjust also has network-specific id placeholders. Rovenue requests them all and reads only those of the callback's own network, so an ad's ids key the campaign tree while the names stay names:

Adjust publishes no such id placeholders for Meta, so a Meta install keys by campaign name. is_organic set to true or 1 records the install as organic.

Identity

Rovenue has to know which subscriber the install belongs to.

• AppsFlyer: set customerUserID to the Rovenue id at AppsFlyer init. Read it from currentUser().rovenueId (see the snippets below for where it comes from on each platform). The Push API then carries it as customer_user_id.
• Adjust: add a global callback parameter named rovenue_id carrying the Rovenue id. Do it right after Rovenue is configured and before Adjust starts tracking, so the parameter rides on the install callback:

// iOS (Adjust SDK v5).
let rovenueId = await Rovenue.shared.currentUser().rovenueId
Adjust.addGlobalCallbackParameter(rovenueId, forKey: "rovenue_id")

// Android (Adjust SDK v5), inside a coroutine
val rovenueId = Rovenue.shared.currentUser().rovenueId
Adjust.addGlobalCallbackParameter("rovenue_id", rovenueId)

// React Native
import { Adjust } from 'react-native-adjust';
import { Rovenue } from '@rovenue/react-native-sdk';

const { rovenueId } = await Rovenue.currentUser();
Adjust.addGlobalCallbackParameter('rovenue_id', rovenueId);

// Flutter
final user = await Rovenue.instance.currentUser();
Adjust.addGlobalCallbackParameter('rovenue_id', user.rovenueId);

• Fallback: if no Rovenue id is present, Rovenue matches the vendor device id (appsflyer_id / Adjust adid) against the $appsflyerId / $adjustId subscriber attributes.
  • Adjust: $adjustId is filled for you when the data you pass to setAttribution carries adid (see the hand-off snippets): it is mirrored onto the subscriber.
  • AppsFlyer: the conversion data has no appsflyer_id, so set $appsflyerId yourself from AppsFlyer's SDK, or rely on customer_user_id above:

// iOS
try await Rovenue.shared.setAttributes([
    "$appsflyerId": AppsFlyerLib.shared().getAppsFlyerUID(),
])

// Android, inside a coroutine
AppsFlyerLib.getInstance().getAppsFlyerUID(context)?.let { uid ->
    Rovenue.shared.setAttributes(mapOf("\$appsflyerId" to uid))
}

// React Native
import appsFlyer from 'react-native-appsflyer';
import { Rovenue } from '@rovenue/react-native-sdk';

appsFlyer.getAppsFlyerUID((error, uid) => {
  if (!error && uid) void Rovenue.setAttributes({ $appsflyerId: uid });
});

// Flutter (appsflyer_sdk)
final uid = await appsflyerSdk.getAppsFlyerUID();
if (uid != null) {
  await Rovenue.instance.setAttributes({r'$appsflyerId': uid});
}

A postback that names no known subscriber is acknowledged with 202 and dropped; there is no pending queue.