适用于开发人员的Android SDK集成

使用以下方法之一来将SDK添加到你的app：

• [最佳实践]使用Gradle
• 手动添加SDK

The Android Install Referrer improves attribution accuracy, protects from install fraud, and more. It is supported from AppsFlyer Android SDK version 4.8.6.

以下有两种方式可以将Install Referrer 添加到您的App中

• 使用Gradle（推荐）
• 手动添加 Install Referrer

添加permissions有助于概率模型归因的比率。它还允许SDK发送更多数据，例如Wifi和运营商网络数据。您可以在原始数据报告找到此数据，并将其用于分析和优化活动。

添加所需权限

1. 将以下权限添加到AndroidManifest.xml：
   

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
   

BroadcastReceiver从Google Play获取 AppsFlyer用于归因 。使用BroadcastReceiver可以提高归因率。

实施安装引用广播接收器，有如下两种方案：

<application>
	<receiver android:name="com.appsflyer.SingleInstallBroadcastReceiver" android:exported="true">
		<intent-filter>
			 <action android:name="com.android.vending.INSTALL_REFERRER" />
		 </intent-filter>
	</receiver>
</application>

<application>
	<receiver android:name="com.appsflyer.MultipleInstallBroadcastReceiver" android:exported="true">
		<intent-filter>
			<action android:name="com.android.vending.INSTALL_REFERRER" />
		</intent-filter>
	</receiver>
</application>

AppsFlyer使用唯一的dev key来标识您的帐户。dev key是强制性的，因为它允许SDK安全地发送和检索属于您AppsFlyer帐户的数据。

警告！使用错误的开发密钥会影响从SDK发送的所有流量，无法归因这些流量也无法体现在任何报告中。

获取您的dev key：

1. 转到应用控制面板。
2. 在面板上, 点击 Configuration 下的 App Settings。
3. 复制您的dev key。
   
   

   

注册全局应用类

在AndroidManifest.xml文件的 application 标签内，添加以下行：

android:name="<APP.PACKAGE.NAME>.<AFApplication>"

• <APP.PACKAGE.NAME> -用应用包名称替换。
• <AFApplication> -将其替换为您为全局应用类设置的名称。

manifest.xml中的这一行告诉应用程序什么是全局应用程序。如上所述，这样做使AppsFlyer SDK可以在整个应用程序中全局访问。

SDK初始化

我们建议在应用程序的全局应用程序类（global application state）中初始化SDK。这使SDK可以在所有方案中进行初始化，包括深度链接。

下述步骤发生在应用的全球应用类（global application class）中。

1. 在应用的global class中，导入以下库
   

   import com.appsflyer.AppsFlyerLib;
   import com.appsflyer.AppsFlyerConversionListener;

2. Inside the global class, assign your dev key to a variable, preferably named AF_DEV_KEY.
   
   Java Kotlin

   public class AFApplication extends Application {
       private static final String AF_DEV_KEY = "qrdZGj123456789";
       
       //...
       
   }
   

   class AFApplication : Application() {
       private val devKey = "qrdZGj123456789";
   
       //...
       
   }
   

3. 在global class内部，在调用 super.onCreate（） 后 ，实施AppsFlyerConversionListener.请参阅下面步骤4中的代码。
4. 在global class内部, 在ConversionListener后, 利用 init() 方法来初始化SDK。 
   
   Java Kotlin

   public class AFApplication extends Application {
       private static final String AF_DEV_KEY = "qrdZGj123456789";
       
       @Override
       public void onCreate() {
           super.onCreate();
           AppsFlyerConversionListener conversionListener = new AppsFlyerConversionListener() {
               @Override
               public void onConversionDataSuccess(Map<String, Object> conversionData) {
               
                       for (String attrName : conversionData.keySet()) {
                       Log.d("LOG_TAG", "attribute: " + attrName + " = " + conversionData.get(attrName));
                   }
               }
   
               @Override
               public void onConversionDataFail(String errorMessage) {
   		   Log.d("LOG_TAG", "error getting conversion data: " + errorMessage);
               }
   
               @Override
               public void onAppOpenAttribution(Map<String, String> attributionData) {
                   for (String attrName : attributionData.keySet()) {
                       Log.d("LOG_TAG", "attribute: " + attrName + " = " + attributionData.get(attrName));
                   }
               }
   
               @Override
               public void onAttributionFailure(String errorMessage) {
                   Log.d("LOG_TAG", "error onAttributionFailure : " + errorMessage);
               }
           };
           
           AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionListener, this);
   
       }
   }
                 

   class AFApplication : Application() {
       private val devKey = "qrdZGj123456789";
   
       override fun onCreate() {
           super.onCreate()
           val conversionDataListener  = object : AppsFlyerConversionListener{
               override fun onConversionDataSuccess(data: MutableMap<String, Any>?) {
                   data?.let { cvData ->
                       cvData.map {
                           Log.i(LOG_TAG, "conversion_attribute:  ${it.key} = ${it.value}")
                       }
                   }
               }
   
               override fun onConversionDataFail(error: String?) {
                   Log.e(LOG_TAG, "error onAttributionFailure :  $error")
               }
   
               override fun onAppOpenAttribution(data: MutableMap<String, String>?) {
                   data?.map {
                       Log.d(LOG_TAG, "onAppOpen_attribute: ${it.key} = ${it.value}")
                   }
               }
   
               override fun onAttributionFailure(error: String?) {
                   Log.e(LOG_TAG, "error onAttributionFailure :  $error")
               }
           }
   
           AppsFlyerLib.getInstance().init(devKey, conversionDataListener, this)
       }
   }
   

