SDK对接测试（市场人员专用）

实时事件查看器（Live Event Viewer）是一种测试工具，显示从SDK发送到AppsFlyer的实时数据，包括激活以及应用内事件。查看器中抓取到的每个事件都带有事件日志和详情。

请按以下方式在实时事件查看器中查看事件：

1. 从AppsFlyer后台的侧边栏中选择配置 > SDK对接测试。

   

2. 点击实时事件。

   

3. 在应用列表中，选择您需要测试的应用。
4. 在测试设备列表中，选择同于测试相关应用的设备。若尚无测试设备，请点击添加测试设备链接，添加测试设备。
5. 点击继续，开始记录您的应用事件。

6. 打开应用并完成相关操作，生成应用打开事件（session）以及后续的应用内事件。

   

7. 点击所需事件，在右侧面板中查看该事件的详细信息。
8. 如需停止记录事件，则点击停止。如需继续记录事件，再次点击开始。

测试非自然激活的方式如下：

1. 从AppsFlyer后台的侧边栏中选择配置 > SDK对接测试。 

   

2. 点击非自然激活测试。

   

3. 在应用列表中，选择您需要测试的应用。
4. 在测试设备列表中，选择同于测试相关应用的设备。若尚无测试设备，请点击添加测试设备链接，添加测试设备。
5. 如果您的测试设备上已安装要测试的应用，请先将其删除。
6. 勾选已从测试设备中移除该应用的复选框。
7. 点击继续，然后按照向导工具的提示，完成各个步骤的操作。

如果该应用未记录到非自然激活，可能是由以下原因造成的：

• IDFA可用，但未在“测试设备”页用该ID注册测试机。
• 除了测试应用外，测试机上可能还安装了同一厂商的其他应用，但没有在“测试设备“页用IDFV注册该测试机。
• 记录到一次自然激活。
• 测试时下载的应用版本中未接入SDK。

如果对接本身有问题，请联系您的开发人员。

前期准备：

• 打开测试应用，至少重复3次。
• 您必须先为相关应用配置OneLink才能测试深度链接（再营销），详情请见OneLink配置指南。
• 请确认再营销开关已打开。

深度链接的测试方式如下：

1. 从AppsFlyer后台的侧边栏中选择配置 > SDK对接测试。

   

2. 点击再营销。

   

3. 在应用列表中，选择您需要测试的应用。
4. 在测试设备列表中，选择同于测试相关应用的设备。若尚无测试设备，请点击添加测试设备链接，添加测试设备。
5. 点击继续，然后按照向导工具的提示，完成各个步骤的操作。

测试激活是为了确认AppsFlyer的SDK能将激活正确归因到各种对应的渠道。

请按以下步骤测试激活归因：

1. 复制下图所示链接（分安卓和iOS），然后根据实际情况更改以下参数：

   1. app_id值：输入您的应用在AppsFlyer后台的应用ID。 
   2. pid参数：输入具体媒体渠道的名称，新增激活会被归因到这个渠道。
   3. c参数：输入广告系列的名称。
   4. 如果您测试的应用在第三方安卓应用商店上架，请在归因链接中添加af_r参数。 
   5. 将GAID、IDFA或IDFV改为具体的设备ID。
   Android iOS

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

   IDFA

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>

   IDFV

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfv=<IDFV>

   以下是带有具体值的归因链接示例：

   Android iOS

   https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*

   https://app.appsflyer.com/id123456789?pid=Test&c=Test&idfa=1A2B****-9128-4***-123*-04E***654321

    注意

   如果您不使用加白的测试设备对某款iOS应用进行测试，您在测试过程中完成的点击可能会被Protect360标记为假量。

   为了防止这些点击被识别为假量，请在您的链接中添加以下参数：pid=”ios_testing”。

2. 复制更改后的链接，将其发送到测试机，然后在测试机上点击该链接。

    注意

   在iOS系统中，需要使用iMessage或邮件将链接发送到测试机。请勿将链接复制粘贴到iOS记事本中再点击链接，否则会导致链接断裂。

3. 此时可完成以下任一操作：

   • 如果应用已上架，则直接下载激活。
   • 如果您的应用还处于待批（pending）状态，界面会显示以下消息：The app you are looking for is not available in the market yet.（您要查找的应用还未上架）。这是正常现象。由于该应用还未上线，因此归因链接不会将您引导到任何应用商店，但仍可以进行归因。此时请按以下方式激活该应用：
     • 安卓应用：使用APK文件（开发人员可以使用Android Studio）安装应用
     • iOS应用：从TestFlight下载（开发人员可从Xcode下载）

   您会看到在名为Test的渠道下，用于测试的广告系列获得了一个新增激活的归因。面板显示新增激活最多需要30分钟，请耐心等待。

   

测试应用内事件可验证事件对应的收入能正常显示到面板，且事件能归因到正确的渠道。

