Pull API 집약형 데이터

요약: 이 Pull API를 사용하여 CSV 파일에서 앱스플라이어 집약형 리포트를 가져옵니다.

PullAPIAverage_us-en.png

 Pull API 로데이터를 찾고 계신가요?

여기에서 자세히 알아보세요.

Pull API 집약형 데이터

  • Pull API를 사용하면 유저 인입(UA) 및 리타게팅을 위한 집약형 데이터 리포트를 CSV 파일로 가져올 수 있습니다.
  • 데이터 최신성은 데이터 내보내기 페이지 및 개요 대시보드 페이지에서 동일한 리포트와 같습니다. 비용 데이터를 제공하는 파트너에 따라 몇 시간의 지연으로 비용이 업데이트될 수 있습니다. 
  • 사용 가능한 옵션별 필터: 미디어소스 및 날짜 범위.
  • Pull API의 추가 기능은 다음과 같습니다.
    • 어트리뷰션 터치 유형 추가
    • 시간대 선택 

Pull API를 통해 사용 가능한 집약형 성과 리포트

카테고리  UA 리타게팅*
파트너 (미디어 소스)

파트너 - 날짜별

일별

지역

지역별 날짜별 리포트

* 리타겟팅 리포트의 경우, URI에 &reattr=true 를 추가하십시오.

Pull API 집약형 데이터 사용 

Pull API 집약형 데이터 사용 방법:

  1. AppsFlyerAdmin_us-en.pngAPI 토큰을 가져옵니다. 관리자가 토큰을 검색해야 합니다.
  2. 개발자에게 인증 헤더에 사용할 API 토큰을 제공합니다.
  3. 다음 절에 설명한 데 따라 개발자에게 API 호출을 할 때 입력할 파라미터를 제공합니다. 파라미터는 리포트의 중점 사항, 구성 방법을 결정하고 리포팅 기간을 제공합니다.
  4. 개발자에게 개발자 허브의 Pull API 집약형 데이터 지침을 따르도록 합니다.

파라미터

파라미터 설명
app_id 애플리케이션 ID
from
  • 날짜 기간 범위는 from및 to 파라미터로 구성됩니다. 해당 기간은 LTV (인스톨) 기준 날짜 범위입니다.
  • 형식: yyyy-mm-dd, 
  • 예시: 2010년 1월 1일
활용 종료일. from으로 부터 시작해서 마치는 날.
media_source

특정 미디어 소스로 제한 (필터)하는데 사용합니다.

  • 예시: media_source=facebook
attribution_touch_type

이 파라미터를 다음 예시처럼 설정하여 뷰-쓰루 어트리뷰션 (view-through attribution, VTA) KPI를 확인합니다. 

예시: attribution_touch_type=impression

클릭 수, 노출 수 및 비용 API와 같은 일부 VTA KPI에는 해당하는 값이 없고, 대신 N/A 값이 표시됩니다. 

currency

수익과 비용의 통화.

Pull API 종합 리포트는 항상 앱 별 통화를 사용합니다. 

reattr

리타게팅 전환 데이터 얻기.

  • [기본값] 기본 설정인 false인 경우, 유저 유입 (UA) 캠페인 데이터가 반환됩니다.
  • 참인 경우 리타게팅 전환이 반환됩니다.
  • 예시:reattr=true
시간대

[기본값] UTC를 사용하여 데이터가 반환됩니다.

  • 템플릿 URI는 timezone 파라미터가 앱 별로 설정된 시간대값으로 설정되어 채워집니다. 
  • [기본값] 파라미터가 전송되지 않으면, UTC를 기반으로 데이터가 반환됩니다.
  • 만약timezone=[Joda-Time]으로 보내면, 앱별 시간대를 사용하여 데이터가 반환됩니다.

시간대 선택 관련 참고 사항

  • Joda-Time 시간대 형식은 서머 타임(daylight saving time)을 반영합니다.
  • Joda-Time 값은 앱 설정 페이지의 시간대 값과 동일해야만 합니다. 예를 들어, 앱의 시간대 설정이 Paris라면, Pull API URL의 시간대 값도 timezone=Europe%2fParis 이어야 합니다.
  • 선택한 시간대로 데이터를 가져오는 것은 앱 설정에서 시간대를 설정한 날짜 다음부터만 사용할 수 있습니다. 시간대 설정 변경 이전의 데이터는 UTC 시간대를 사용합니다. 

특성과 제한 사항

항목 설명 
필수 API 토큰 유형 AppsFlyerAdmin_us-en.pngV2.0 토큰
광고 네트워크 액세스 N
에이전시 액세스 Y
에이전시 투명성 Y
앱 별 통화 Y
앱 별 시간대 Y
비용 비용 데이터는 UA 캠페인용입니다. 캠페인(인스톨이 없는 캠페인)을 리타게팅하거나 비활성화하기 위한 것이 아닙니다.
데이터 최신성 계속
과거 데이터 5년
논오가닉 데이터 Y
오가닉 데이터 Y
콜 수 제한

제약 사항

사이즈 제한
  • API 호출은 최대 20만 행을 반환합니다.
  • 리포트에 정확히 20만 개의 행이 있는 경우, 초과되어 누락된 행이 있다고 가정하십시오.
  • 시간을 포함한 from/to 파라미터를 사용하여 API 호출을 여러번 발송하십시오.

일러두기! 로데이터에 대한 Pull API는 백만 행을 지원합니다. 집약형 데이터 리포트는 20만 행으로 제한됩니다. 

캠페인 이름 변경 Pull API 리포트는 캠페인 이름 변경 기능을 지원하지 않습니다.