5. 在应用程序的全局类中，调用start() 。
   
   Java Kotlin

   AppsFlyerLib.getInstance().start(this);
   

   AppsFlyerLib.getInstance().start(this)

要延迟初始化SDK，可以从Activity类调用start。

此选项可用于例如，如果由于GDPR或CCPA要求等原因需要推迟启动，直到获得用户同意。

在Activity类中调用start时：

• 确保将Activity作为argument而不是Application来传递。
• If you plan to use deep linking features, add the start() API to any other Activity you to which you can deep link that doesn’t have start in it.

在开始测试安装之前，请为该设备添加测试设备白名单。

自然安装是未被归因的安装，通常是直接前往应用商店安装的用户。

要模拟自然安装：

1. 确保已将移动设备连接到计算机。
2. 在Android Studio中，打开Logcat。
3. 在Android Studio中，将应用安装到设备或模拟器上。
4. 等待应用启动。
5. 在Logcat中，查找该应用的包名。

您应该看到以下内容：

屏幕截图中突出显示的部分表示SDK报告了自然安装。此数据来自AFApplication类中的 onConversionDataSuccess 方法。获取转换数据在 本指南后面将进行讨论 。

注意： 从SDK Version5开始， onConversionDataSuccess 是获取转换数据的方法的名称。如果使用的SDK版本低于5.0.0，则该方法的名称为 onInstallConversionDataLoaded 。我们建议您升级到SDK 5.0.0。要了解更多信息，请点击这里 。

此时该应用的数据总览面板上会出现一个自然安装。

如果您未在应用程序的仪表板上看到安装，请参阅我们的 SDK故障排除指南 。

非自然安装通常是在广告互动之后的可归因安装。您可以使用归因链接模拟非自然安装。

模拟非自然安装：

1. 在manifest中，找出您的应用包名，例如com.company.app。
   • In the URL below, replace <app_package_name> with your app's package name:
     

     https://app.appsflyer.com/<app_package_name>?pid=Test&c=Test

     例如:

     https://app.appsflyer.com/com.company.app?pid=Test&c=Test

   • The c parameter specifies the name of the campaign.
   • pid 参数指定将安装归因于的媒体渠道的名称。
   • 如果使用电脑来做点击测试，则应添加广告ID（GAID）（将&advertising_id=<GAID>添加至链接的末尾）。
2. 将此URL发送到设备。可以通过电子邮件或WhatsApp发送
3. 在设备上，单击URL。
   • 如果该应用已在应用商店上架，那您将跳转至应用商店。不要从应用商店下载并安装该应用。继续执行步骤5。
   • 如果该应用未在应用商店上架并且仍在开发中，则屏幕会显示‘在应用商店中找不到这个应用’。继续执行步骤5。
4. 在Android Studio中，打开Logcat。
5. 使用USB数据线将设备连接到计算机。
6. 通过Android Studio在设备上安装该应用。
7. 在Logcat中，查找该应用的包名。

您应该看到以下内容：

A non-organic install should now appear on the Overview page of the application's dashboard.

SDK具有两个与应用程序内事件相关的接口：

• AFInAppEventType - 应用内事件名称常量。
• AFInAppEventParameterName -应用内事件参数名称常量。

