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

推荐用于
营销人员
最近更新：

概要：本文重点讲解了如何测试安卓或iOS端与AppsFlyer的SDK对接。

概述

SDK对接完成后需经过一系列测试，才能确保数据收集的准确性和完整性。SDK对接测试的内容包括确认SDK与AppsFlyer的服务器连接正常，且激活、应用内事件以及再营销能得到正确的记录和归因。

基础对接完成后，任何具有AppsFlyer面板权限的团队成员都能进行基础测试。开发人员则可以利用开发环境中的调试日志进行测试。

本文重点说明面板中的测试流程，并包含了测试相关的开发者文档链接，可供开发人员参考。

测试方法

以下章节说明了SDK对接测试的各项内容以及可用的测试方法。

在面板中进行测试

您需要先注册一个测试机（安卓或iOS），才能在面板中测试SDK对接。这样您就可以使用同一个设备反复完成激活，这些激活不会被记录为重装激活。

请完成以下操作：

  • 测试自然激活。
  • 测试基础的对接功能（非自然激活、应用内事件和再营销）。您可选用以下几种方法进行测试：
    • SDK接入测试页面：这是AppsFlyer面板中的测试助手工具，可引导您完成各项测试内容。
    • 通过归因链接进行测试：所有在非SRN广告平台和自有媒体上投放的广告都需要通过AppsFlyer的归因链接来收集数据，因此建议您使用归因链接进行测试。创建归因链接后，您就可以测试SDK是否能将非自然激活和应用内事件正确地归因到相应的渠道。此外，您还可以测试再营销（再归因及再互动）的记录和归因是否正常。

iOS 14+的测试注意事项

从iOS 14.5开始，广告主需要通过ATT弹窗获取用户授权后才能读取其IDFA。如果您的应用中添加了ATT弹窗，就可以分别测试授权用户和不授权用户的数据收集，具体方法请参考相关指南，了解如何用IDFA或IDFV注册测试机。

如何在开发环境中进行测试

开发人员可完成以下操作：

  • 启用并检查调试日志，测试购买验证、转化数据、深度链接等场景。

     注意

    如果您使用的是Zero基础套餐，那么开发人员会在日志中收到403错误代码。这是因为该套餐不包括归因数据，仅提供点击和展示数据。如需进一步了解AppsFlyer的各种产品套餐，请发送邮件至hello@appsflyer.com联系我们的CEM团队，或查阅AppsFlyer产品定价。

  • 创建调试应用（debug app），测试SDK对接。测试时面板会记录并显示数据，数据一经记录便无法删除。如果您不想让测试数据在正式生产（Production）环境中作为应用的一部分被记录下来，可以让开发人员使用调试应用来测试SDK对接。调试应用有别于Production环境的应用，具有不同的AppsFlyer应用ID以及独立的面板，且不会在应用商店上架。

如何将调试应用添加到后台

开发人员创建了调试应用后，您需要将该应用添加到AF后台。这样，在开发人员使用调试应用进行测试时，记录到的数据就会显示在调试应用的面板上。

请根据实际情况选择对应的流程，添加调试应用：

添加调试应用（安卓） 添加调试应用（iOS）

请按以下步骤将调试应用添加到后台：

  1. 让开发人员提供调试应用的包名，然后将该应用添加到您的AppsFlyer后台。
  2. 将应用状态设置为以下任意一种：
    • 待审核（Pending approval）
    • 未发布

特殊测试场景

特殊测试场景包括以下几种：

  • Android TV：AppsFlyer的SDK适用于搭载安卓系统的智能电视。市场人员或任何团队成员都可按下文流程测试这类电视应用。
  • Apple TV（tvOS）：AppsFlyer的SDK适用于Apple TV（tvOS）。市场人员或任何团队成员都可按下文流程测试这类电视应用。
  • 未上架的tvOS应用：需要市场人员和开发人员合作完成测试（详情请见应用上架前的tvOS对接测试指南）。
  • Amazon Fire TV：营销人员可以通过AppsFlyer面板中的安卓SDK测试方式来测试对接。详情请见Amazon Fire TV归因说明。
  • PBA网页事件：需要市场人员和开发人员合作完成测试（详情请见PBA网页的SDK对接测试指南）。

如何测试基础的SDK功能

以下章节讲解了基础SDK对接测试的流程。

测试自然激活

建议您先测试自然激活。

请按以下步骤测试自然激活：

  1. 在已注册的测试机上激活应用。
  2. 打开应用。

该应用的面板上会显示一个新增自然激活。自然激活的数据更新最多会有30分钟的延时，请耐心等待。

Test_SDK_Organic_install

通过SDK接入测试页面进行测试

您可以在SDK接入测试页面中测试非自然激活、应用内事件及深度链接（再营销），找出对接中存在的问题。

仅适用于iOS：SDK对接测试页面仅适用于启用了ATT弹窗的iOS应用。如需测试无ATT弹窗的应用，请参考此文档中的具体流程。

前期准备：

  1. 准备一部未安装相关应用的设备（安卓或iOS）。如果您要使用的设备上已经安装了相关应用，请先将其卸载。
  2. 将该设备注册为测试机。

