关于收据验证

概要:了解如何通过收据验证对应用内购买和订阅收入进行衡量,并与应用商店校验,从而确保收入衡量的准确性。

广告主可使用收据验证,对来自Google Play和App Store的应用内购买进行验证与衡量。

收据验证对所有账户方案免费开放。

 注意

建议您使用我们的高级ROI360商店收入解决方案,以使用净收入计算、完整漏斗衡量、处理退款以及自动化购买识别与去重等功能。如需详细信息,或两种方案的对比,请参阅购买与订阅验证的两种解决方案

收据验证的工作原理

收据验证流程如下:

  1. 用户在应用内进行购买。
  2. 应用商店确认购买成功,并通知应用。
  3. 应用开发者调用SDK中的收据验证:validateAndLogInAppPurchase
  4. SDK调用AppsFlyer验证服务。
  5. AppsFlyer判断该购买是否真实有效。
  6. 验证成功后,AppsFlyer会记录购买或订阅事件。
  7. 如果收据验证失败,事件将显示在 已拦截应用内事件原始数据报告中(仅对Protect360订阅用户开放),并在实时事件查看器页面显示,参数af_validated设置为 false
  8. AppsFlyer验证服务将结果返回给SDK。
  9. SDK将验证结果(成功或失败)返回给应用。

启用收据验证

请按照以下步骤启用收据验证:

  1. 在AppsFlyer中,从左侧菜单进入settings-roi.png设置,在ROI360下选择收入设置
  2. 打开购买与订阅标签页。
  3. 在步骤1选择产品类型中,选择收据验证
  4. 点击保存并继续,进入收据验证流程。

设置收据验证

有关详细信息,请参阅设置收据验证。

收据验证的应用内购买事件和参数

所有预定义事件的共同特性:

  • 均作为S2S事件处理。
  • 可在面板和原始数据报告中,以自然量或非自然量应用内事件形式查看。
  • 可以通过回传发送给合作渠道。
  • 可以在SKAN转化值操作台中使用。

应用内购买事件:

  • af_purchase - 正式环境
  • af_purchase_sandbox_sdk - 沙盒

订阅事件:

  • af_ars_trial_started - 订阅试用期开始。
  • af_ars_subscriptions_started - 付费订阅开始(无试用期,正式环境)
  • af_ars_sandbox_sdk - 试用或付费订阅开始(沙盒环境)

事件包含的预定义参数:

  • af_product_id
  • af_transaction_id (iOS only)
  • af_purchase_token (Android only)
  • af_revenue (沙盒事件中为af_sandbox_revenue)
  • af_currency
  • af_store (app_store / play_store)
  • af_environment (沙盒/正式环境)
  • af_validation_type (receipt_validation)

其他自定义参数:

  • 在SDK调用中传入的任何自定义参数,都会显示在原始数据报告的 custom_data字段中。

从ROI360商店收入切换至收据验证

如果您当前使用的是ROI360商店收入,并希望切换为收据验证,请按以下步骤操作:

  1. 在AppsFlyer中,从左侧菜单进入settings-roi.png设置,在ROI360下选择收入设置
  2. 购买和订阅选项卡中,确认产品类型设置为ROI360
  3. 点击无标题 3.png
  4. 系统将弹出提示,显示切换将对收据验证产生的影响:
    • ROI360相关功能,包括退款归因、订阅续费衡量以及净收入计算将被禁用。
    • 数据准确性可能会下降。
    • 购买连接器不支持收据验证。
    • 仅支持validateAndLogInAppPurchase这一SDK方法。
  5. 如果需要,请点击查看比较表进行对比。
  6. 如需继续操作,点击确认切换完成操作。
  7. 切换完成后,产品类型将更新为收据验证,界面将显示为简化配置。
  8. 您需要重新验证以下内容:
    • 用于validateAndLog方法的SDK部署

特点与局限性

特点 说明
支持的商店 • Google Play
• App Store
• 如使用其他第三方商店,需手动发送应用内购买事件
 
iOS沙盒应用 对于尚未在App Store上线的iOS沙盒应用,“验证密钥”将始终显示为无效状态