出于以下原因，我们强烈建议使用这两个接口：

• 标准命名使得AppsFlyer可以将事件自动映射到SRN，例如Facebook，Google，Twitter和Snapchat。
• 向后兼容-如果AppsFlyer决定更改任何事件或事件参数的名称，则您的实现是向后兼容的。

要使用这两个接口，请导入它们：

import com.appsflyer.AFInAppEventParameterName;
import com.appsflyer.AFInAppEventType;

这里是推荐事件名称和结构列表 。

您可以通过任何应用内事件发送收入。使用 af_revenue （ AFInAppEventParameterName.REVENUE ）事件参数将收入包含在应用内事件中。您可以使用任何数值（正数或负数）填充它。

af_revenue is the only event parameter that AppsFlyer counts as real revenue on the raw data and dashboard. For more details, click here.

发送收入事件时，请记住以下几点：

• If you set currency code (see example below), it should be a 3-character ISO 4217 code. (default is USD).
• 您可以通过调用以下方法为所有事件设置货币代码： AppsFlyer.setCurrencyCode（ " ZZZ " ） 要了解有关货币设置、显示和货币换算的信息，请参见我们的收入货币指南。
• The revenue value should not contain comma separators, currency signs, or text. A revenue event should be similar to 1234.56, for example.

示例 ：有收入的应用内购买事件

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,1234.56);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"Shirt");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD");
AppsFlyerLib.getInstance().logEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

val eventValue = HashMap<String, Any>() 
eventValue.put(AFInAppEventParameterName.REVENUE,1234.56)
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"Shirt")
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567")
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD")
AppsFlyerLib.getInstance().logEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue)

The purchase event above has $1,234.56 in revenue associated with it, which appears as revenue in the dashboard.

记录负收入

在某些情况下，您想记录负收入。

例如，用户收到你售出的鞋子的退款。

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,-200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"shoes");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"4875");
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD");
AppsFlyerLib.getInstance().logEvent(getApplicationContext() , "cancel_purchase" , eventValue);

val eventValue = HashMap<String, Any>()
eventValue.put(AFInAppEventParameterName.REVENUE, -200)
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "category_a")
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "1234567")
eventValue.put(AFInAppEventParameterName.CURRENCY, "USD")
AppsFlyerLib.getInstance().logEvent(applicationContext,  "cancel_purchase", eventValue)

AppsFlyer的SDK为应用内购买事件提供服务器验证服务。通过调用 validateAndLogInAppPurchase来检验一次购买事件。

该方法调用将自动生成一个 af_purchase 应用内事件。

public static void validateAndLogInAppPurchase(Context context, 
String publicKey, String signature, String purchaseData, 
String price, String currency, HashMap<String, String> additionalParameters);

方法参数

• 字符串publicKey-Google Developer Console的公共密钥。
• 字符串签名–交易签名（购买完成后从Google API返回）。
• 字符串PurchaseData –以JSON格式显示的已购产品（购买完成后从Google API返回）。
• 字符串收入–向AppsFlyer报告应用内事件收入。
• 字符串货币-报告给AppsFlyer的应用内事件货币。
• HashMap<String, String> 额外参数 – 出现在原始数据event_value字段的额外应用内事件参数。

购买验证成功和失败回调

如果您想知道验证购买是否成功，请在application类中实现registerValidatorListener。该监听器有两个回调块，一个用于“成功”，一个用于“失败”（出于任何原因，包括验证失败）。

AppsFlyerLib.getInstance().registerValidatorListener(this,new
   AppsFlyerInAppPurchaseValidatorListener() {
     public void onValidateInApp() {
       Log.d(TAG, "Purchase validated successfully");
     }
     public void onValidateInAppFailure(String error) {
       Log.d(TAG, "onValidateInAppFailure called: " + error);
     }
});

AppsFlyerLib.getInstance().registerValidatorListener(this, object : AppsFlyerInAppPurchaseValidatorListener {
    override fun onValidateInApp() {
       	Log.d(LOG_TAG, "Purchase validated successfully")
    }

    override fun onValidateInAppFailure(error: String) {
        Log.d(LOG_TAG, "onValidateInAppFailure called: $error")
   }
})

购买验证的用法示例：

