通知 CPA 达成情况

在游戏中，当用户在推广控制台 (Hive 控制台 > 推广) 中达到注册的CPA时，您可以将信息发送到Hive 服务器以向用户支付奖励。请从游戏服务器调用推广服务器以进行CPA成就通知。

  • 请求 网址
    公共网址 https://promotion.qpyou.cn/api/cpa
    沙盒网址 https://sandbox-promotion.qpyou.cn/api/cpa
    HTTP方法 POST
    内容类型 text/html
    数据格式 JSON
  • 标题
    字段名称 描述 类型 必需
    授权 通过 Bearer 授权的 CertificationKey 有效 字符串 否
  • 标题
    字段名称 描述 类型 必需
    授权 通过Bearer授权的CertificationKey有效 字符串 否
  • 请求
    字段名称 描述 类型 必填
    appid 实现CPA的游戏的App ID 字符串 是
    vid或uid 需要使用其中一个，vid或uid - vid: 使用身份验证v4时的玩家ID。使用身份验证v1时的VID - uid: 由平台管理的用户ID，例如HIVE ID和Kakao应用中心ID 字符串 是
    server_id 区分游戏用户服务器的值 字符串 是
    cpa_code 进行中的CPA代码（需要与UA运营PIC确认） 字符串 是
    cpa_date CPA达成时间，韩国标准时间（KST）（默认：API实现时间） 字符串 否
  • 响应
    字段名称 描述 类型
    result_code 请求的结果。0=成功 整数
    result_msg 结果消息 字符串

  • 示例代码

    • 调用
    curl -L -v
-d '{"appid":"com.com2us.hivesdk.normal.freefull.google.global.android.common", "vid":"300000011", "server_id":"kr", "cpa_code":"113", "cpa_date":"2022-03-15 12:00:00"}'
-H "Content-Type: application/json"
https://sandbox-promotion.qpyou.cn/api/cpa
    • 请求
    > POST /api/cpa HTTP/1.1
> User-Agent: curl/7.29.0
> Host: sandbox-promotion.qpyou.cn
> Accept: /
> Content-Type: application/json
> Content-Length: 164
    • 响应
    < HTTP/1.1 200 OK
< Server: nginx
< Date: Tue, 15 Mar 2022 03:17:10 GMT
< Content-Type: text/html; charset=UTF-8
{"result_code":0,"result_message":"成功."}