마스터 API—API를 통한 유저 인입 지표

https://hq.appsflyer.com/export/master_report/v4?api_token=api_token &app_id=app_id&from=yyyy-mm-dd&to=yyyy-mm-dd&groupings=groupings&kpis=kpis

호출 파라미터

파라미터	value	필수적
api_token	계정 관리자가 토큰을 검색해야 합니다. 토큰을 검색하려면, 계정에서 이메일 > API 토큰을 클릭합니다.	네
app_id	앱스플라이어에서 확인되는 앱 식별자입니다. 앱스플라이어에서 찾은대로 정확하게 앱 ID를 입력하십시오. iOS 앱은 접두사 id를 붙입니다. 모든 앱을 조회하려면 app_id=all 을 사용하십시오.	예
from	LTV 어트리뷰션 날짜 기간의 하한입니다. 형식: 스트링 yyyy-mm-dd 예시: 시작 날짜: 2020-01-02	네
활용	LTV 어트리뷰션 날짜 기간의 상한입니다. 기간 범위 내의 일 수: 1-31 일 하루에 대해서는: from 과 to 값이 동일합니다.  형식: yyyy-mm-dd 예시: 시작 날짜: 2021-01-01, 마감 날짜: 2021-01-31은 31일입니다.	네
그룹화	조회 기준(Group by) 파라미터이며, 쉼표(,)로 구분됩니다. 사용 가능한 목록을 보려면 조회 기준(groupings) 표를 참고하십시오.  예: groupings=pid,geo	네
KPI	포함할 KPI 목록. 각각은 쉼표로 구분됩니다. KPI 목록을 보려면 아래의 KPI 표를 참고하십시오. 예:kpis=installs,clicks, impressions,sessions,retention_day_7	네
필터	하나 또는 그 이상의 필터 옵션을 사용하여 데이터를 필터링할 수 있습니다.	아니요
currency	데이터를 앱 별 통화를 사용해 리턴하려면, currency=preferred 를 설정합니다.	아니요
시간대	데이터를 앱 고유 시간대를 사용해 리턴하려면, timezone=preferred를 설정합니다.  현지화 규칙을 참조하십시오.	아니요
format	기본으로, 응답 데이터는 CSV 파일 형식으로 받아집니다. JSON 형식으로 받고싶은 경우, URI에 &format=json 를 추가합니다.	아니요

이러한 디멘션은 정보를 쉽고 정확하게 조사할 수 있도록, 데이터를 그룹 별로 수집하는 데 사용됩니다. 이 필드의 설명은 여기에서 확인할 수 있습니다.

KPI는 앱에 대한 인사이트를 얻기 위해 사용되는 지표입니다. KPI는 다음 탭에서의 유형에 따라 분류됩니다. 

계산된 KPI

앞서 설명한 KPI에 더하여, 마스터 API 리포트에 계산된 KPI를 추가할 수 있습니다. 이렇게 하면 마스터 API 리포트에 자체 계산된 리포트를 포함시킬 수 있습니다.

계산된 KPI 수식을 위해, 몇 개 든지의 기본 KPI를 삽입할 수 있습니다.

표준 산술 연산자가 지원됩니다: 더하기(+)는 인코딩 되어 %2b, 빼기(-), 곱하기(*), 나누기(/)는 %2f 로 인코딩 됩니다.

계산된 KPI 필드 이름은 반드시 "calculated_kpi_"로 시작하여 유효한 스트링으로 이어져야 합니다. 예, "calculated_kpi_purchaserate"

kpis=installs,loyal_users_rate&calculated_kpi_3days_retention=
retention_day_1%2Bretention_day_2%2Bretention_day_3

kpis=installs&calculated_kpi_rev_per_impression=revenue%2Fimpression

kpis=installs,roi,arpu_ltv,cost,revenue&calculated_kpi_roi_day_7=
(cohort_day_7_total_revenue_per_user-average_ecpi)%2Faverage_ecpi

다음의 기간 세분성 옵션을 사용할 수 있음: 일간.

To 와 From 시간 기간 필드를 사용하여, 원하는 세분성과 시간 기간 선택을 결정합니다.

로컬 통화 및 앱 별 시간대는 앱 설정 페이지에 설정되어 있습니다. 마스터 API 데이터는 시스템 기본 통화 및 시간대를 사용하거나 앱 별 설정된 시간대와 통화를 사용하여 데이터를 추출할 수 있습니다. 

다음 사항이 적용됩니다.

