설치 후 이벤트(PIE) 데이터

소개

광고주가 이 엔드포인트를 사용해 각 사용자 수준 이벤트에 대한 Vungle 데이터를 즉시 보낼 수 있습니다. 이벤트 데이터 API의 목적은 어떤 사용자가 중요한지를 Vungle에게 알리는 것입니다. 앱에서 이벤트 정보를 보내면 Vungle이 캠페인을 최적화하여 사용자에게 중요한 정보를 제공할 수 있습니다.

목차

HTTP 요청

http://ingest.vungle.com/eventData

POST

다음과 같은 본문 콘텐츠 유형에서 POST 요청이 지원됩니다.

  • application/x-www-form-urlencoded  
  • application/json  

참고: Vungle은 JSON 본문에 POST 메서드를 사용할 것을 권장합니다.

curl -H "Content-Type: application/json" -d '{"data": "myData"}' "http://ingest.vungle.com/eventData"

GET

또한, 쿼리 매개 변수를 사용하여 GET요청을 지원합니다.

curl "http://ingest.vungle.com/eventData?data=myData"

필수 매개 변수

전송하신 각 이벤트에는 필수 매개 변수와 선택 매개 변수가 모두 있습니다. 필요한 매개 변수가 없는 요청을 거부하고 누락된 내용을 알려드립니다. 더 자세한 내용은 오류 섹션을 참조합니다.

기종 식별자

이벤트 당 하나 이상의 기종 식별자가 필요하므로 모두 전달할 필요가 없습니다.

매개 변수 설명
device_idfa Apple IDFA 또는 Google Play Services 광고 ID
device_mac 정식 포멧의 Mac 주소(하이픈 또는 콜론으로 구분)
device_other_id 기타 고유 식별자, e.g. Android ID, 해시된 식별자 등

참고: Vungle은 device_idfa를 사용을 권장합니다.(가능한 경우)

기타 필수 매개 변수

이벤트를 수락하려면 나머지 필요 매개 변수를 모두 전달해야 합니다.

매개 변수 설명
vungle_app_id Vungle 대시보드에 지정된 앱 ID
trk 들어오는 이벤트 소스 서버 통합에 대한 직접 서버의 경우 자체 식별자가 있어야 하며, 그렇지 않으면 추적 공급자(e.g. ‘tune’, 'kochava’,'adjust’,'appsflyer’ 등)을 식별해야 합니다.
event_trk_id  이 ID는 해당 이벤트에 대한 고유 ID여야 합니다. 중복 제거에 사용.
event_id Vungle 이벤트 식별자. Vungle 캠페인에서 앱을 구동한 사용자가 이 이벤트를 수행하는 경우, 이벤트 식별자는 보기 또는 클릭 추적 광고에서 전달됩니다.
event_name 이 값은 전체 사용자에 대해 일관성 있는 이벤트를 식별하는 문자열이어야 합니다(e.g. 'tutorial-complete’, 'level-3’, 'purchase' 등)

POST 본문 예시:

{
  "device_idfa"   : "236A005B-700F-4889-B9CE-99",
  "vungle_app_id" : "myVungleApp",
  "trk"           : "tune",
  "event_trk_id"  : "uniqueID1234",
  "event_name"    : "tutorial-complete"
}

GET 본문 요청:

curl "http://ingest.vungle.com/eventData?device_idfa=236A005B-700F-4889-B9CE-999EAB2B605D&vungle_app_id=myVungleApp&trk=tune&event_trk_id=uniqueID1234&event_name=tutorial-complete"

위의 페이로드는 '200 OK' 응답을 반환하며 Vungle에 전송할 수 있는 최소 요청의 예입니다.

선택 매개 변수

이 매개 변수는 선택 사항이지만, Vungle이 이를 이용해 가치 있는 사용자를 구분하므로 가능한 많은 매개 변수를 전달해야 합니다.

매개 변수 기본값 설명
event_value None 이벤트와 관련된 수치. Vungle에 보내는 다른 이벤트와 관련이 있어야 합니다. 예를 들어, $4.99 IAP는 4.99.여야 합니다.
event_currency 'usd'  event_value가 금전적으로 명시적 가치를 갖는 경우, 여기에서 통화를 정의합니다.
event_iap_event false 이벤트가 인앱 구매인지를 나타내는 플래그를 설정합니다.
device_limit_track false 기종의 '광고 추적 제한' 설정 여부에 대한 부울.
event_datetime 이벤트 수신 타임 스탬프 이벤트 발생 타임 스탬프 시간대를 지정하지 않으면 UTC가 사용됩니다. 타임 스탬프는 ISO 8601 포멧이어야 합니다.
device_ip None 장치의 IP 주소.
device_make None 장치 제조사.
device_model None 장치 모델.
device_carrier None 장치 이동 통신사.
device_language None 장치의 ISO 639-1 언어 코드(2자리).
device_country None 소스 IP의 ISO 3166 국가 코드(2자리).
device_user_agent  None 장치의 브라우저 사용자 에이전트.
device_os None 운영 체제 버전 번호.

참고: event_value 매개 변수를 기록하고 각 이벤트의 값을 고려합니다. Vungle은 사용된 실제 숫자에 상관없이 사용 가능하지만, 이벤트는 서로 상대값을 갖는 값을 가져야 합니다. Vungle은 사용자 유형의 전반적인 가치를 극대화하기 위해 노력할 것입니다.

선택 매개 변수 예시

{
  "event_currency"      : "usd",
  "event_iap_event"     : true,
  "device_limit_track"  : false,
  "event_datetime"      : "2015-03-15T13:27:36Z",
  "device_ip"           : "201.15.25.11",
  "device_make"         : "samsung",
  "device_model"        : "sm-g900v",
  "device_carrier"      : "verizon",
  "device_language"     : "es",
  "device_country"      : "us",
  "device_user_agent"   : "Mozilla/5.0 (Linux; U; Android 2.2.1; fr-fr; HTC_DesireZ_A7272 Build/FRG83D) AppleWebKit/533.1 (KHTML, like Gecko), Version/4.0 Mobile Safari/533.1",
  "device_os"           : "4.3.2",
  "event_value"         : 1.99
} 

오류 코드

Vungle은 다음 코드를 반환합니다.

오류 코드 의미
200  확인 – 감사합니다!
400 잘못된 요청 – 잘못된 요청입니다. 대부분의 경우, 필수 매개 변수 중 하나가 누락되었을 가능성이 큽니다. 응답 본문에서 원인을 확인합니다.
500 내부 서버 오류 – 서버에 문제가 있습니다. 잠시 후에 다시 시도합니다.
503 서비스를 사용할 수 없음 - 유지 관리를 위해 일시적으로 오프라인 상태입니다. 잠시 후에 다시 시도합니다.

'400 잘못된 요청' 메시지가 표시되면 응답 본문을 확인합니다. Vungle은 오류 진단을 위해 최선을 다할 것입니다. 대부분의 경우 입력란 한 두 개가 누락되었을 가능성이 가장 높습니다. 예를 들어,

curl "http://ingest.vungle.com/eventData?trk=tune&event_trk_id=uniqueID1234"

다음과 같은 응답을 반환합니다.

{
  "missing_fields":
  [
    "vungle_app_id",
    "trk",
    "event_trk_id",
    "event_name",
    "device_idfa | device_mac | device_other_id"
  ]
}

 

 

또 다른 질문이 있으십니까? 문의 등록

댓글