소개
광고주가 이 엔드포인트를 사용해 각 사용자 수준 이벤트에 대한 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"
]
}