마스터(Master) API 사용하기—캠페인 성과 KPI

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

호출 파라미터

파라미터	value	필수적
api_token	계정 어드민이 토큰을 가져와야 합니다. 토큰을 확인하려면, 계정에서 email 주소 > API Tokens를 클릭합니다.	네
app_id	앱스플라이어에서 확인되는 앱 식별자입니다. 앱스플라이어에서 찾은대로 정확하게 앱 ID를 입력하십시오. iOS 앱은 접두사 id를 붙입니다.	예
from	LTV 어트리뷰션 날짜 기간의 하한입니다. 형식: 스트링 yyyy-mm-dd 예: "from": "2020-01-02"	네
활용	LTV 어트리뷰션 날짜 기간의 상한입니다. 기간 범위 내의 일 수: 1-31 일 하루에 대해서는: from 과 to 값이 동일합니다.  형식: yyyy-mm-dd 예: "from": "2020-01-01", "to": 2020-01-31 는 31 일 입니다.	네
그룹화	조회 기준(Group by) 파라미터이며, 쉼표(,)로 구분됩니다. 사용 가능한 목록을 보려면 조회 기준(groupings) 표를 참고하십시오.  예: groupings=pid,geo	네
KPI	포함할 KPI 목록. 각각은 쉼표로 구분됩니다. KPI 목록을 보려면 아래의 KPI 표를 참고하십시오. 예:kpis=installs,clicks, impressions,sessions,retention_day_7	네
필터	하나 또는 그 이상의 필터 옵션을 사용하여 데이터를 필터링할 수 있습니다.	아니요
currency	데이터를 앱 별 통화를 사용해 리턴하려면, currency=preferred 를 설정합니다.	아니요
timezeone	데이터를 앱 별 시간대를 사용해 리턴하려면, 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 시간 기간 필드를 사용하여, 원하는 세분성과 시간 기간 선택을 결정합니다.일간 또는 주간 단위 세분성을 선택한 대로, KPI가 표시됩니다.
• 주 별 또는 일 별 단위 세분성을 선택하는 경우, 선택한 KPI가 해당하는 세분성에 대응하는지 확인합니다. 더 자세한 내용은 여기를 클릭하십시오.
• 정확한 주 번호는 여기에서 찾을 수 있습니다.

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

다음 사항이 적용됩니다.

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

다음 파라미터를 사용하여 앱 별 설정을 선택하십시오. 참고: 만약 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

• 비용 데이터: 
  • eCPI를 포함한 비용 데이터가 항상 가능하지는 않을 수 있습니다. 이것은 네트워크가 비용 데이터를 지원하는지, 네트워크 유형 (앱스플라이어 링크 사용 또는 self-reporting) 또는 호출한 디멘션에 따라 달라집니다. 비용 데이터가 가능한 상황에서 eCPI를 얻으려면, 호출에 인스톨과 비용을 모두 포함하십시오.
  • 일반적으로, 링크에 비용 파라미터를 가진 앱스플라이어 링크를 사용하는, 온드 미디어(owned media)를 포함한 모든 소스는 요청된 디멘션에 관계없이 비용 데이터를 완전히 지원합니다. 자체 API를 가진 SRN(self-reporting network)는 일반적으로 가능한 디멘션 중 오직 일부 디멘션의 비용 데이터만 지원합니다.
  • 예를 들어, 페이스북은 지역 및 채널 조회 기준(grouping by)을 동시에 지원하지 않습니다. (각각 따로 조회하는 것은 지원됩니다.)
  • 비용 데이터를 지원하는 애드 네트워크 전체 목록은 여기에서 확인하십시오.
• 조회 기준(Grouping): 특정 조회 기준은 오직 LTV KPI, 액티비티 또는 리텐션 KPI에 대해서만 사용할 수 있습니다. 특정 KPI를 위한 데이터가 가능하지 않을 때는 API가 N/A 라고 리턴합니다. 예를 들어, af_channel로 조회 기준 설정한 retention_rate_day_7d 요청은 “N/A” 로 반환됩니다.

• 최대 행 갯수: 200,000