跳转到内容
KasskeepKasskeep 文档

AdMob

配置

Section titled “配置”
  1. 在 AdMob 打开 Apps → Ad units，编辑激励广告位，启用 Server-side verification。把回调 URL 设为：
https://api.kasskeep.com/v1/ads/admob/<app_id>/ssv
  1. 在 Kasskeep 里映射广告位。可以直接粘贴完整的 ca-app-pub-xxx/yyy id；Kasskeep 保存斜杠后面的部分，也就是 SSV 实际发送的内容。
终端窗口
npx @kasskeep/cli ads unit-set --id app_xxx --name revive --admob ios:ca-app-pub-123/456 --admob android:ca-app-pub-123/789
  1. 在客户端设置 ServerSideVerificationOptions，userId 设为 Kasskeep 的 app_user_id，按需设置 customData。

AdMob 不需要密钥。你可以把 AdMob app id 存作备注：ads credentials --id app_xxx --admob-app-id ca-app-pub-...~...。

校验

Section titled “校验”
  • 签名内容是 &signature= 之前的原始查询字符串，不做任何改动或解码。
  • signature 是 base64url 编码的 DER ECDSA（P-256，SHA-256）签名。公钥按 key_id 从 Google 公布的验证密钥中选取，最多缓存 24 小时，遇到未知 key_id 时重新拉取。
  • 签名无效返回 400 invalid_signature；key id 未知返回 400 unknown_key_id。
  • 不带 user_id 的回调（比如控制台的 Verify URL 测试）返回 200 {"outcome": "ignored", "reason": "no_user_id"}。
AdMob 参数 事件字段
user_id app_user_id
ad_unit network_ad_unit_id，映射为 ad_unit
reward_item reward_type
reward_amount reward_amount
transaction_id network_transaction_id
custom_data custom_data
timestamp occurred_at