// Purchase object is returned by Google API in onPurchasesUpdated() callback
private void handlePurchase(Purchase purchase) {
    Log.d(LOG_TAG, "Purchase successful!");
    Map<String, String> additional_event_values = new HashMap<>();
    additional_event_values.put("some_parameter", "some_value");
    String price= "10";
    String currency = "USD";
    AppsFlyerLib.getInstance().validateAndLogInAppPurchase(getApplicationContext(), PUBLIC_KEY, purchase.getSignature(), purchase.getOriginalJson(), revenue, currency, additional_event_values);
}

// Purchase object is returned by Google API in onPurchasesUpdated() callback
private fun handlePurchase(Purchase purchase) {
   Log.d(LOG_TAG, "Purchase successful!");
   val additional_event_values = HashMap<String, String>()
   additional_event_values.put("some_parameter", "some_value");
   val price= "10";
   val currency = "USD";
   AppsFlyerLib.getInstance().validateAndLogInAppPurchase(this, PUBLIC_KEY, purchase.getSignature(), purchase.getOriginalJson(), revenue, currency, additional_event_values);
}

验证应用内购会自动将应用内购买事件上报到AppsFlyer。参见下面event_value参数中传递的示例数据：

{
   "some_parameter":"some_value", // from additional_event_values
   "af_currency":"USD", // from currency
   "af_content_id":"test_id", // from purchase
   "af_revenue":"10", // from revenue
   "af_quantity":"1", // from purchase
   "af_validated":true // flag that AF verified the purchase
}

• 事件名称：最多45个字符
• 事件值：不得超过1000个字符-如超过这个长度，我们可能会截断它
• 定价和收入：仅使用数字和小数点，例如5或5.2
• 价格和收入最多可以到小数点后5位，如5.12345
• 从Android SDK V4.8.1开始，应用内事件和其他SDK API都支持非英语字符。

你可以通过调用 logEvent 来记录包含事件名字和事件值的应用内事件。查看 In-App Events 文档来了解更多细节。

以下是有关如何记录购买事件的简单示例。关于每个行业的现成代码片段列表，请参阅详细应用内事件指南

示例：应用内购买活动

Map<String,Object> eventValues = new HashMap<>();
eventValues.put(AFInAppEventParameterName.REVENUE, 1200);
eventValues.put(AFInAppEventParameterName.CURRENCY, "JPY");
eventValues.put(AFInAppEventParameterName.CONTENT_TYPE, "Shoes");
AppsFlyerLib.getInstance().logEvent(this, AFInAppEventType.PURCHASE, eventValues);

val eventValues = HashMap<String, Any>();
eventValues.put(AFInAppEventParameterName.REVENUE, 1200)
eventValues.put(AFInAppEventParameterName.CURRENCY, "JPY")
eventValues.put(AFInAppEventParameterName.CONTENT_TYPE, "Shoes")
AppsFlyerLib.getInstance().logEvent(this, AFInAppEventType.PURCHASE, eventValues)

如果用户在互联网连接不可用时启动事件，Appsflyer仍然可以记录该事件。它是这样工作的：

1. SDK 将事件发送到 AppsFlyer 的服务器并等待响应。
2. 如果 SDK 没有收到响应200, 则该事件将存储在缓存中。
3. 收到下一个响应200后, 存储的事件将重新发送到服务器。
4. 如果缓存中有多个事件, 它们将被立即按序发送到服务器。

您可以在记录应用内事件时设置监听器。监听器可以给两种场景定义逻辑：

• 应用内事件已成功记录。
• An error occurred when recording an in-app event.

AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.PURCHASE, eventValue, new AppsFlyerRequestListener() {
                    @Override
                    public void onSuccess() {
                        Log.d(LOG_TAG, "Event sent successfully");
                    }
                    @Override
                    public void onError(int i, @NonNull String s) {
                        Log.d(LOG_TAG, "Event failed to be sent:\n" +
                                "Error code: " + i + "\n"
                                + "Error description: " + s);
                    }
                });

AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.PURCHASE, eventValue, object : AppsFlyerRequestListener {
            override fun onSuccess() {
                Log.d(LOG_TAG, "Event sent successfully")
            }
            override fun onError(errorCode: Int, errorDesc: String) {
                Log.d(LOG_TAG, "Event failed to be sent:\n" +
                        "Error code: " + errorCode + "\n"
                        + "Error description: " + errorDesc)
            }
        })

如果在记录应用内事件的时候发生错误，错误代码和字符串说明如下，请参考：

For users without your app installed, OneLink detects the device type and redirects them to the correct destination: Google Play, Apple App Store, third-party app store, or web page. This is based on your OneLink template settings. Learn more

