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

有两种方法可以将SDK添加到您的应用中：

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

Android Install Referrer可提高归因准确性，防止安装欺诈等。从AppsFlyer Android SDK版本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" />
   <!-- Optional : -->
   <uses-permission android:name="android.permission.READ_PHONE_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至关重要。使用错误的dev key会影响从SDK发送的所有流量，并导致归因和报告问题。

获取您的dev key：

1. 转到应用控制面板。
2. 在控制面板的 配置 单击 应用设置 。
3. 复制您的dev key。
   
   

   

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

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

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

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

2. 在全局类内，设一个变量记录您的dev key，推荐命名为AF_DEV_KEY。
   
   重要：初始化SDK时，使用正确的dev key至关重要。使用错误的dev key会影响从SDK发送的所有流量，并导致归因和报告问题。
   
   
   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. 在全局类中，在 ConversionListener ，初始化SDK并调用 startTracking 方法
   
   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> 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().startTracking(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, applicationContext)
           AppsFlyerLib.getInstance().startTracking(this)
       }
   }
   

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

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

• APP.PACAKGE.NAME-用应用包名替换。
• AFApplication-用应用global class中设置的名称替换它。

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

在开始测试安装之前， 把测试设备加入白名单。

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

要模拟自然安装：

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。
2. 在下面的URL中，将<PACKAGE_NAME>替换为您的应用包名：
   

   https://app.appsflyer.com/<PACKAGE_NAME>?pid=sdk_test&c=sdk_test
   

   pid 参数代表媒体渠道名称。参数 c 表示广告系列名称。
3. 将此URL发送到设备。可以通过电子邮件或WhatsApp发送
4. 在设备上，单击URL。
   • 如果该应用已在应用商店上架，那您将跳转至应用商店。不要从应用商店下载并安装该应用。继续执行步骤5。
   • 如果该应用未在应用商店上架并且仍在开发中，则屏幕会显示‘在应用商店中找不到这个应用’。继续执行步骤5。
5. 在Android Studio中，打开Logcat。
6. 使用USB数据线将设备连接到计算机。
7. 通过Android Studio在设备上安装该应用。
8. 在Logcat中，查找该应用的包名。

您应该看到以下内容：

现在在应用的数据总览面板里可以看到一个非自然安装。

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

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

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

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

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

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

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

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

af_revenue 是AppsFlyer原始数据和控制面板上唯一统计为收入的事件参数。欲了解更多详情请点击这里 。

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

• 如果设置货币代码（请参见下面的示例），则该代码应为 3个字符的ISO 4217代码 。(默认值为美元)。
• 您可以通过调用以下方法为所有事件设置货币代码： AppsFlyer.setCurrencyCode（ " ZZZ " ） 要了解有关货币设置、显示和货币换算的信息，请参见我们的收入货币指南。
• 收入值不应包含逗号、货币符号或文本。例如，收入事件应类似于 1234.56。

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

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().trackEvent(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().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue)

上面的购买事件具有与之相关的收入$ 1234.56，在控制面板上显示为收入。

