요약: 이 API를 사용하여 로데이터 리포트를 CSV 파일로 가져옵니다.
Pull API 로데이터
- Pull API를 사용하면 CSV 파일에 대한 로데이터 리포트를 가져올 수 있습니다. 로데이터 리포트에 대해 자세히 알아보기
- 사용 가능한 필터 기준 옵션: 미디어소스, 날짜 범위, 인앱이벤트 이름 및 지역입니다.
- Pull API의 추가 기능은 다음과 같습니다.
- 통화 선택
- 시간대 선택
Pull API를 통해 사용할 수 있는 로데이터 리포트
| 리포트 | 설명 | 업데이트 빈도 |
|---|---|---|
| 로데이터 리포트 (논오가닉) | ||
| 인스톨 | 논오가닉 인스톨을 기록합니다. 사용자가 앱을 처음 열 때 레코드가 생성됩니다. |
실시간 |
| 인앱 이벤트 | 사용자가 수행한 이벤트를 기록합니다. |
실시간 |
| 앱 삭제 | 사용자가 앱을 삭제할 때 기록합니다. |
일별 |
| 리인스톨 |
앱을 삭제한 후 UA 미디어 소스에 참여하고 리어트리뷰션 기간 동안 앱을 다시 인스한 사용자를 기록합니다. | 실시간 |
|
로데이터 리포트(오가닉) |
||
| 오가닉 인스톨 |
사용자가 앱을 처음 열었을 때를 기록합니다. |
계속 |
| 오가닉 인앱 이벤트 |
사용자가 수행한 이벤트에 대한 세부 정보를 기록합니다. |
계속 |
| 오가닉 앱 삭제 |
앱을 삭제하는 사용자를 기록합니다. |
일별 |
| 오가닉 앱 리인스톨 |
리인게이지먼트 기간 동안 리타게팅 미디어 소스로 인한 사용자의 광고 수익을 기록합니다. |
일별 |
|
광고 수익 로데이터 |
||
|
어트리뷰션된 광고 수익 |
미디어 소스로 어트리뷰트한 사용자의 광고 수익을 기록합니다. | 일별 |
| 오가닉 광고 수익 | 미디어 소스에 어트리뷰트되지 않은 사용자의 광고 수익을 기록합니다. | 일별 |
| 프로텍트360 프로드(fraud) | ||
| 인스톨 | 사기로 식별되어 미디어 소스에 어트리뷰트되지 않은 인스톨을 기록합니다. | 실시간 |
| 포스트 어트리뷰션 인스톨 | 사기 설치로 한 인해 전허 어트리뷰트되지 않은 인앱이벤트를 기록합니다. | 실시간 |
| 인앱 이벤트 | Protect360에서 사기로 식별된 인앱이벤트를 기록합니다. | 일별 |
| 포스트 어트리뷰션 인앱 이벤트 | 인스톨 자체와 상관없이 미디어 소스에 어트리뷰트되거나 사기로 판단된 후 사기로 식별된 인스톨에 대한 인앱이벤트를 기록합니다. | 일별 |
| 클릭 | Protect360에 의해 차단된 사용자가 수행한 클릭을 기록합니다. | 일별 |
| 차단된 인스톨 포스트백 | 인스톨이 차단된 미디어 소스로 전송된 포스트백 사본을 기록합니다. | 실시간 |
| 포스트백 | ||
| 인스톨 포스트백 | 사용자가 앱을 처음 열 때 생성된 인스톨 이벤트를 기록합니다. | 일별 |
| 인앱 이벤트 포스트백 | 미디어 소스로 전송된 인앱이벤트 포스트백을 기록합니다. | 일별 |
| 리타게팅 인앱이벤트 포스트백 | 리인게이지먼트 기간 동안 사용자가 수행한 인앱이벤트를 기록합니다. | 실시간 |
| 리타게팅 전환 포스트백 | 리인게이지먼트 기간 동안 사용자가 수행한 인앱이벤트를 기록합니다. | 실시간 |
Pull API 로데이터 사용하기
Pull API 로데이터 사용법:
API 토큰을 가져옵니다. 관리자가 토큰을 검색해야 합니다.
- 개발자에게 인증 헤더에 사용할 API 토큰을 제공합니다.
- 다음 절에 설명한 데 따라 개발자에게 API 호출을 할 때 입력할 파라미터를 제공합니다. 파라미터는 리포트의 중점 사항, 구성 방법을 결정하고 리포팅 기간을 제공합니다.
- 개발자에게 개발자 허브의 Pull API 로데이터 지침을 따르도록 합니다.
파라미터
| 파라미터 | 설명 |
|---|---|
| from |
|
| 활용 |
종료일. from부터 시작해서 마치는 날.
|
|
media_source |
|
| maximum_rows |
단일 API 호출에 의해 반환된 최대 행 수입니다.
|
| event_name |
인앱이벤트를 지정된 이벤트별로 필터합니다. 쉼표로 구분된 목록을 사용하여 다중 이벤트를 선택합니다. 예: |
| reattr |
리타게팅 어트리뷰션 데이터를 설정합니다.
|
| additional_fields |
기본 필드 외에 추가 필드를 가져오기 위한 것입니다. 예: |
| currency |
수익 및 비용의 통화
예: 앱 고유 통화가 EUR이면 |
| 시간대 |
[기본값] UTC를 사용하여 데이터가 반환됩니다.
|
| 지역 |
데이터를 국가 코드로 필터링합니다. 제한: API 호출당 하나의 국가 코드 필터만 선택할 수 있습니다. 예: |
| from_install time |
|
| to_install_time |
종료 날짜입니다. |
| agency |
특정 에이전시에 대한 통화를 제한(필터링)합니다. |
Protect360 필드
시간 기간 필드
API 결과가 최대값을 초과할 경우 시간과 분을 사용하여 리포트를 분할합니다. 다음을 적용합니다.
- 시작/마감: yyyy-mm-dd hh:mm
-
시작:
- 날짜만 = 선택한 날짜의 시작(00:00)부터
- 날짜 및 시간 = 00:00을 포함하여 시작
-
파라미터 마감:
- 날짜만 = 선택한 요일의 마지막(24:00)까지
- 날짜 및 시간 = 표시된 시간까지, 그러나 이 시간을 포함하지 않음
예: 앱 소유자는 모든 소스에서 매일 1300K를 설치합니다. 1M 행 제한을 극복하기 위해 앱 소유자는 하루를 두 개의 12시간 URI 호출로 나눕니다. 옵션에 대해서는 다음 표를 참조하십시오.
| API 호출 | 시작 | 마감 |
|---|---|---|
| 첫 번째 API 호출 |
시작=yyyy-mm-dd 예:
|
마감=yyyy-mm-dd 12:00 예:
|
|
옵션 A: 두 번째 API 호출
예:
|
시작 시간=yyyy-mm-dd 12:00 예:
|
to=yyyy-mm-dd 예:
|
| 옵션 B: 두 번째 API 호출 |
시작 시간=yyyy-mm-dd 12:00 예:
|
마감=yyyy-mm-dd+1 00:00 +1 = 익일 00:00 예:
|
|
일러두기: 두 개의 결과가 같으므로 옵션 A 또는 B를 사용합니다. |
||
추가 필드
추가 리포트 필드는 기본 필드 목록에 추가되지 않으므로 새 필드가 기존 가져오기 및 수집 프로세스에 영향을 주지 않습니다. 기본이 아닌 필드를 가져오려면 additional_field 파라미터를 사용하십시오.
- 필드는 한 번만 기재합니다.
- 사용 가능한 필드 목록을 참조하십시오.
-
예:
additional_fields=device_download_time,deeplink_url
기본 필드
| 기본 Pull API 필드 |
|---|
| Attributed Touch Time |
| Install Time |
| Event Time |
| Event Name |
| 이벤트 값 |
| Event Revenue |
| Event Revenue Currency |
| Event Revenue USD |
| Event Source |
| Is Receipt Validated |
| 파트너 |
| Media Source (미디어 소스) |
| 채널 |
| 키워드 |
| 캠페인 |
| 캠페인 ID |
| 광고세트 |
| 광고세트 ID |
| Ad |
| 광고 아이디 |
| 광고 타입 |
| 사이트 ID |
| 하위 사이트 ID |
| Sub Param 1 |
| Sub Param 2 |
| Sub Param 3 |
| Sub Param 4 |
| Sub Param 5 |
| 비용 모델 |
| 비용 값 |
| 비용 통화 |
| Contributor 1 Partner |
| Contributor 1 Media Source |
| Contributor 1 Campaign |
| Contributor 1 Touch Type |
| Contributor 1 Touch Time |
| Contributor 2 Partner |
| Contributor 2 Media Source |
| Contributor 2 Campaign |
| Contributor 2 Touch Type |
| Contributor 2 Touch Time |
| Contributor 3 Partner |
| Contributor 3 Media Source |
| Contributor 3 Campaign |
| Contributor 3 Touch Type |
| Contributor 3 Touch Time |
| Region |
| Country Code |
| state |
| City |
| Postal Code |
| dma |
| IP |
| wifi |
| operator |
| 통신사 |
| language |
| AppsFlyer ID |
| Advertising ID |
| IDFA |
| 안드로이드 ID |
| Customer User ID |
| IMEI |
| IDFV |
| 플랫폼 |
| Device Type |
| OS Version |
| App Version |
| SDK Version |
| 앱 ID |
| App Name |
| 번들 ID |
| Is Retargeting |
| Retargeting Conversion Type |
| Attribution Lookback |
| Reengagement Window |
| Is Primary Attribution |
| User Agent |
| HTTP Referrer |
| Original URL |
추가 정보
특성과 제한 사항
| 항목 | 설명 |
|---|---|
| 필수 API 토큰 유형 |
|
| 광고 네트워크 액세스 | 아니오 |
| 에이전시 액세스 | 예 |
| 에이전시 투명성 | 예. 그러나 에이전시 필터와 미디어 소스 필터를 모두 사용하는 경우 미디어 소스 필터는 투명하지 않은 에이전시에 적용되지 않습니다. 이는 투명하지 않은 에이전시의 경우 필터링된 미디어 소스의 데이터뿐만 아니라 모든 데이터가 포함됨을 의미합니다. |
| 앱 별 통화 | 예 |
| 앱 별 시간대 | 예 |
| 데이터 최신성 |
|
| 과거 데이터 | 네. 리텐션 및 속도 제한 정책에 따릅니다. |
| 논오가닉 데이터 | 예 |
| 오가닉 데이터 | 예 |
| 콜 수 제한 |
로데이터에 대한 API 제한. |
| 사이즈 제한 |
|
| Install_date from 및 install_date_to | 인스톨 날짜 범위는 활동 날짜 범위 이전이어야 합니다. |
문제 해결
| 증상/메시지 | 해결 방안 |
|---|---|
| 리포트에 선택한 시간 범위에 따라 예상된 데이터가 포함되어 있지 않거나 로데이터 리포트와 집약형 데이터 리포트 간에 불일치가 있습니다. |
|