Note: Device detection and redirection do not require the AppsFlyer SDK. However, the SDK is required for deep linking.

For users with your app installed, OneLink opens the app. In addition to opening the app, you can also deep link users to a specific activity or page within the app. This requires your developer to implement Unified Deep Linking (UDL).

请参阅我们的用于深度链接的URI Scheme设置指南 。

注意：

• UDL requires SDK V6.1+
• Customers already using OneLink for deep linking may be using the legacy method, instead of UDL

For users without your app installed, OneLink detects the device type and redirects them to the correct destination: Google Play, Apple App Store, third-party app store, or web page. Once the user launches the app, you can use deferred deep linking to redirect them to a specific activity or page within the app.

This requires your developer to implement Unified Deep Linking (UDL).

请参阅深度链接设置指南了解更多信息。

注意：

• UDL requires SDK V6.1+
• Customers already using OneLink for deferred deep linking might be using the legacy method, instead of UDL

The SDK provides you with conversion and engagement data following every install or deep linking event. You can use this data to customize content and the app's behavior programmatically.

当深度链接直接打开应用程序时想要获取深度链接数据，请配置onAppOpenAttribution 。

要随时手动获取深度链接的再互动数据，请配置performOnAppAttribution 。这将允许访问re-engagement数据， 而不会算作一个新的re-engagement转化 。

请参阅深度链接设置了解更多信息。

You can use OneLink to measure user re-engagement via push notifications. See our guide on measuring push notification re-engagement campaigns.

在SDK层级，您可以实时的获取每一次新安装用户的归因数据

通过这个方式，你可以为用户提供个性化的内容，或者将他们带到App内的指定activity页面 (请查看本篇文章里的 deferred deep linking ).这会大幅提高用户与App的互动程度。

要从Android SDK获取AppsFlyer的转换数据，请执行 AppsFlyerConversionListener 。

import android.app.Application;
import com.appsflyer.AppsFlyerLib;
import com.appsflyer.AppsFlyerConversionListener;
import java.util.Map;
import android.util.Log;

public class AFApplication extends Application {
    private static final String AF_DEV_KEY = "qrdZGj123456789";

    @Override
    public void onCreate() {
        super.onCreate();
        AppsFlyerConversionListener conversionListener = new AppsFlyerConversionListener() {


            @Override
            public void onConversionDataSuccess(Map<String, Object> conversionData) {
            
                    for (String attrName : conversionData.keySet()) {
                    Log.d("LOG_TAG", "attribute: " + attrName + " = " + conversionData.get(attrName));
                }
            }

            @Override
            public void onConversionDataFail(String errorMessage) {
		   Log.d("LOG_TAG", "error getting conversion data: " + errorMessage);
            }

            @Override
            public void onAppOpenAttribution(Map<String, String> conversionData) {
            
                for (String attrName : conversionData.keySet()) {
                    Log.d("LOG_TAG", "attribute: " + attrName + " = " + conversionData.get(attrName));
                }

            }

            @Override
            public void onAttributionFailure(String errorMessage) {
                Log.d("LOG_TAG", "error onAttributionFailure : " + errorMessage);
            }
        };

        AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionListener, getApplicationContext());
        AppsFlyerLib.getInstance().start(this);
    }
}

import com.appsflyer.AppsFlyerConversionListener
import com.appsflyer.AppsFlyerLib
import com.appsflyer.AppsFlyerLibCore.LOG_TAG

class AFApplication : Application() {
    private val devKey = "qrdZGj123456789";

    override fun onCreate() {
        super.onCreate()
        val conversionDataListener  = object : AppsFlyerConversionListener{
            override fun onConversionDataSuccess(data: MutableMap<String, Any>?) {
                data?.let { cvData ->
                    cvData.map {
                        Log.i(LOG_TAG, "conversion_attribute:  ${it.key} = ${it.value}")
                    }
                }
            }

            override fun onConversionDataFail(error: String?) {
                Log.e(LOG_TAG, "error onAttributionFailure :  $error")
            }

            override fun onAppOpenAttribution(data: MutableMap<String, String>?) {
                data?.map {
                    Log.d(LOG_TAG, "onAppOpen_attribute: ${it.key} = ${it.value}")
                }
            }

            override fun onAttributionFailure(error: String?) {
                Log.e(LOG_TAG, "error onAttributionFailure :  $error")
            }
        }

        AppsFlyerLib.getInstance().init(devKey, conversionDataListener, applicationContext)
        AppsFlyerLib.getInstance().start(this)
    }
}

