@global66/nativescript-appsflyer

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

$ tns plugin add @global66/nativescript-appsflyer

$ pod repo update

通过添加（原生 JavaScript）调用模块

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

初始化 SDK。

options

示例

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));
});

• 这些应用内事件可以帮助您衡量忠实用户如何发现您的应用，并将他们归因于特定的活动/媒体来源。请花时间定义您要衡量的事件，以便您能够衡量投资回报率（ROI）和生命周期价值（LTV）。
• logEvent 方法允许您将应用内事件发送到 AppsFlyer 分析。此方法允许您通过直接添加到应用程序代码中来动态添加事件。

options

示例：（原生 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));
});  

3 种深度链接类型

由于用户可能已安装或未安装移动应用程序，因此有两种深度链接类型

1. 延迟深度链接 - 在安装后直接为新用户或前用户提供服务个性化内容。
2. 直接深度链接 - 直接为已安装移动应用程序的现有用户提供服务个性化内容。
3. 统一深度链接 - 统一深度链接在应用程序打开时立即将新用户和现有用户发送到特定的应用内活动。

在以下回调中处理延迟深度链接

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

在'onAppOpenAttribution'回调中处理直接深度链接

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));
    },
};

在'onDeepLinking'回调中处理统一深度链接（如果定义了'onDeepLinking'回调，则不会调用'onAppOpenAttribution'）

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

URI方案

在应用程序的清单中，将以下intent-filter添加到相关活动

<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>

Java

@Override
public void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    setIntent(intent);
}

Kotlin

override fun onNewIntent(intent : Intent){
    super.onNewIntent(intent)
    setIntent(intent)
}

App Links

在应用程序的清单中，将以下intent-filter添加到相关活动

<intent-filter android:autoVerify="true">
    <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" />
    <data android:scheme="https"
        android:host="yourcompany.onelink.me" 
        android:pathPrefix="your path prefix" />
</intent-filter>

URI方案

1. 创建自定义应用程序代理

2. 添加以下iOS方法和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. 添加自定义App Delegate并在其中添加ATT同意对话框以收集IDFA

@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. 在app.ts中添加

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

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

3. 在Xcode中的.plist文件中添加Privacy - Tracking Usage Description

4. 可选：在options中设置timeToWaitForATTUserAuthorization属性以延迟sdk初始化数x秒，直到用户接受同意对话框

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

有关更多信息，请访问我们针对iOS 14的完整支持指南

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

• setSharingFilter：由广告商使用，用于设置一些（一个或多个）网络/集成合作伙伴，以排除从获取数据。

示例：（原生 JavaScript）

var partners = [""];

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

• setSharingFilterForAllPartners：由广告商使用，用于排除所有网络/集成合作伙伴以获取数据。

示例：（原生 JavaScript）

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