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

    1 2 3 4

    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

    1 2 3 4 5 6

    > 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."}

    1 2 3 4 5

    < 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."}