(3)、注册该global application class
在AndroidManifest.xml文件的application
标签内,添加以下行:
android:name="APP.PACKAGE.NAME.AFApplication"
- APP.PACAKGE.NAME-用应用包名替换。
- AFApplication-用应用global class中设置的名称替换它
manifest.xml中的这一行告诉应用程序什么是全局应用程序。如上所述,这样做使AppsFlyer SDK可以在整个应用程序中全局访问。
4、测试安装
(1)、将设备加入白名单
将设备列入白名单可让您多次使用同一设备进行安装归因测试。本文介绍如何通过添加和删除设备来管理白名单。
在执行归因测试时,“重新归因”窗口会将安装归因限制为每90天窗口一次。因此,如果您反复使用同一设备测试安装归因,则不会记录任何内容。通过将设备列入白名单可以解决此问题。
以下作为参考
- 白名单测试设备会忽略重新归因规则
- 白名单中的设备适用于帐户中的所有应用
- 广告平台和代理商需要要求广告主添加设备
- 每个帐户最多可以将40台设备列入白名单
- 只有管理员可以删除设备
管理白名单
通过添加和删除设备来管理您的白名单。
有两种方法可以将设备添加到白名单。
要下载AppsFlyer设备ID应用程序:
- 使用二维码(Google Play商店)或提供的链接之一下载并安装该应用。
Android iOS Windows
- 在Android / iOS / Windows屏幕上,点击白名单按钮。
- 输入您的AppsFlyer登录凭证。该设备现已列入白名单。
- 点击共享以使用系统共享对话框共享设备ID信息。
通过用户界面手动添加设备
团队成员可以手动将设备标识符添加到测试设备列表中。
将设备添加到白名单:
- 在AppsFlyer中,单击您的电子邮件地址会有下拉列表。
- 选择测试设备 。 将打开“测试设备”页面。
- 点击 Add device
- 根据需要完成:
- 操作系统:选择一个操作系统。
- 名称(仅使用英文字母):输入设备的标识名。
- 标识符:根据操作系统(OS)提供设备标识符:Android iOS Windows使用AppsFlyer设备ID应用获取设备标识符通过将代码拨入设备或使用链接来获取标识符:
- IMEI
#06# - 安卓ID
##8255## (可能不适用于更新的设备) - Google Ad ID
获取Google Advertising ID
(2)、模拟自然安装
自然安装是未被归因的安装,通常是直接前往应用商店安装的用户。
要模拟自然安装:
- 确保已将移动设备连接到计算机。
- 在Android Studio中,打开Logcat。
- 在Android Studio中,将应用安装到设备或模拟器上。
- 等待应用启动。
- 在Logcat中,查找该应用的包名。
您应该看到以下内容:
屏幕截图中突出显示的部分表示SDK报告了自然安装。此数据来自AFApplication类中的onConversionDataSuccess
方法。
注意: 从SDK Version5开始, onConversionDataSuccess
是获取转换数据的方法的名称。如果使用的SDK版本低于5.0.0,则该方法的名称为onInstallConversionDataLoaded
。
(3)、模拟非自然安装
非自然安装通常是在广告互动之后的可归因安装。您可以使用归因链接模拟非自然安装。
模拟非自然安装:
- 在manifest中,找出您的应用包名,例如com.company.app。
- 在下面的URL中,将替换为您的应用包名:
https://app.appsflyer.com/?pid=sdk_test&c=sdk_test
参数 pid 代表媒体渠道名称。
参数 c 表示广告系列名称。- 将此URL发送到设备。可以通过电子邮件或WhatsApp发送
- 在设备上,单击URL。
- 如果该应用已在应用商店上架,那您将跳转至应用商店。不要从应用商店下载并安装该应用。继续执行步骤5。
- 如果该应用未在应用商店上架并且仍在开发中,则屏幕会显示‘在应用商店中找不到这个应用’。继续执行步骤5。
- 在Android Studio中,打开Logcat。
- 使用USB数据线将设备连接到计算机。
- 通过Android Studio在设备上安装该应用。
- 在Logcat中,查找该应用的包名。
您应该看到以下内容:
三、集成SDK常见问题
1、ProGuard警告
如果您使用的是ProGuard,并且遇到有关我们的 AFKeystoreWrapper
类的警告,则将以下代码添加到ProGuard规则文件中:
-keep class com.appsflyer.** { *; }
2、备份规则
如果您在AndroidManifest.xml的标签内添加android:fullBackupContent="true"
,您可能会收到错误提示:
Manifest merger failed : Attribute application@fullBackupContent value=(true)
要解决此错误,请在AndroidManifest.xml文件的标签中添加 tools:replace="android:fullBackupContent
。
如果您指定了自己的备份规则,请通过添加以下规则将它们与AppsFlyer规则手动合并:
<full-backup-content> ...//your custom rules <exclude domain="sharedpref" path="appsflyer-data"/> </full-backup-content>
3、缺少资源文件
如果您使用的Android SDK 为5.0.0或更高版本,请确保在APK中,除了 classes.dex 和 resources 文件外,您的文件夹 com > appsflyer > internal 中同样包含文件 a. 和 b. 。
如果这些文件丢失,则SDK无法向我们的服务器发出网络请求。
在Android Studio中打开您的APK来检查您是否有必须的文件。
请参阅以下屏幕截图以供参考。