@global66/nativescript-appsflyer

• iOS AppsFlyerSDK v6.8.0
• Android AppsFlyerSDK v6.8.0

$ tns plugin add @global66/nativescript-appsflyer

$ pod repo update

Call module by adding (native javascript):

var appsFlyer = require("@global66/nativescript-appsflyer");

initializes the SDK.

options

Example:

var options = {
    devKey:  'WdpTVAcYwmxsaQ4WeTspmh',
    appId: "975313579",
    isDebug: true,
    timeToWaitForATTUserAuthorization: 60,
    onConversionDataSuccess: function(_res) {
        console.log(JSON.stringify(_res));
    },
    onConversionDataFailure: function(_res) {
        console.warn("failure: " + JSON.stringify(_res));
    },
};

appsFlyer.initSdk(options).then(function(result) {
    viewModel.set("initSdkResponse", result.status);
}, function(err) {
    viewModel.set("initSdkResponse", JSON.stringify(err));
});

• These in-app events help you measure how loyal users discover your app, and attribute them to specific campaigns/media-sources. Please take the time define the event/s you want to measure to allow you to measure the ROI (Return on Investment) and LTV (Lifetime Value).
• The logEvent method allows you to send in-app events to AppsFlyer analytics. This method allows you to add events dynamically by adding them directly to the application code.

options

Example: (native javascript)

var options = {
    eventName: "af_add_to_cart",
    eventValues: {
        "af_content_id": "id123",
        "af_currency": "USD",
        "af_revenue": "2"
    }
};
appsFlyer.logEvent(options).then(function(result) {
    viewModel.set("logEventResponse", result);
}, function(err) {
    viewModel.set("logEventResponse", JSON.stringify(err));
});  

The 3 Deep Linking Types:

Since users may or may not have the mobile app installed, there are 2 types of deep linking:

1. Deferred Deep Linking - Serving personalized content to new or former users, directly after the installation.
2. Direct Deep Linking - Directly serving personalized content to existing users, which already have the mobile app installed.
3. Unified deep linking - Unified deep linking sends new and existing users to a specific in-app activity as soon as the app is opened.

Handle the Deferred deeplink in the following callback:

var options = {
    onConversionDataSuccess: function(_res) {
        console.log("Get conversion data success: " + JSON.stringify(_res));
    },
}

Handle the Direct deeplink in the 'onAppOpenAttribution' callback:

var options = {
    devKey: 'devKey',
    appId: "appId",
    isDebug: true,
    onAppOpenAttribution: function(_res) {
        console.log("onAppOpenAttribution: " + JSON.stringify(_res));
    },
    onAppOpenAttributionFailure: function(_res) {
        console.log("onAppOpenAttributionFailure: " + JSON.stringify(_res));
    },
};

Handle the Unified deeplink in the 'onDeepLinking' callback (if onDeepLinking callback is define, onAppOpenAttribution won't be called):

var options = {
    devKey: 'devKey',
    appId: "appId",
    isDebug: true,
    onDeepLinking: function(_res) {
        console.log("onDeepLinking: " + JSON.parse(_res))
    },
};

URI Scheme

In your app’s manifest add the following intent-filter to your relevant activity:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="your unique scheme" />
</intent-filter>

URI Scheme

1. Create custom app delegate

2. Add the following iOS method and AppsFlyer API

@NativeClass()
export class CustomAppDelegate extends UIResponder, ATTrackingManager implements UIApplicationDelegate {
    public static ObjCProtocols = [UIApplicationDelegate];

    applicationOpenURLOptions(application: UIApplication, urlOptions: NSURL, options: NSDictionary<string, any>): boolean {
        console.log("applicationOpenURLOptions");
        AppsFlyerLib.shared().handleOpenUrlOptions(urlOptions, options);
        return true;
    }

    // Open URI-scheme for iOS 8 and below
    applicationOpenURLSourceApplicationAnnotation(application: UIApplication, url: NSURL, sourceApplication: string, annotation: any): boolean {
        console.log("applicationOpenURLSourceApplicationAnnotation");
        AppsFlyerLib.shared().handleOpenURLSourceApplicationWithAnnotation(url, sourceApplication, annotation);
        return true;
    }
};

1. Add a custom App Delegate and inside add the ATT consent dialog for IDFA collection:

@NativeClass()
export class CustomAppDelegate extends UIResponder, ATTrackingManager implements UIApplicationDelegate{
    public static ObjCProtocols = [UIApplicationDelegate];

    applicationDidFinishLaunchingWithOptions(application: UIApplication, launchOptions: NSDictionary): boolean {
        if (parseFloat(UIDevice.currentDevice.systemVersion) >= 14) {
            console.log("iOS 14");
            ATTrackingManager.requestTrackingAuthorizationWithCompletionHandler((status) => {

            });
        }
        console.log("applicationDidFinishLaunchingWithOptions");
    }

};

2. In the app.ts add:

import { CustomAppDelegate } from "./custom-app-delegate";

if (Application.ios) {
    Application.ios.delegate = CustomAppDelegate;
}

3. Add Privacy - Tracking Usage Description inside your .plist file in Xcode.

4. Optional: Set the timeToWaitForATTUserAuthorization property in the options to delay the sdk initazliation for a number of x seconds until the user accept the consent dialog:

var options = {
    devKey:  'WdpTVAcYwmxsaQ4WeTspmh',
    appId: "975313579",
    isDebug: true,
    timeToWaitForATTUserAuthorization: 60
};

For more info visit our Full Support guide for iOS 14:

https://support.appsflyer.com/hc/en-us/articles/207032066#integration-33-configuring-app-tracking-transparency-att-support

• setSharingFilter: Used by advertisers to set some (one or more) networks/integrated partners to exclude from getting data.

Example: (native javascript)

var partners = [""];

appsFlyer.setSharingFilter(partners).then(function(result) {
    viewModel.set("setSharingFilterResponse", result.status);
}, function(err) {
    viewModel.set("setSharingFilter Response", JSON.stringify(err));
});

• setSharingFilterForAllPartners: Used by advertisers to exclude all networks/integrated partners from getting data.

Example: (native javascript)

appsFlyer.setSharingFilterForAllPartners().then(function(result) {
    viewModel.set("setSharingFilterForAllPartners", result.status);
}, function(err) {
    viewModel.set("setSharingFilterForAllPartners Response", JSON.stringify(err));
});