AppsFlyerConversionListener 接口中两个最重要的API是：

• onInstallConversionData 提供新安装的转化数据。注意： 从SDK Version 第5版开始， onConversionDataSuccess 是获取转化数据方法的名称。如果使用的SDK版本低于5.0.0，则该方法的名称为 onInstallConversionDataLoaded 。您需要将SDK升级到5.0.0版本要了解更多信息，请点击这里 。
• onAppOpenAttribution 在启动现有应用时（手动或通过深度链接）提供再营销的转化数据。

要了解有关转化数据的更多信息，请参见关于转化数据方案指南。

使用AppsFlyer，您可以归因第三方商店的Android应用安装。这样一来，您就可以在无法使用Google Play的市场中推广应用并触达更大的受众

关于第三方应用商店安装归因的详情，请参阅此处。

在预安装广告系列中，应用所有者可以要求设备制造商在设备出厂前预装他们的应用。

使用AppsFlyer可以轻松对预装应用进行归因。用户首次启动您的应用时，AppsFlyer会将安装归因给作为媒体渠道的设备制造商。

如需了解详情，请点击此处。

要了解如何设置卸载监测，请在 此处阅读.

如果要收到 AppsFlyer 服务器成功接收跟踪请求的确认, 则可以实现 Appsflyer TrackingRequestListener 侦听器。

The onRequestSuccess() 回掉 200 response to an attribution request made by the SDK.

onTrackingRequestFailure(String error) 会被调用, 如果响应作为错误字符串返回。

实施实例

AppsFlyerLib.getInstance().start(getApplicationContext(), "devKey", new AppsFlyerRequestListener() {
            @Override
            public void onSuccess() {
                Log.d(LOG_TAG, "Launch sent successfully, got 200 response code from server");
            }
            @Override
            public void onError(int i, @NonNull String s) {
                Log.d(LOG_TAG, "Launch failed to be sent:\n" +
                                "Error code: " + i + "\n"
                                + "Error description: " + s);
            }
        });

AppsFlyerLib.getInstance().start(this, "devKey", object : AppsFlyerRequestListener {
            override fun onSuccess() {
                Log.d(LOG_TAG, "Launch sent successfully")
            }
            override fun onError(errorCode: Int, errorDesc: String) {
                Log.d(LOG_TAG, "Launch failed to be sent:\n" +
                        "Error code: " + errorCode + "\n"
                        + "Error description: " + errorDesc)
            }
        })

如果在请求listener的期间事件发生错误，错误代码和字符串说明如下，请参考：

The setAdditionalData API is required to integrate on the SDK level with several external partner platforms, including Segment, Adobe, and Urban Airship.
Use this API only if the integration article of the platform specifically states setAdditionalData API is needed.

setAdditionalData 代码示例：

HashMap<String,Object> CustomDataMap = new HashMap<>();
CustomDataMap.put("custom_param_1","value_of_param_1");
AppsFlyerLib.getInstance().setAdditionalData(CustomDataMap);

val customDataMap = HashMap<String, Any>()
customDataMap.put("custom_param_1","value_of_param_1")
AppsFlyerLib.getInstance().setAdditionalData(customDataMap)

广告主使用通用链接进行深层链接（不使用OneLink）并且拥有 与该App相关的domain 可以使用 appendParametersToDeepLinkingURL 方法将通过此domain发起的会话归因于该domain。

例如：一个用户通过google搜索并点击了你的domain，www.example.com:

• 如果用户未安装应用程序，则将他们定向到网站（www.example.com）。
• 如果用户已经在其设备上安装了该应用程序，则他们将被深层链接到与www.example.com关联的应用程序。会话归因于appendParametersToDeepLinkingURL指定的媒体源（ pid参数）。

有关其他信息，请参见Android SDK参考。

注意：添加智能横幅以将网站访客转换为app用户。

默认情况下，在2次应用启动之间必须至少间隔 5秒，才能将其计为2次独立的应用启动 (更多有关应用启动计数的信息)。

使用以下API设置会话之间的最短时间：

appsflyerlib. setmintimemebetweensession (intseconds);

Setting a high value to the custom time between launches may badly impact APIs relying on session data, such as deep linking.

您可以使用此SDK方法报告新的用户会话。例如，这可能对于在后台运行的工具类应用很方便。

在活动的onCreate（）中使用此API：

