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:市场人员可在面板中完成测试(详情请见第三方安卓应用商店测试指南)。
  • PBA网页事件:需要市场人员和开发人员合作完成测试(详情请见PBA网页的SDK对接测试指南)。

如何测试基础的SDK功能

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

测试自然激活

建议您先测试自然激活。

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

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

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

Test_SDK_Organic_install

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

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

前期准备:

  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. 再营销部分下载转化(再互动及再归因)报告。