CPA 달성 알림

게임에서는 HIVE 프로모션 콘솔에 등록된 CPA 달성 시, 해당 정보를 HIVE에 보내 보상을 지급할 수 있습니다. CPA 달성 알림은 게임서버에서 프로모션 서버로 호출 해주세요.

  • Request URL
상용 URL https://promotion.qpyou.cn/api/cpa
Sandbox URL https://sandbox-promotion.qpyou.cn/api/cpa
HTTP Method POST
Content-Type text/html
Data Format JSON
  • Header
필드명 설명 타입 필수여부
Authorization Bearer Authorization으로 certificationKey 유효 판단 String N
  • Request
필드명 설명 타입 필수여부
appid CPA를 달성한 게임의 AppID String Y
vid 혹은 uid 모듈에 따라 vid 혹은 uid 중 1개 필요
- vid : 통합모듈인 경우 필수
- uid : 개별모듈인 경우 필수
String Y
server_id 게임 내 유저 서버 구분 값 String Y
cpa_code 진행하는 CPA코드 (UA 운영 담당자와 확인 필요) String Y
cpa_date CPA 달성 시간, 한국 기준 시간(KST) (Default:API 호출 시간) String N
  • Response
필드명 설명 타입
result_code 요청 결과, 0=성공 Integer
result_msg 결과 메시지 String
  • 예제 코드

    • 호출
     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
    
    • 요청
     curl
     > 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."}
    
                        ```