第1步：测试非自然激活

  1. 在面板中选择该应用。
  2. 点击面板左侧菜单的SDK接入测试。
    进入SDK接入测试页面。
  3. 完成非自然激活测试流程。
  4. 选择一部测试机。
  5. 选择应用商店，作为应用激活的来源：
    • 安卓应用商店包括：
      • Google Play
      • 其他（如第三方应用商店、Android Studio、APK文件等）
    • iOS应用商店包括：
      • 应用商店
      • 其他（如XCode、TestFlight等）
  6. 用已注册的测试机扫描二维码，并根据设备上显示的指引提示进行操作。

    请注意：在安卓设备上，该测试方法是通过referrer（激活来源标识）来收集数据的，因此归因链接中不包含GAID。

  7. 如果您选择了其他，就必须从开发环境中下载相关应用。
  8. 等到SDK接入测试页面中记录到该次非自然激活，就表示测试顺利完成。该过程最多会有2分钟的延时。

    NonOrganic_install

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

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

第2步：测试应用内事件

前期准备：

  • 需使用之前用于记录非自然激活的测试机来完成这部分流程。
  1. 完成应用内事件测试流程。
  2. 选择一部测试机，然后点击下一步。
  3. 打开应用并在应用内进行各种操作以生成应用内事件。
  4. 这些事件会被实时记录到事件日志中。

    Test_SDK_Integration_Inapp_events

第3步：测试深度链接（再营销）

前期准备：

  • 需使用之前用于记录非自然激活的测试机来完成这部分流程。
  • 打开测试应用，至少重复3次。
  • 您必须先为相关应用配置OneLink才能测试深度链接（再营销），详情请见OneLink配置指南。
  • 请确认再营销开关已打开。
  1. 完成深度链接测试流程。
  2. 选择一部测试机。
  3. 选择测试类型：
    • OneLink:：选择要用于测试的OneLink。
    • URI Scheme：输入相关的URI scheme（如：greatapps://cars）。
  4. 点击下一步。
  5. 用已注册的测试机扫描二维码，并按照设备上显示的说明进行操作。测试完成后，后台会记录深度链接测试已完成。

    TestSDK_DeepLinks_en-us.png

通过归因链接进行测试

以下章节说明了如何通过归因链接来测试激活。即使您的应用还处于待批（pending）状态（即还未在Google Play Store或Apple App Store正式上架），仍可以完成这些测试。

测试激活归因

测试激活是为了确认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>

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

    Android iOS 

    https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*
  2. 复制更改后的链接，将其发送到测试机，然后在测试机上点击该链接。

     注意

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

  3. 请完成以下任一操作：
    • 如果应用已上架，则直接下载激活。
    • 如果应用仍处于待批状态，界面会显示以下消息：“The app you are looking for is not available in the market yet.”（您要查找的应用还未上市），这是正常的。由于应用还未上线，因此归因链接无法跳转到任何应用商店，但仍能完成归因流程。请按以下方法激活应用：
      • 安卓应用：下载APK文件（开发人员可从Android Studio下载）
      • iOS应用：从TestFlight下载（开发人员可从Xcode下载）

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

 提示

您还可以使用以下方法来验证测试结果：

  • 如果您有原始数据报告的权限，可下载激活原始数据报告，下载过程可能需要数分钟。

    报告下载方式如下：

    1. 从面板进入报告 > 导出数据。
    2. 点击用户获取（非自然）列表中的激活，然后下载报告。
  • 如果您有调试日志的权限，可使用SDK对接测试API来拉取某个具体激活的归因结果。

测试应用内事件归因

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

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

  1. 打开应用，然后完成数个应用内事件。
  2. 打开该应用的面板，点击事件。

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

    Testing_InAppEvents_Attribution

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

报告下载方式如下：

  1. 从面板进入报告 > 导出数据。
  2. 在原始数据报告部分下载应用内事件原始数据报告。

测试OneLink

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

此外, 您还可以使用OneLink实现深度链接。这样，您就能在投放个性化广告的同时，让用户通过广告互动进入应用中的具体页面。

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

通过归因链接测试再营销

以下章节说明了再营销归因的测试流程。

再营销归因测试简介

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

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

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

进行再营销测试前的准备工作

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

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

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

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

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

    Set_Reattribution_window

  2. 根据实际情况选择并完成相应操作：
    • 创建一条专用于测试应用的归因链接。请确保该链接中包含再营销参数（is_retargeting=true）以及广告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模板中获取自定义链接的长链。请确保再营销广告已激活。下图为自定义长链示例：

      Testing_LongLink_en-us.png

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

测试再归因

前期准备：

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

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

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

     注意

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

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

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

    Testing_SDK_Reattribution

 提示

您还可以使用以下方法来验证测试结果：

  • 如果您有原始数据报告的权限，可下载转化原始数据报告。下载过程可能需要数分钟。

    报告下载方式如下：

    1. 从面板进入报告 > 导出数据。
    2. 点击再营销列表中的转化（再互动与再归因），然后下载报告。
  • 如果您有调试日志的权限，可使用SDK对接测试API来拉取某个具体激活的归因结果。

测试再互动

前期准备：

  • 请根据相关说明设置再营销测试。
  • 为便于测试，请将转化之间的最短时间间隔设置为无。这样，面板就能记录到测试期间所有的再互动并对其归因。

    Testing_Reattribution_window

  • 确保您的测试机上已经安装了该应用，且已多次打开。如果您刚刚激活该应用，请等待数分钟再进行卸载。

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

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

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

  1. 复制您先前创建的归因链接，可以是该应用专属的归因链接，也可以是OneLink模板中的自定义长链。
  2. 将链接发送至测试机，然后在测试机上点击该链接。
  3. 请按以下任一方式打开该应用：
    • 在应用商店中点击打开。
    • 从设备端打开应用。

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

    Testing_SDK_Re-engagement

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

报告下载方式如下：

  1. 从面板进入报告 > 导出数据。
  2. 在再营销部分下载转化（再互动及再归因）报告。

另请参见