리머지 이벤트 측정 API는 고객사와 협력사가 광범위한 데이터를 리머지로 전송하는 방법을 제공하는 리머지 도구입니다. 이에 따라 해당 고객/협력사는 인앱 이벤트, 어트리뷰션, BI, SKAdNetwork 데이터를 당사에 제공할 수 있습니다. 다음 문서는 리머지 이벤트 측정 API로 전달되는 인앱 이벤트 데이터에 대한 이해를 돕는 설명입니다. 질문이 있으시면 리머지 계정 관리자에게 문의하세요.
프로세스
요청
수신
응답
HTTP 204 (기본값). 따라서 리머지 계정 관리자에게 문의하여 요청이 제대로 처리되었는지 확인하십시오.
엔드포인트
프로토콜
HTTPS
빈도
일반
- 모든 인앱 이벤트를 실시간으로 전달합니다.
앱 열기
- 10분마다 App Open 이벤트를 전달합니다.
매개 변수
- 측정이 제대로 이루어질 수 있도록 모든 필수(M) 매개변수를 제공하십시오.
- (선택 사항) 매개변수를 추가하여 리타게팅 및 보고 기능을 개선 할 수 있습니다.
-
웹에 부적합한 문자가 포함된 매개변수를 적합하게 인코딩하십시오.
| 이름 | 내용 | 예시 |
|---|---|---|
| app_id (M) | Google Play Store/iTunes("ID" 프리픽스가 포함되지 않음) | 553834731, com.king.candycrush |
| event (M) |
인앱 이벤트 이름은 특성/CTA(예: in-app open 또는 in-app purchase)를 반영해야 합니다. 또한 (신규 사용자를 대표하여) 첫 번째 앱 열기 이벤트의 이름을 인스톨 이벤트로 지정해야 합니다. |
purchase, add_to_basket, level_2_reached |
| 데이터 | 이벤트에 대한 추가 데이터입니다. 큰따옴표를 이용한 JSON 형식으로 구현해야 합니다. 단일 문자열도 허용됩니다. | {"store":1341, "keywords":["yellow","red"]} |
| ts | 이벤트 타임스탬프는 Unix Epoch입니다. 시간대는 UTC로 길이는 10자리여야 합니다. | 1427976389 |
| partner (M) | 측정 협력사 이름 | supergame |
| key (M) | 협력사 키(리머지 제공) | x34dlx |
| idfa (M) |
Apple IDFA (모든 문자를 대문자로) |
AEBE52E7-03EE-455A-B3C4-E57283966239 |
| aaid (M) |
Android 광고 ID (모든 문자를 소문자로) |
38400000-8cf0-11bd-b23e-10b96e40000d |
| country | ISO 알파 2 국가 코드 | de |
| device_name | 장치 이름 | 예: iPhone11, iPhone7, iPhone XR, Galaxya51, Galaxya50 |
|
os_name |
운영체제 이름 | android, ios |
| os_version | 운영체제 버전 | 8.0.1 |
| app_version | 앱 버전 | 1.2 |
| user | 고객 사용자 ID | 4838131 |
| 수익 | 마이크로 통화 단위의 Revenue(단위 액수를 활성화하고 소수문제 예방) | revenue=170000 (=0.17), 5750000 (=5.75$) |
| (revenue_float) | 가격에 소수 단위와 소수점을 사용하지 않는 경우 | revenue_float=0.17 또는 5.75 |
| currency | ISO 4217 통화 코드 | USD |
| non_app_event | 앱에서 이벤트가 생성되지 않는 경우(예: 클릭 포스트백) - true 또는 false | false |
|
idfv (M) |
iOS에만 적용되는 사용자의 IDFV(공급업체 ID) |
E29738C9-0556-4F49-AB98-1A33197F0FFD |
|
operator |
이동통신사 |
MTS%20RUS, TELCEL, Telenor AT%26T, Iliad, Viettel, LGU%2B |
|
zipcode |
지역 우편번호 |
15414, 500064, 517504, 115088 |
|
city |
도시 이름. UN/LOCODE 사용 (표준화를 위하여) |
Yokohama, Yocina, Bogota |
|
country_subdivision |
주 이름 |
CA, PB, Sindh, Istanl |
|
partner_device_id |
사용자의 ID |
|
|
ip |
IP 주소(ip4,ip6?) |
178.151.153.17 |
|
language |
사용자 언어(단순/확장 가능) |
단순: en,ja,bg 확장: pl-SE, ru_RU |
|
sdk |
고객사가 구현한 SDK 버전 |
2.2 |
데이터 매개변수
데이터 매개변수는 JSON 형식으로 고유한 키 값 여러 쌍을 보유할 수 있으며, 이 쌍은 이벤트 자체의 일부로서 사용자의 행위에 대한 추가 메타데이터를 제공하는 데 사용됩니다. 예를 들어, 전자 상거래에서 이 매개변수는 제품 관련 정보(제품 ID, 가격, 수량 등)를 전달하여 제품 피드의 맞춤형 배너에 추가적으로 관련 제품을 표시하고 식별하는 데 사용됩니다.
구조
- JSON 데이터 구조:
data= {"product_id":"sdf235235dfw3131","cv_type":0}
형식
- URL 인코딩된 JSON 객체:
데이터=%7B%22product_id%22%3A%22sdf235235dfw3131%22%2C%22cv_type%22%3A0%7D%20
- 문자열을 큰따옴표로 묶어야 합니다(JSON 사양, https://www.json.org/json-en.html 참조).
- 리머지에 여러 개의 제품 ID를 제공하려면 다음 작업을 수행하세요.
data={"products":["23ef23","234fe2d","23dw334"]}and encoded:
data=%7B%22products%22%3A%5B%2223ef23%22%2C%22234fe2d%22%2C%2223dw334%22%5D%7D%C2%A0
예시
-
자리표시자 예시({PLACEHOLDER} 이름에는 내부 자리표시자의 이름이 포함되어 있어야 합니다):
https://remerge.events/event?app_id={AppId}&event={EventName}&partner=yourname&key=yourkey&idfa={IDFA}&aaid={AAID}&country={Country}&device_name={DeviceName}&os_name={OS}&os_version={OSVersion}&ts={Timestamp}&revenue={RevenueAmount}¤cy={Currency}&non_app_event=false