测试 V3 客户获取

此信息可帮助您对 Android 设备上的版本 3 客户获取促销活动链接进行往返测试。

重要

V3 中的客户获取是指您在 Adobe Mobile Services 用户界面中通过客户获取生成器创建的客户获取链接。要使用此项功能,您必须升级到适用于 Experience Cloud 解决方案 4.6.0 或更高版本的 Android SDK 4.x。

如果 Google Play 中尚未提供移动设备应用程序,则在创建促销活动链接时,您可以选择任意移动设备应用程序作为目标。这仅会影响在您单击客户获取链接后,客户获取服务器将您重定向到的应用程序,但不会影响测试链接的功能。查询字符串参数将传递到 Google Play 应用商店,并作为促销活动广播的一部分传递到正在安装的应用程序。往返移动设备应用程序客户获取测试需要模拟此类广播。

重要

如果您使用 Google Play Install Referrer API 来实施,则在将该应用程序置于 Google Play 商店中之前,无法测试客户获取。

每次运行测试时,必须全新安装应用程序,或清除​设置​中的数据。这可以确保在首次启动应用程序时发送与促销活动查询字符串参数关联的初始生命周期量度。

  1. 完成移动设备应用程序客户获取中的先决任务,并确保已正确实现了 INSTALL_REFERRER 的广播接收器。

  2. 在 Adobe Mobile Services 用户界面中,单击​客户获取 > 营销链接生成器,并生成一个客户获取营销链接 URL,以将 Google Play 设置为 Android 设备的目标。

    有关更多信息,请参阅营销链接生成器

    例如:https://c00.adobe.com/v3/<appid>/start?a_i_id=iostestapp&a_g_id=com.adobe.android&a_dd=g&ctxa.referrer.campaign.name=name&ctxa.referrer.campaign.trackingcode=trackingcode

    小贴士

    如果您在客户获取链接中同时引用 Android 和 iOS 应用程序,请使用 Google Play 作为默认商店。

  3. 在桌面浏览器中打开生成的链接。

    您应会被重定向到 URL 与以下示例类似的页面:
    https://play.google.com/store/apps/details?id=com.adobe.android&referrer=utm_campaign%3Dadb_acq_v3%26utm_source%3Dadb_acq_v3%26utm_content%3D91b52ce097b1464b9b47cb2995c493cc6ab2c3a3

  4. 复制 utm_content%3D 后面的唯一 ID。

    在上一个示例中,ID 是 91b52ce097b1464b9b47cb2995c493cc6ab2c3a3

  5. 使用步骤 3 中的唯一 ID 通过以下格式构建客户获取结束链接:

    https://c00.adobe.com/v3/<appid>/end?a_ugid=<unique id>

    例如:https://c00.adobe.com/v3/<appid>/end?a_ugid=91b52ce097b1464b9b47cb2995c493cc6ab2c3a3

  6. 在桌面浏览器中打开该链接。

    您应会在 JSON 响应中看到 contextData

    {"fingerprint":"228d7e6058b1d731dc7a8b8bd0c15e1d78242f31","timestamp":1457989293,"appguid":"","contextData":{"a.referrer.campaign.name":"name","a.referrer.campaign.trackingcode":"trackingcode"}}.

    如果您没有看到 contextData,或者缺少某些字符串,请确保客户获取 URL 遵循手动创建客户获取链接中的格式。

  7. 重复步骤 3 以获取新的唯一 ID。

  8. 确认配置文件中的以下设置准确无误:

    设置
    acquisition 服务器应为 c00.adobe.comappid 应等于您的客户获取链接中的相应 appid
    analytics 为了进行测试,请设置充足的反向链接超时,以留出足够的时间(60 秒或更长)来手动发送此广播。测试后,可以恢复原始超时设置。
  9. 将设备连接到计算机,然后卸载并重新安装应用程序。

  10. 启动 ADB Shell,然后在设备上启动应用程序。

  11. 使用以下 adb 命令发送广播:

    am broadcast -a com.android.vending.INSTALL_REFERRER -n com.adobe.android/com.adobe.android.YourBroadcastReceiver --es "referrer" "utm_source=adb_acq_v3&utm_campaign=adb_acq_v3&utm_content=<unique id get on step 5>"

  12. 完成以下步骤:

    1. com.adobe.android 替换为您的应用程序包名称。
    2. 使用您的应用程序中的促销活动跟踪接收器位置引用更新接收器引用。
    3. 替换与 utm_content 关联的值。

    如果广播成功,您可以看到与以下示例类似的响应:

    Broadcasting: Intent
    { act=com.android.vending.INSTALL_REFERRER cmp=com.adobe.adms.tests/.ReferralReceiver (has extras) }
    Broadcast completed: result=0
    
  13. (可选)您可以启用 SDK 的调试日志记录以获取其他信息。

    如果一切工作正常,您应会看到以下日志:

"Analytics - Received referrer information(<referrer content>)" "Analytics - Trying to fetch referrer data from (acquisition end url)"; "Analytics - Received Referrer Data(<A JSON Response>)"

如果您没有看到上述日志,请确认您已完成步骤 6 至 12。

下表包含有关可能出现的错误的更多信息:

错误 描述
Analytics - Unable to decode response(String). 响应的格式错误。
Analytics - Unable to parse response (a JSON Response). JSON 字符串的格式错误。
Analytics - Unable to parse acquisition service response (no contextData parameter in response). 响应中没有 contextData 参数。
Analytics - Acquisition referrer data was not complete (no a.referrer.campaign.name in context data), ignoring. contextData 中未包含 a.referrer.campaign.name
Analytics - Acquisition referrer timed out. 无法在 referrerTimeout 定义的时间内获取响应。请增加值,然后重试。您还应确保已在安装应用程序之前打开客户获取链接。

请牢记以下信息:

  • 可通过使用 HTTP 监控工具监控从相应应用程序发送出的点击,进而确认客户获取归因。

  • 有关如何广播 INSTALL_REFERRER 的更多信息,请参阅《Google 开发人员指南》中的 Testing Google Play Campaign Measurement(测试 Google Play 促销活动测量)。

  • 针对 Android 4.8.2 上的客户获取发布了错误修复。

    在测试之前,请将 SDK 升级到最新版本。

  • 您可以使用提供的 acquisitionTest.jar Java 工具来帮助获取唯一 ID 和广播安装反向链接,这反过来也可以帮助您获取步骤 3 至 12 中的信息。

    安装 Java 工具

要安装 Java 工具,请执行以下操作:

  1. 下载 acquisitionTester.zip 文件。

  2. 解压缩该 .jar 文件。

    您可以通过命令行运行该文件。

    例如:

    java -jar acquisitionTester.jar -a com.adobe.test -r com.adobe.test.ReferrerReceiver -l "https://c00.adobe.com/v3/appid/start?a_i_id=123456&a_g_id=com.adobe.test&a_dd=i&ctxa.referrer.campaign.name=name&ctxa.referrer.campaign.trackingcode=1234
    

在此页面上