public void logSession(Context context);

用法示例：

AppsFlyerLib.getInstance().logSession(context);

某些第三方服务，例如电子邮件服务提供商用他们自己的点击记录域名把链接包在电子邮件中。有些甚至允许您设置自己的点击记录域名。如果OneLink包在此类域名中，则可能会限制其功能。

要解决此问题，您可以使用 setResolveDeepLinkURLs API。使用此API从启动应用程序的点击域中获取OneLink。请确保在 SDK 初始化之前调用此 API。

For example, you have 3 click domains that redirect to your OneLink which is https://mysubdomain.onelink.me/abCD. Use this API to get the OneLink that your click domains redirect to. This API method receives a list of domains that the SDK resolves. Add the following code before SDK initialization.

AppsFlyerLib.getInstance().setResolveDeepLinkURLs("clickdomain.com", "myclickdomain.com", "anotherclickdomain.com");

The code above allows you to use your click domain while preserving OneLink functionality. The click domains are responsible for launching the app. The API, in turn, gets the OneLink from these click domains, then you can use the data from this OneLink to deep-link and customize user content.

借助AppsFlyer，您可以记录作为再营销广告重要部分的推送通知。

要启用此功能，请在点击通知后启动的每个活动的 onCreate 方法内调用 sendPushNotificationData ：

AppsFlyerLib.getInstance().sendPushNotificationData(this);

有关推送通知测量的更多信息，请参阅此处 。

允许您的现有用户邀请他们的朋友和联系人作为新用户加入应用，这可能是应用增长的关键因素。使用AppsFlyer，您可以在应用中归因和记录源自用户邀请的安装。

有关详细信息，请参见用户邀请归因文章 。

将为每个新增安装创建一个AppsFlyer ID。您可以将AppsFlyer ID用于多种用途：

• 发送服务器到服务器应用内事件 。
• 将AppsFlyer ID与您后台的用户记录进行匹配。
• Map entries when merging data from pull and push APIs.

使用以下API获取AppsFlyer ID：

public String getAppsFlyerUID(Context context);

使用示例：

String appsFlyerId = AppsFlyerLib.getInstance().getAppsFlyerUID(this);

要设置您的客户用户 ID：

public void setCustomerUserId(String id);

使用示例：

AppsFlyerLib.getInstance().setCustomerUserId("myId");

我们建议在应用流早期设置Customer User ID，因为它仅会关联设置之后上报的事件：

• 如果在调用 start 之前调用 setCustomerUserId ，则Customer User ID将出现在激活和应用内事件的原始数据报告中。
• If it is set after, the Customer User ID is only associated with events that are recorded after setting the Customer User ID.

获取客户用户 ID

为避免在首次启动后再次设置“Customer User ID”值，并减少向服务器请求Customer User ID的次数，可以使用以下方法检查其值是否为空：

AppsFlyerProperties.getInstance().getString(AppsFlyerProperties.APP_USER_ID)

了解客户用户 ID 的更多信息，请点击此处。

为 customerUserID 延迟 SDK 初始化

您可以延迟SDK初始化，直到设置了customerUserID。

指示 SDK 应延迟客户用户 ID 调用的初始化

AppsFlyerLib.getInstance().waitForCustomerUserId(true);

紧接 init () 方法之前。SDK 初始化的其他部分保持不变。

有了 customerUserID 之后 , 请调用

AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this);

为SDK提供相关的客户用户ID并启动SDK。

代码应如下所示：

public class AFApplication extends Application {
  private static final String AF_DEV_KEY = "qrdZGj123456789";
  @Override
  public void onCreate() {
    super.onCreate();
    AppsFlyerConversionListener conversionDataListener = 
    new AppsFlyerConversionListener() {
      ...
    };
    AppsFlyerLib.getInstance().waitForCustomerUserId(true);
    //WARNING! Removing above line doesn't cancel its effect.
    // Replace with this to stop waiting for CUID:
    // AppsFlyerLib.getInstance().waitForCustomerUserId(false);
    AppsFlyerLib.getInstance().init(AF_DEV_KEY, getConversionListener(), getApplicationContext());
    AppsFlyerLib.getInstance().start(this);
    // Do your magic to get the customerUserID
    // ...
    // any AppsFlyer SDK code invoked here will be discarded
   //Call the following API once the customerUserID is available:
 AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this);
  }
}

class AFApplication: Application() {
 private val afDevKey = ""