• 앱 별 시간대/통화를 사용하는 것은 모든 앱이 동일한 시간대/통화를 설정한 경우에만 지원됩니다. 그렇지 않으면, UTC 시간대와 USD 가 사용됩니다. 시간대와 통화는 별도로 분리되어 있습니다. 즉, 모든 앱의 통화 설정은 동일한데 시간대는 그렇지 않다면, 앱 별 통화는 사용할 수 있지만, 앱 별 시간대는 사용할 수 없습니다. 
• 대시보드에서 선호하는 시간대가 요청한 시간 기간 이내에 변경되었다면, 생성하는 리포트는 가장 최근의 시간대 변경 이후의 값만 포함합니다.

다음 파라미터를 사용하여 앱 별 설정을 선택하십시오. 참고: 만약 preferred 파라미터를 사용하지 않는 경우, 기본 설정인 USD 통화와 UTC 시간대를 갖게 됩니다.

마스터 API 결과를 시간대에 맞춰 표시하려면, 반드시 timezone=preferred 파라미터를 사용해야합니다.

페이스북 광고 성과 비교:

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp&from=[from_date]&to=[to_date]&pid=facebook
&groupings=pid,c,af_adset_id,af_ad_id
&kpis=installs,clicks,impressions,sessions,loyal_users,cost,revenue,arpu_ltv,roi

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp,id123456789&from=[from_date]&to=[to_date]&pid=googleadwords_int
&groupings=pid,c,af_adset_id,af_ad_id
&kpis=installs,sessions,loyal_users,cost,revenue,arpu_ltv,roi

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=all&from=[from_date]&to=[to_date]&groupings=geo,pid,c&kpis=
installs,clicks,impressions,sessions,loyal_users,cost,revenue,arpu_ltv,
roi&geo=us,ca	

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp&from=[from_date]&to=[to_date]&groupings=af_keywords
&kpis=roi,arpu_ltv,average_ecpi,installs,loyal_users_rate,cost,revenue

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp,id123456789&from=[from_date]&to=[to_date]&groupings=af_prt,pid,c&kpis=installs,
loyal_users_rate

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp&from=[from_date]&to=[to_date]&groupings=af_siteid&pid=affiliates
&kpis=installs,loyal_users_rate,arpu_ltv,retention_day_1,retention_rate_day_1,
retention_day_7,retention_rate_day_7,retention_day_15,retention_rate_day_15,
retention_day_30,retention_rate_day_30

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=com.greatapp,id123456789&from=[from_date]&to=[to_date]&groupings=attributed_touch_type
&kpis=installs,sessions,loyal_users_rate,arpu_ltv

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]
&app_id=all&from=[from_date]&to=[to_date]&groupings=pid,c
&kpis=installs,loyal_users_rate,retention_day_1,retention_rate_day_1,
retention_day_7,retention_rate_day_7,retention_day_15,retention_rate_day_15,
retention_day_22,retention_rate_day_22,retention_day_30,retention_rate_day_30

• 비용 데이터:
  • 광고 세트, 광고, 지역, 채널 및 사이트 ID를 의미하는 다른 비용 차원의 가용성은 ad network dependant입니다. 
  • eCPI를 얻는 방법: 비용 데이터가 가능한 상황에서, 호출에 인스톨과 비용을 모두 포함하십시오. 
  • 일반적으로, 링크에 비용 파라미터를 가진 앱스플라이어 링크를 사용하는, 온드 미디어(owned media)를 포함한 모든 소스는 요청된 기준에 관계없이 비용 데이터를 완전히 지원합니다. 자체 API를 가진 SRN(self-reporting network)은 일반적으로 가능한 기준 중 오직 일부 기준의 비용 데이터만 지원합니다. 예를 들어 Facebook은 동일한 호출에서 지역 및 채널별 그룹화를 지원하지 않습니다. 둘 중 하나를 개별적으로 그룹화할 수 있습니다.
• 그룹화: 특정 그룹화는 오직 LTV KPI, 액티비티 또는 리텐션 KPI에 대해서만 사용할 수 있습니다. 특정 KPI를 위한 데이터가 가능하지 않을 때는 API가 N/A라고 리턴합니다. 예를 들어, af_channel로 그룹화한 retention_rate_day_7d 요청은 “N/A” 로 반환됩니다.
• 리포트당 최대 행 개수: 200K
• 이벤트 이름: 마스터 API는 현재 슬래시 /가 있는 이벤트 이름을 지원하지 않습니다. 이 제한사항을 해결하려면 이벤트 이름에 /를 사용하지 마십시오.