概要:了解如何通过收据验证对应用内购买和订阅收入进行衡量,并与应用商店校验,从而确保收入衡量的准确性。
广告主可使用收据验证,对来自Google Play和App Store的应用内购买进行验证与衡量。
收据验证对所有账户方案免费开放。
注意
建议您使用我们的高级ROI360商店收入解决方案,以使用净收入计算、完整漏斗衡量、处理退款以及自动化购买识别与去重等功能。如需详细信息,或两种方案的对比,请参阅购买与订阅验证的两种解决方案。
收据验证的工作原理
收据验证流程如下:
- 用户在应用内进行购买。
- 应用商店确认购买成功,并通知应用。
- 应用开发者调用SDK中的收据验证:
validateAndLogInAppPurchase - SDK调用AppsFlyer验证服务。
- AppsFlyer判断该购买是否真实有效。
- 验证成功后,AppsFlyer会记录购买或订阅事件。
- 如果收据验证失败,事件将显示在 已拦截应用内事件原始数据报告中(仅对Protect360订阅用户开放),并在实时事件查看器页面显示,参数
af_validated设置为false。 - AppsFlyer验证服务将结果返回给SDK。
- SDK将验证结果(成功或失败)返回给应用。
启用收据验证
请按照以下步骤启用收据验证:
- 在AppsFlyer中,从左侧菜单进入
设置,在ROI360下选择收入设置。
- 打开购买与订阅标签页。
- 在步骤1选择产品类型中,选择收据验证。
- 点击保存并继续,进入收据验证流程。
设置收据验证
有关详细信息,请参阅设置收据验证。
收据验证的应用内购买事件和参数
所有预定义事件的共同特性:
- 均作为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商店收入,并希望切换为收据验证,请按以下步骤操作:
- 在AppsFlyer中,从左侧菜单进入
设置,在ROI360下选择收入设置。
- 在购买和订阅选项卡中,确认产品类型设置为ROI360。
- 点击
。
- 系统将弹出提示,显示切换将对收据验证产生的影响:
- ROI360相关功能,包括退款归因、订阅续费衡量以及净收入计算将被禁用。
- 数据准确性可能会下降。
- 购买连接器不支持收据验证。
- 仅支持
validateAndLogInAppPurchase这一SDK方法。
- 如果需要,请点击查看比较表进行对比。
- 如需继续操作,点击确认切换完成操作。
- 切换完成后,产品类型将更新为收据验证,界面将显示为简化配置。
- 您需要重新验证以下内容:
- 用于validateAndLog方法的SDK部署
特点与局限性
| 特点 | 说明 |
|---|---|
| 支持的商店 | • Google Play • App Store • 如使用其他第三方商店,需手动发送应用内购买事件 |
| iOS沙盒应用 | 对于尚未在App Store上线的iOS沙盒应用,“验证密钥”将始终显示为无效状态 |