CPA達成の通知

ゲーム内で、ユーザーがプロモーションコンソール（Hive コンソール > プロモーション）に登録されたCPAを達成した場合、Hive サーバーに情報を送信してユーザーに報酬を支払うことができます。ゲームサーバーからプロモーションサーバーにCPA達成通知を呼び出してください。

リクエスト URL

一般的なURL	https://promotion.qpyou.cn/api/cpa
サンドボックスURL	https://sandbox-promotion.qpyou.cn/api/cpa
HTTPメソッド	POST
コンテンツタイプ	text/html
データフォーマット	JSON

ヘッダー

フィールド名 説明 タイプ 必須

認証 Bearer認証を通じて有効なCertificationKey 文字列 N

ヘッダー

フィールド名 説明 タイプ 必須

認証 Bearer認証を通じて有効なCertificationKey 文字列 N

リクエスト

フィールド名	説明	タイプ	必須
appid	CPAを達成したゲームのApp ID	文字列	はい
vidまたはuid	1つを使用するために必須、vidまたはuid - vid: 認証v4を使用する際のプレイヤーID。認証v1を使用する際のVID - uid: HIVE IDやKakao App Center IDなどのプラットフォームによって管理されるユーザー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":"Success."}

フィールド名	説明	タイプ
result_code	リクエストの結果。0=成功	整数
result_msg	結果メッセージ	文字列