请按以下步骤测试应用内事件的归因：

1. 打开应用，然后完成数个应用内事件。

2. 打开该应用的面板，点击事件。

   正常情况下可看到事件及其关联的收入（若有）和渠道。事件显示到面板可能需要60-70分钟的时间，请耐心等待。

   

小贴士：建议您下载应用内事件原始数据报告，验证事件是否得到正确归因。下载过程可能需要数分钟。

报告下载方式如下：

1. 从AppsFlyer后台的侧边栏中选择报告>原始数据导出。
2. 在原始数据报告部分下载应用内事件原始数据报告。

您可以利用OneLink让您的安卓和iOS应用使用同一条归因链接。OneLink能识别用户的设备, 并让用户跳转到与其设备操作系统对应的应用商店。

此外, OneLink还支持深度链接功能。您可以通过深度链接让用户直接进入应用内的具体页面，同时为其提供定制化的内容。

详情请见OneLink链接测试指南。

当用户与再营销广告交互，并点击其归因链接时，就会触发再营销归因，进而形成一个再归因或再互动事件。详情请见再营销归因指南。

再营销测试包括以下两种：

• 测试再归因：卸载应用后重新下载并激活该应用，然后检查面板是否记录到一次激活。
• 测试再互动：点击再营销归因链接或深度链接，然后检查面板是否将再互动归因到正确的渠道。

在进行再营销测试前，请确保您已完成以下设置：

• 确保您已对测试应用开启了再营销功能。
• 创建该应用的专用链接或获取一条OneLink自定义链接，链接中必须包含再营销参数。

请按以下步骤进行再营销测试：

1. 在应用配置页打开再营销开关。

   点击应用面板中的应用配置，然后打开启用再营销归因的开关。

   

2. 此时可完成以下任一操作： 
   • 创建一条专用于测试应用的归因链接。确保该链接中包含再营销参数is_retargeting=true以及设备ID（advertising ID）。如需查看GAID、IDFA或IDFV，请按照测试设备加白说明完成操作。 
     以下示例中的归因链接带有安卓专用的设备ID（GAID）参数。如需了解其他的设备ID参数（如IDFA或IDFV），请参考归因链接的结构及参数。 

     https://app.appsflyer.com/<app_id>?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>

   • 从OneLink模板中获取自定义链接的长链。请确保再营销广告已激活。下图为自定义长链示例：

完成上述操作后，您就可以进行再归因和再互动测试了。

前期准备：

• 请根据相关说明设置再营销测试。
• 请确保您的测试机未经注册。

请按以下步骤测试再归因。

1. 从设备上卸载应用。如果您刚刚激活该应用，请等待数分钟再进行卸载。
2. 复制您先前创建的归因链接，可以是该应用专用的归因链接，也可以是OneLink模板中的自定义长链。将其发送到测试机，然后点击该链接。

    注意

   在iOS系统中，需要使用iMessage或邮件将链接发送到测试机。请勿将链接复制粘贴到iOS记事本中再点击链接，否则会导致链接断裂。

3. 此时可完成以下任一操作：
   • 如果应用已上架，则直接下载激活。
   • 如果应用仍处于待批（pending）状态，请按以下步骤激活应用：
     • 安卓应用：从Android Studio下载应用或下载APK文件，然后激活。
     • iOS应用：从TestFlight下载应用并激活。
4. 打开该应用的面板，然后在视图类型中选择再营销。

5. 在归因触点类型中选择再归因。

   您会看到该次激活被归因到了测试渠道和广告系列。再营销激活显示到面板上最多需要30分钟的时间，请耐心等待。

   

前期准备：

• 请根据相关说明设置再营销测试。 
• 为便于测试，请将转化之间的最短时间间隔设置为无。这样，面板就能记录到测试期间所有的再互动并对其归因。
• 确保您的测试机上已经安装了该应用，且已多次打开。如果您刚刚激活该应用，请等待数分钟再进行卸载。

请按以下步骤测试再互动（直接深度链接）：

请确保您的应用已经配置了深度链接，然后按照相关流程进行测试。

请按以下步骤测试再互动（间接深度链接）：

1. 复制您先前创建的归因链接，可以是该应用专属的归因链接，也可以是OneLink模板中的自定义长链。
2. 将链接发送至测试机，然后在测试机上点击该链接。

3. 请按以下任一方式打开该应用：

   • 在应用商店中点击打开。
   • 从设备端打开应用。

   面板会显示新增一次再互动，且该次再互动被归因到相应的渠道和广告系列。面板显示再互动最多需要30分钟时间，请耐心等待。

   

小贴士：您可以下载转化原始数据报告，检查该次再互动是否被归因到正确的渠道。下载过程可能需要数分钟。

报告下载方式如下：

1. 在AppsFlyer后台左侧的菜单栏中选择导出 > 原始数据导出。
2. 在再营销部分下载转化（再互动及再归因）报告。