测试设备加白

概要:进行归因测试时,您需要先为您的测试设备加白,才能让AF后台将每次激活都记录为新增激活。测试设备加白后,重复激活应用不会被AF判定为重装激活。

测试设备加白的目的

开展归因测试时,再归因窗口期会限制激活归因的次数,每90天内仅记录一次激活。因此,如果您使用同一设备反复测试激活归因,就记录不到任何内容。这种情况下,您就需要将您的测试设备加白。加白后的测试设备反复完成激活时,这些激活不会被判定为重装激活。

测试设备加白方式

为测试设备加白时,您需要选择设备操作系统(安卓、iOS或Windows)并添加设备标识符。

您可以使用以下任一方式对设备加白:

  • 下载并安装名为“My Device ID by AppsFlyer”的应用:您在测试设备上安装该应用后,设备就会自动加白,并向您的AppsFlyer账户发送设备ID信息。该设备会被自动列入测试设备页面。

     注意

    如果您使用iOS 14+的测试设备,则上述加白方式仅适用于添加了ATT授权弹窗的应用,且在测试时需要在弹窗中勾选“允许”,授权广告跟踪。如果您的测试场景不符合这些条件,请使用手动方式完成设备加白。

  • 手动添加测试设备:您账户下的任何用户都可以直接在测试设备页面中添加相关设备的标识符,从而完成设备加白。

注意事项:

  • 已加白的测试设备可用于相关账户下的所有应用。
  • 广告平台如需添加设备需要让广告主完成相关操作;代理则可以自行添加测试设备。

适用的设备标识符

适用的设备标识符包括以下几种:

  • 安卓:AID(GAID或OAID)、IMEI、Android ID

     注意

    为测试设备加白时,建议仅在相关应用收集并使用IMEI或Android ID的情况下添加这些设备标识符。

  • iOS:IDFA、IDFV
  • Windows Phone:Windows advertising ID

管理测试设备加白

通过AppsFlyer的设备ID应用为测试设备加白

请通过以下方式下载AppsFlyer的设备ID应用:

  1. 扫描以下二维码(Google Play Store)或点击二维码下方的链接,下载并安装该应用。
    Android iOS Windows
  2. 如果您想要收集iOS 14.5+设备的IDFA,请在界面弹出ATT授权弹窗时点击允许

  3. 在安卓/iOS/Windows界面中点击Register,为测试设备加白。
    Android iOS Windows

  4. 输入您的AppsFlyer登录凭证。设备加白完毕。
  5. 点击Share details,与AF账户共享设备ID信息。

测试设备手动加白

相关账户下的用户可以手动为测试设备加白:

  1. 从AppsFlyer后台的侧边栏中选择配置 > 测试设备
  2. 选择测试设备
  3. 点击+添加设备

  4. 请完成以下操作:
    • 名称(仅限英文字母):输入一个具有唯一性的设备名称,用于识别该设备。
    • 操作系统:选择设备的操作系统。
    • 设备ID类型:选择一种设备标识符。
    • 设备ID:根据设备的操作系统输入相对应的设备ID:
      iOS安卓Windows

      IDFA或IDFV的获取方式如下:

      • IDFA:如需获取IDFA,请在您的测试设备上安装AppsFlyer的设备ID应用。具体操作:见上文“通过AppsFlyer设备ID应用添加设备(仅限账户管理员)”部分。
      • IDFV:如需获取IDFV,请让您的开发人员在您的测试设备上安装IDFV测试工具应用。安装并激活该工具应用后,界面会显示该设备的IDFV。请注意:开发人员必须先在X-Code中完成前期准备后方可安装该测试工具。

      如需了解IDFA或IDFV的使用场景,请参见为iOS测试设备加白部分。

  5. 点击保存。该设备会出现在已加白设备的列表中。请注意:虽然该设备会立即出现在已加白设备的列表中,但可能需要等待几分钟才能正式录入系统并正常使用。

 注意

添加多个标识符

在某些情况下(比如要在同一个设备上同时收集IDFA和IDFV),您可能需要为一个测试设备添加多个标识符。

请按以下步骤添加其他标识符:

  1. 点击 添加设备
  2. 使用同一个测试设备名称,添加第2个标识符。
  3. 点击保存

 

注销测试设备

每个账户下最多可加白200个设备。仅限账户管理员可删除测试设备。

请按以下步骤从列表中删除设备:

  1. 进入AF后台,点击右上角的邮箱地址。
  2. 选择测试设备
  3. 点击删除图标,即可注销设备。

为iOS测试设备加白

以下流程图展示了iOS测试设备加白时会出现的几种路径。

为iOS测试设备加白时,请从以下几种方式中选择一种:

使用IDFA为测试设备加白

何种情况下需要使用IDFA为测试设备加白?

如果您的应用中使用了AppTransparency Tracking(即ATT弹窗),而且您想要测试授权用户的归因,可以使用IDFA为测试设备加白。在测试过程中首次打开相关应用时,请确保在ATT弹窗中点击允许

如何使用IDFA为测试设备加白?

如需使用IDFA,请通过AppsFlyer的设备ID应用为测试设备加白。

使用IDFV为测试设备加白

何种情况下需要使用IDFV为测试设备加白?

当IDFA无法访问时,IDFV是唯一的可选方案。在以下场景中,您必须使用IDFV

  • 相关应用中使用了ATT弹窗,但您想要测试不授权用户的归因。在测试过程中首次打开相关应用时,请确保在ATT弹窗中点击要求App不跟踪
  • 相关应用中没有添加ATT弹窗

使用IDFV为测试设备加白的方法

  1. 使用IDFV为测试设备加白之前,必须先让您的开发人员在测试设备上安装IDFV测试工具应用。您可以让开发人员参考此文档,查看相关说明。
  2. IDFV测试工具应用安装完毕后,请将其打开,并复制界面中显示的IDFV。
  3. 使用该IDFV手动为测试设备加白

 注意

为何要安装IDFV测试工具应用?

  • IDFV测试工具的用途是提取测试设备的IDFV,帮助您完成加白流程。
  • 如果测试设备中没有安装您开发者账户下的其他应用,则您每次重装并激活相关应用时,iOS系统都会为该设备生成一个新的IDFV。一般情况下,测试过程中需要完成多次重装激活,而每次重装激活都会触发iOS重置测试设备的IDFV。这时,该测试工具可以假装成同厂商的应用,防止iOS在每次发生重装激活时重新生成IDFV。

使用未加白的设备进行测试

建议您仅在无法通过IDFA或IDFV为测试设备加白时,才使用这一方法。在这种情况下,AF会使用概率模型进行归因。测试设备上的每一次激活都会被记录为新增激活。如果出现以下任一情况,该方法可以帮助您记录测试过程中在同一个设备上完成的重复激活:

  • AppsFlyer iOS SDK版本为v6.8.0或更低。
  • 相关应用禁用了重装激活识别(不建议已上架的应用使用该设置)。
  • 如果测试归因链接中包含is_retargeting="true",则相关激活会被记录为再归因,且会呈现在再营销面板和再营销原始数据报告中。
  • 仅适用于iOS:测试时为了避免Protect360将点击标记为假量,请在您的测试归因链接中添加查询参数pid="ios_testing"