记录负收入

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

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

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().trackEvent(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().trackEvent(applicationContext,  "cancel_purchase", eventValue)

AppsFlyer的SDK为应用内购买事件提供服务器验证服务。要验证购买事件，请调用 validateAndTrackInAppPurchase 。

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

public static void validateAndTrackInAppPurchase(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().validateAndTrackInAppPurchase(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().validateAndTrackInAppPurchase(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都支持非英语字符。

您可以通过调用 trackEvent 来记录应用内事件的名称和参数值。有关更多详细信息，请参见应用内事件文档。

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

示例：应用内购买活动

Map<String,Object> eventValues = new HashMap<>();
eventValues.put(AFInAppEventParameterName.REVENUE, 1200);
eventValues.put(AFInAppEventParameterName.CURRENCY, "JPY");
eventValues.put(AFInAppEventParameterName.CONTENT_TYPE, "Shoes");
AppsFlyerLib.getInstance().trackEvent(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().trackEvent(this, AFInAppEventType.PURCHASE, eventValues)

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

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

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

• 应用内事件已成功记录。
• 记录应用内事件时发生错误。

AppsFlyerLib.getInstance().trackEvent(getApplicationContext(), AFInAppEventType.PURCHASE, eventValue, new AppsFlyerTrackingRequestListener() {
      @Override
      public void onTrackingRequestSuccess() {
        Log.d(AppsFlyerLibCore.LOG_TAG, "onTrackingRequestSuccess");
      }
      @Override
      public void onTrackingRequestFailure(String error) {
        Log.d(AppsFlyerLibCore.LOG_TAG, "onTrackingRequestFailure: " + error);
      }
 });

AppsFlyerLib.getInstance().trackEvent(this@MainActivity, AFInAppEventType.PURCHASE, emptyMap(), object : AppsFlyerTrackingRequestListener{
    override fun onTrackingRequestSuccess() {
       Log.d(AppsFlyerLibCore.LOG_TAG, "onTrackingRequestSuccess")
    
    override fun onTrackingRequestFailure(error: String) {
       Log.d(AppsFlyerLibCore.LOG_TAG, "onTrackingRequestFailure called: $error")
    }
})

OneLink在设备点击时检测到设备类型，并将用户重定向到匹配的目的地，例如Google Play商店、iOS应用商店、第三方应用商店、或者网页。

OneLink重定向指南讨论了如何实现多平台归因链接（无需SDK编码）。这也是深层链接的基础。

深度链接使您可以将用户发送到特定活动，并为他们提供自定义内容。该功能在运行再营销广告系列时特别有用。

要运用OneLink进行深度链接， 有权访问AppsFlyer控制面板的市场营销人员和有权访问该应用的开发人员必须共同合作 。

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

延迟深度链接可以深度链接新用户，并在他们安装应用后为其展示自定义内容。这不同于常规的深度链接，在常规深度链接中，应用必须已经安装在用户设备上。

要用OneLink实现延迟深度链接，开发人员需要有访问AppsFlyer控制面板的权限。

延迟深度链接的设置与深度链接相同。唯一的区别是，您需要在应用中实现其他逻辑，以便在用户安装和启动应用后将他们深度链接到自定义内容。

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

在每次安装或深度链接发生后，SDK都会为您提供转化或互动数据。您可以使用此数据并配置代码逻辑来触发自定义内容或应用内的特定活动

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

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

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

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

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

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

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

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

对于 SDK 发出的归因请求的每200个响应, 就会调用 onTrackingrequest

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

实施实例

AppsFlyerLib.getInstance().startTracking(this.getApplication(),"devKey", myListener());
private AppsFlyerTrackingRequestListener myListener() {  
  return new AppsFlyerTrackingRequestListener() { 
    @Override public void onTrackingRequestSuccess() { 
      Log.d("Debug", "Got 200 response from server");  
    }  @Override public void onTrackingRequestFailure(String error) { 
      Log.d("Debug", error); 
      }  
    }; 
  }

AppsFlyerLib.getInstance().startTracking(this,"devKey", myListener())
private fun myListener() : AppsFlyerTrackingRequestListener{
   return object : AppsFlyerTrackingRequestListener{
      override fun onTrackingRequestSuccess() {
      Log.d("Debug", "Got 200 response from server");
   }
   override fun onTrackingRequestFailure(error: String?) {
     Log.d("Debug", error);
   }
  }
}

setAdditionalData API 需要在 SDK 级别与若干外部合作伙伴平台对接，包括 Segment、Adobe 和 Urban Airship。仅在平台对接文章明确说明需要 setAdditionalData API 时，才使用该 API。

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)

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

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

appsflyerlib. setmintimemebetweensession (intseconds);

将两次启动之间的自定义时间设置为高值 可能严重影响依赖会话数据的API （例如深度链接） 。

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

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

public void reportTrackSession(Context context);

用法示例：

AppsFlyerLib.getInstance().reportTrackSession(context);

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

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

例如，您有三个点击域重定向到您的OneLink，即https://mysubdomain.onelink.me/abCD。使用此API获取您点击域重定向到的OneLink。此API方法接收SDK解析的域列表。在SDK初始化之前添加以下代码。

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

上面的代码使您可以在保留OneLink功能的同时使用点击域名。点击域名负责启动应用。该API会从这些点击域名中获取OneLink，然后您可以使用此OneLink中的数据进行深度链接和自定义用户内容。

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

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

AppsFlyerLib.getInstance().sendPushNotificationData(this);

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

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

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

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

• 发送服务器到服务器应用内事件 。
• 将AppsFlyer ID与您后台的用户记录进行匹配。
• 合并 pull 和 push API时映射条目。

使用以下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，因为它仅会关联设置之后上报的事件：

• 如果在调用 startTracking 之前调用 setCustomerUserId ，则Customer User ID将出现在安装和应用内事件的原始数据报告中。
• 如果在此之后设置，则“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().setCustomerIdAndTrack("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); 
    AppsFlyerLib.getInstance().init(AF_DEV_KEY, getConversionListener(), getApplicationContext());
    AppsFlyerLib.getInstance().startTracking(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().setCustomerIdAndTrack("customer_id", this);
  }
}

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

 override fun onCreate() {
  super.onCreate()
  val conversionDataListener = object: AppsFlyerConversionListener {
   ...
  }
  AppsFlyerLib.getInstance().waitForCustomerUserId(true);
  AppsFlyerLib.getInstance().init(afDevKey, conversionDataListener, this)
  AppsFlyerLib.getInstance().startTracking(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().setCustomerIdAndTrack("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. 在调用 startTracking 方法之前，请调用以下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);

在某些极端情况下，您可能出于法律和隐私合规方面的考虑，希望关闭所有 SDK 追踪。这可以通过 isStopTracking API 来实现。调用此API后，SDK将停止运行，并且不再与AppsFlyer服务器通信。

AppsFlyerLib.getInstance().stopTracking(true,context);

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

在任何情况下，可调用相同 API 以重新激活 SDK，但会传递 False。

AppsFlyerLib.getInstance().startTracking(getApplicationContext(), AF_DEV_KEY);

在 SDK 初始化过程中，使用该 API 明确匿名用户安装、事件和互动：

public void setDeviceTrackingDisabled(boolean isDisabled);

使用示例：

AppsFlyerLib.getInstance().setDeviceTrackingDisabled(true);

可以把调用 deviceTrackingDisabled 设置为 false 来重新启动归因。