 override fun onCreate() {
  super.onCreate()
  val conversionDataListener = object: AppsFlyerConversionListener {
   ...
  }
  AppsFlyerLib.getInstance().waitForCustomerUserId(true);
  //WARNING! Removing above line doesn't cancel its effect.
  // Replace with this to stop waiting for CUID:
  // AppsFlyerLib.getInstance().waitForCustomerUserId(false);
  AppsFlyerLib.getInstance().init(afDevKey, conversionDataListener, this)
  AppsFlyerLib.getInstance().start(this)
  // Do your magic to get the customerUserID
  // ...
  // any AppsFlyer SDK code invoked here will be discarded
  // Call the following API once the customerUserID is available:
  AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this)
 }
}

要了解有关将SDK初始化延迟到客户用户ID可用之后的更多信息，请在此处 。

从 SDK 4.8.0 版起，AppsFlyer 自动采集 google_advertising_id。

采集 Google Advertising ID 的要求仅涵盖 SDK 4.7.X 及以下版本。

必须收集至少一个唯一标识符以进行归因。可获得以下标识符：GAID、Android ID、IMEI和OAID。

GAID-Google Advertising ID

从包含Google Play服务的应用中自动收集。如果GAID可用，则应用程序不应收集IMEI和Android ID，以避免违反Google Play政策 。

IMEI 和 Android ID

默认禁用。仅适用于不包含Google Play服务的应用。
注意： 从于2019年末发布的Android 10（API级别29） ，对IMEI参数的访问受到限制。

要将这些ID发送到AppsFlyer：

1. 在应用上打开，收集设备IMEI和/或Android ID。
2. 在使用start方法前，请调用以下API：
   

   AppsFlyerLib.getInstance().setImeiData("IMEI_HERE");
   AppsFlyerLib.getInstance().setAndroidIdData("ANDROID_ID_HERE");

OAID- 打开广告商标识符

OAID实施指南

选择退出设备ID收集

开发人员可以选择以下方式退出收集IMEI、Android ID和OAID：

AppsFlyerLib.getInstance().setCollectIMEI(false);
AppsFlyerLib.getInstance().setCollectAndroidID(false);
AppsFlyerLib.getInstance().setCollectOaid(false);

In some extreme cases, you might want to shut down all SDK logging due to legal and privacy compliance. This can be achieved with the stop API. Once this API is invoked, the SDK stops functioning and no longer communicates with AppsFlyer servers.

AppsFlyerLib.getInstance().stop(true, getApplicationContext());

AppsFlyerLib.getInstance().stop(true, applicationContext);

有几种不同的方案为用户选择退出。我们强烈建议您遵循与你的应用相关的方案的确切说明。

The SDK can be reactivated by calling:

AppsFlyerLib.getInstance().stop(false, getApplicationContext());
AppsFlyerLib.getInstance().start(getApplicationContext(), <AF_DEV_KEY>);

AppsFlyerLib.getInstance().stop(false, applicationContext);
AppsFlyerLib.getInstance().start(applicationContext, <AF_DEV_KEY>);

Do not call start if stop is set to true. You can check the current state of the SDK by calling:

AppsFlyerLib.getInstance().isStopped() // returns true if SDK is stopped, false otherwise

AppsFlyerLib.getInstance().isStopped // returns true if SDK is stopped, false otherwise

Use this API during the SDK Initialization to explicitly anonymize a user's install, events, and sessions:

public void anonymizeUser(boolean isDisabled);

使用示例：

AppsFlyerLib.getInstance().anonymizeUser(true);

可以将anonymizeUser设置为false来重新启动日志记录。

在某些情况下，广告主可能希望停止与媒体渠道/合作伙伴共享特定用户的用户级数据。其原因包括：

• 隐私政策，例如CCPA或GDPR
• 用户选择退出机制
• 与某些合作伙伴（媒体渠道，第三方）的竞争

AppsFlyer提供了两种API方法来停止与某些或所有合作伙伴共享数据：

• setSharingFilter: 广告主可以用来设置 一些 （一个或多个）媒体/对接合作伙伴 不能 获得数据。
• setSharingFilterForAllPartners: 广告主可以用来排除 所有 媒体/对接合作伙伴 获得数据。

从SDK V5.4.1开始支持这些过滤方法。

每次SDK初始化 ，都必须调用过滤方法 ，这会影响全部会话。如果需要时间确定是否需要设置sharing filters，请延迟SDK初始化 。