요약: URI를 사용하여 로데이터 리포트를 CSV 파일로 가져옵니다.
Pull API 로데이터 특성
- 로데이터 리포트 내용 설명.
- 보고서는 CSV 파일로 반환됩니다.
- 필터 기준 옵션은 미디어소스, 날짜 범위, 인앱이벤트 이름 및 지역입니다.
- 시간대 및 통화는 선택 가능합니다.
- Pull API는 계정 사용자와 BI 개발자에게 적합합니다.
- 계정 사용자는 URL을 브라우저에 붙여 넣음으로써 리포트를 받을 수 있습니다. URI는 개발 허브에서 만들어집니다.
- BI 개발자용 Pull API 는 스크립트에 URI를 포함시켜 리포트를 가져옵니다.
- 속도 제한: 할당량 메커니즘은 하루에 생성할 수 있는 리포트의 수를 제한합니다.
관련 자료: 올바른 데이터 전달 도구/리포팅 API 선택하기
용어
| 용어 | 설명 |
|---|---|
| Pull API |
URI를 사용하여 CSV 리포트를 다운로드 하는 솔루션. |
| API 호출(call) 또는 호출 |
브라우저 주소창에 붙여 넣거나 스크립트를 사용하여 URI를 앱스플라이어에 전송. |
| URI |
|
계정 사용자용 안내서
URI 템플릿
- dev hub에서 확인되는 URI 템플릿은 앱 ID와 보고서 유형 값이 채워져 있습니다.
- API V1.0 토큰과 기간의 시작과 끝 날짜를 편집해야 하는 플레이스홀더를 가지고 있습니다.
- URI에서 물음표(?) 오른쪽 부분은 파라미터를 포함합니다. 각 파라미터는 앰퍼샌드 기호(&)로 시작합니다. 파라미터는 조회 기준을 설정하고, 포함할 추가 필드, 통화 및 시간대를 지정하는 데 사용됩니다. 예를 들어, 로데이터 리포트에서 특정 미디어소스로 (조회 기준을) 제한하려면, media_source 파라미터를 사용하십시오.
&media_source=facebook - Pull API에 대해 더 살펴보려면, 이어지는 안내 설명을 참고하십시오.
- 포스트백 URI는 대시보드에서 사용할 수 없습니다. 스프레드 시트의 포스트백 URI를 사용합니다.
Pull API 리포트 내려받기 설명서
개발 허브를 사용하면 사용자 지정 데이터를 쉽게 입력하고 리포트를 다운로드하여 테스트할 수 있습니다.
시작하기 전에:- 어드민 관리자에게 대시보드에서 확인한 Pull API 토큰을 전해달라고 요청하십시오.
개발 허브에서 리포트를 다운로드하려면:
-
앱스플라이어 개발 허브 API 참조로 이동합니다.
-
왼쪽 메뉴에서 리포트 유형을 선택합니다.
예를 들어 로데이터 리포트(논오가닉) > 인스톨.
모든 리포트 유형 목록은 아래 표를 참조하십시오. - 모든 필수 필드를 작성하십시오
- URI 템플릿이 오른쪽에 표시됩니다.
- 복사 아이콘을 클릭하여 URI를 복사합니다.
- 브라우저에서 새 탭을 열고 URI를 붙여 넣습니다.
- <Enter> 키를 눌러 API 호출을 보냅니다.
리포트가 다운로드됩니다.
| 리포트 | 설명 | 업데이트 빈도 |
|---|---|---|
| 로데이터 리포트 (논오가닉) | ||
| 인스톨 | 논오가닉 인스톨을 기록합니다. 사용자가 앱을 처음 열 때 레코드가 생성됩니다. |
실시간 |
| 인앱 이벤트 | 사용자가 수행한 이벤트를 기록합니다. |
실시간 |
| 앱 삭제 | 사용자가 앱을 삭제할 때 기록합니다. |
일별 |
| 리인스톨 |
앱을 삭제한 후 UA 미디어 소스에 참여하고 리어트리뷰션 기간 동안 앱을 다시 인스한 사용자를 기록합니다. | 실시간 |
|
로데이터 리포트(오가닉) |
||
| 오가닉 인스톨 |
사용자가 앱을 처음 열었을 때를 기록합니다. |
계속 |
| 오가닉 인앱 이벤트 |
사용자가 수행한 이벤트에 대한 세부 정보를 기록합니다. |
계속 |
| 오가닉 앱 삭제 |
앱을 삭제하는 사용자를 기록합니다. |
일별 |
| 오가닉 앱 리인스톨 |
리인게이지먼트 기간 동안 리타게팅 미디어 소스로 인한 사용자의 광고 수익을 기록합니다. |
일별 |
|
광고 수익 로데이터 |
||
|
어트리뷰션된 광고 수익 |
미디어 소스로 어트리뷰트한 사용자의 광고 수익을 기록합니다. | 일별 |
| 오가닉 광고 수익 | 미디어 소스에 어트리뷰트되지 않은 사용자의 광고 수익을 기록합니다. | 일별 |
| 프로텍트360 프로드(fraud) | ||
| 인스톨 | 사기로 식별되어 미디어 소스에 어트리뷰트되지 않은 인스톨을 기록합니다. | 실시간 |
| 포스트 어트리뷰션 인스톨 | 사기 설치로 한 인해 전허 어트리뷰트되지 않은 인앱이벤트를 기록합니다. | 실시간 |
| 인앱 이벤트 | Protect360에서 사기로 식별된 인앱이벤트를 기록합니다. | 일별 |
| 포스트 어트리뷰션 인앱 이벤트 | 인스톨 자체와 상관없이 미디어 소스에 어트리뷰트되거나 사기로 판단된 후 사기로 식별된 인스톨에 대한 인앱이벤트를 기록합니다. | 일별 |
| 클릭 | Protect360에 의해 차단된 사용자가 수행한 클릭을 기록합니다. | 일별 |
| 차단된 인스톨 포스트백 | 인스톨이 차단된 미디어 소스로 전송된 포스트백 사본을 기록합니다. | 실시간 |
| 포스트백 | ||
| 인스톨 포스트백 | 사용자가 앱을 처음 열 때 생성된 인스톨 이벤트를 기록합니다. | 일별 |
| 인앱 이벤트 포스트백 | 미디어 소스로 전송된 인앱이벤트 포스트백을 기록합니다. | 일별 |
| 리타게팅 인앱이벤트 포스트백 | 리인게이지먼트 기간 동안 사용자가 수행한 인앱이벤트를 기록합니다. | 실시간 |
| 리타게팅 전환 포스트백 | 리인게이지먼트 기간 동안 사용자가 수행한 인앱이벤트를 기록합니다. | 실시간 |
로데이터 Pull API 파라미터
URI 파라미터 로데이터
| 파라미터 | 설명 |
|---|---|
| api_token | API 인증 토큰. 예제 호출에서 이 부분은 <API TOKEN HERE>라고 표시됩니다. |
| from |
|
| 활용 |
종료일. from으로 부터 시작해서 마치는 날.
|
| 파라미터 | 설명 |
|---|---|
|
media_source |
|
| maximum_rows |
단일 API 호출에 의해 반환된 최대 행 수입니다.
|
| event_name |
인앱이벤트를 지정된 이벤트별로 필터합니다. 쉼표로 구분된 목록을 사용하여 다중 이벤트를 선택합니다. 예: |
| reattr |
리타게팅 어트리뷰션 데이터를 설정합니다.
|
| additional_fields |
기본 필드 외에 추가 필드를 가져오기 위한 것입니다. 예: |
| currency |
수익 및 비용의 통화
예: 앱 고유 통화가 EUR이면 |
| 시간대 |
[기본값] UTC를 사용하여 데이터가 반환됩니다.
|
| 지역 |
데이터를 국가 코드로 필터링합니다. 제한: API 호출당 하나의 국가 코드 필터만 선택할 수 있습니다. 예: |
프로텍트360
날짜 및 시간별 시간 범위
결과가 최대값을 초과할 경우 시간과 분을 사용하여 리포트를 분할합니다. 다음을 적용합니다.
- 시작/마감: 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 파라미터를 사용하십시오.
- 필드는 한 번만 기재합니다.
- 사용 가능한 필드 목록을 참조하십시오.
- 일부 URI 예에는 추가 필드가 포함되어 있습니다. 필요한 경우 필드를 더 추가하십시오.
-
Example:
additional_fields=device_download_time,deeplink_url - 항상 아래 표에 기재된 필드에 대한 결과가 반환됩니다.
예시
추가 필드를 가진 URI 호출 예:
https://hq.appsflyer.com/export/<APP ID HERE>/installs_report/v5?
api_token=<API TOKEN HERE>&from=yyyy-mm-dd&to=yyyy-mm-dd
&additional_fields=device_download_time,deeplink_url기본 Pull API 필드
| 기본 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 |
개발자를 위한 Pull API
스크립트를 사용한 Pull API 로데이터를 구현하려면 Pull API 집약형 데이터 기사를 읽어보십시오.
추가 정보
API V4를 V5로 마이그레이션
로데이터: 2021년 12월 1일부터 V4 API는 소멸되어 플랫폼에서 삭제됩니다. 이날 이전에 V4 사용을 중지하고 V5로 마이그레이션해야 합니다.
API V4를 V5로 마이그레이션하기
V4에서 V5로 마이그레이션할 때 V5에는 항상 반환되는 기본 필드 집합과 Pull API 호출에 명시적으로 추가해야 하는 선택적 추가 필드가 있다는 것을 고려하십시오. 필요한 필드를 가져오려면 API 호출을 조정하십시오. 앱스플라이어는 사용자 인터페이스의 일부 추가 필드로 구성된 템플릿을 제공합니다. 필요에 따라 템플릿을 편집해야 합니다. 사용자 인터페이스에서 API 템플릿 가져오기를 참조하십시오.
특성과 제한 사항
| 항목 | 설명 |
|---|---|
| 필수 API 토큰 유형 |
 V1.0 토큰
