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