|
| 광고 네트워크 액세스 | 아니오 |
| 에이전시 액세스 | 예 |
| 에이전시 투명성 | 예 |
| 앱 별 통화 | 예 |
| 앱 별 시간대 | 예 |
| 데이터 최신성 |
|
| 과거 데이터 | 네. 리텐션 및 속도 제한 정책에 따릅니다. |
| 논오가닉 데이터 | 예 |
| 오가닉 데이터 | 예 |
| 콜 수 제한 |
로데이터에 대한 API 제한. |
| 사이즈 제한 |
|
API 오류 코드 및 트러블슈팅
| 상태 메시지 | 코드 | 증상/메시지 | 해결 방안 |
|---|---|---|---|
| 리포트에 선택한 시간 범위에 따라 예상된 데이터가 포함되어 있지 않거나 로데이터 리포트와 집약형 데이터 리포트 간에 불일치가 있습니다. |
|
||
| OK | 200 | 빈 CSV 파일 |
|
| OK |
200 |
빈 CSV 파일 |
시작 날짜와 종료 날짜가 모두 yyyy-mm-dd 형식인지 확인하십시오. |
| Bad request |
400 |
Raw Reports historical lookback is limited to 90 days. |
|
| Bad request |
400 |
Your API calls limit has been reached for report type |
- |
| Bad request | 400 |
잘못된 제한 유형 |
report_rows는 값 200000 또는 1000000을 가질 수 있습니다. |
| Unauthorized |
401 |
Supplied API token is invalid |
앱스플라이어 어드민 계정에게 현재 토큰을 요청하십시오. |
| Unauthorized |
401 |
Account may be suspended. |
대시보드에 로그인하여 계정 상태를 확인하십시오. |
| Not found |
404 |
|
토큰이 앱과 일치하지 않습니다. 앱스플라이어 어드민 계정에게 현재 토큰을 요청하십시오. |