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

마스터 API:

• 선택한 LTV, 액티비티, 리텐션, 코호트 및 Protect360 캠페인 성과 KPI를 가져올 수 있습니다. 사용 가능한 KPI는 개요, 액티비티, 리텐션, 코호트, 및 Protect360 대시보드에 있는 KPI와 동등한 KPI입니다.
• 매일 계산됩니다. 업데이트된 데이터는 앱 별 시간대에 따라, 24-48시간 내에 사용 가능합니다.
• 앱스플라이어 피벗 테이블의 기반이 되는 인프라 구조입니다.  

마스터 API를 사용하려면 보려는 데이터를 정의합니다( Pull API구현과 유사). 결과는 CSV 또는 JSON 파일로 반환됩니다.  

마스터 API 사용 방법:

1. altAppsFlyerAdmin_us-en.png API 토큰을 받으세요. 관리자가 토큰을 가져와야 합니다.
2. 인증 헤더에 사용할 API 토큰을 귀사의 개발자에게 제공하세요.
3. 다음 절에 설명한 데 따라 개발자에게 API 호출을 할 때 입력할 파라미터를 제공합니다. 파라미터는 리포트의 중점 사항, 구성 방법을 결정하고 리포팅 기간을 제공합니다.
4. 개발자에게 개발자 허브에서 마스터 API 지침을 따르도록 하십시오.

5. API 파라미터

   파라미터	값	필수
   app_id	앱스플라이어에서 확인되는 앱 식별자입니다. 앱스플라이어에서 찾은대로 정확하게 앱 ID를 입력하십시오. iOS 앱은 접두사 id를 붙입니다. 모든 앱 ID를 사용하여 모든 앱 쿼리	예
   부터	LTV 어트리뷰션 날짜 기간의 하한입니다. 형식: yyyy-mm-dd 형식의 문자열 예: from: 2020-01-02	예
   부터까지	LTV 어트리뷰션 날짜 기간의 상한입니다. 기간 범위 내의 일 수: 1-31 일 7일   형식: yyyy-mm-dd	예
   그룹화	조회 기준(Group by) 파라미터이며, 쉼표(,)로 구분됩니다. 사용 가능한 목록을 보려면 조회 기준(groupings) 표를 참고하십시오.  예: groupings=pid,geo	예
   KPI	포함할 KPI 목록. 각각은 쉼표로 구분됩니다. KPI 목록을 보려면 아래의 KPI 표를 참고하십시오. 예: kpis=installs,clicks, impressions,sessions,retention_day_7	예
   필터	하나 또는 그 이상의 필터 옵션을 사용하여 데이터를 필터링할 수 있습니다.	아니요
   통화	데이터를 앱 별 통화를 사용해 리턴하려면, currency=preferred 를 설정합니다.	아니요
   시간대	데이터를 앱 고유 시간대를 사용해 리턴하려면, timezone=preferred를 설정합니다.   현지화 규칙 참조	아니요
   형식		아니요

   그룹화

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

   그룹별로 API 이름	조회 기준(Group by) 표시 이름	LTV KPI	리텐션 KPI	액티비티 KPI	Protect360	코호트
   app_id	앱 ID	예	예	예	예	예
   pid	미디어 소스	예	예	예	예	예
   af_prt	에이전시	예	예	예	예	아니요
   c	캠페인	예	예	예	예	예
   af_adset	광고세트	예	예	예	아니오	아니요
   af_ad	Ad	예	예	예	아니오	아니요
   af_채널	채널	예	예	예	예	아니요
   af_siteid	퍼블리셔 ID	예	예	예	예	예
   af_키워드	키워드	예	예	예	아니오	아니요
   1차 어트리뷰션	1차 어트리뷰션 여부	예	아니오	Yes	예	아니요
   af_c_id	캠페인 ID	예	아니오	Yes	예	아니요
   af_adset_id	광고세트 ID	예	아니오	예	아니오	아니요
   af_ad_id	광고 ID	예	아니오	예	아니오	아니요
   설치 시간	설치 시간	예	예	예*	예	예
   attributed_touch_type	Touch Type	예	예	예	예	아니요
   geo	지역	예	예	예	예	예
   * 활동 KPI 컨텍스트에서 인스톨 시간은 이벤트 시간으로 간주됩니다.

   KPI

   KPI는 앱에 대한 인사이트를 얻기 위해 사용되는 지표입니다.

   LTV

   라이프타임 값(LTV) - 인스톨 날짜로 그룹화되어 오늘까지 집계된 종합 이벤트

   KPI API 이름	설명
   노출	선택한 기간 동안 노출 수
   클릭	선택한 기간 동안 클릭 수
   설치	선택한 기간 동안 인스톨 수
   cr	전환율
   세션(Sessions)	선택한 기간 동안 앱을 설치한 사용자가 수행한 세션 수
   loyal_users	선택한 기간 동안 앱을 설치한 사용자 중 충성 고객 수
   loyal_users_rate	Loyal Users/Installs
   비용	선택한 기간 동안의 총 비용 *제한 사항 참조
   수익	선택한 기간 동안 앱을 설치한 사용자가 현재까지 누적으로 발생시킨 수익
   ROI	특정 기간에 대한 투자 대비 수익률. Return on Investment
   arpu_ltv	선택한 기간 동안 앱을 설치한 사용자의 사용자 별 평균 수익. Average revenue per user
   average_ecpi	특정 기간에 동안의 인스톨 당 효과 비용(eCPI, Effective Cost per Installation). 비용과 인스톨 수가 API 호출에 포함된 경우에만 사용 가능합니다.
   앱 삭제	선택한 기간 동안 앱을 설치한 사용자 중 앱을 삭제한 사용자
   uninstalls_rate	앱 삭제 비율
   event_counter_[event_name]	이벤트가 발생한 횟수
   unique_users_[event_name]	이벤트를 수행한 고유 유저 수
   sales_in_usd_[event_name]	리포트된 이벤트의 일부로서 리포트된 수익

   잔존율

   리텐션은 앱에 얼마만큼의 유저가 활동하고 있는지에 대해 보여줍니다.

   참고: 

   • 최대 리텐션 기간은 인스톨 후 day 30이며, 여기서 앱 인스톨 날짜는 day 0입니다. 즉, [x] 값은 30을 초과할 수 없습니다.  
   • retention_day_1을 요청하면 해당 날짜의 데이터가 사용 가능하기 전에 해당 날짜에 대한 지표는 이전 날짜에 인스톨한 사용자와 관련된 것입니다. 예를 들어 1월 2일에는 1월 1일에 인스톨을 수행한 사용자에 대해 retention_day_1을 요청합니다. 지표가 아직 사용 가능하지 않으므로 리턴하는 지표는 12월 31일에 인스톨한 사용자와 관련됩니다.  

   KPI	설명
   retention_day_[x]	Day X에 보유한 사용자 수
   retention_rate_day_[x]	인스톨 사용자 중 Day X에 보유한 사용자 수 비율

   액티비티(Activity)

   선택된 기간의 앱 액티비티 참고:

   KPI	설명
   activity_average_dau	선택한 기간 동안 평균 일일 실 사용 유저 수 (DAU, Daily Active User)
   activity_average_mau	선택한 기간 동안 평균 월간 실 사용 유저 수 (MAU, Monthly Active User). 하나의 MAU 일은 이전 30일 동안의 고유 사용자(unique user)를 표시.
   activity_average_dau_mau_rate	평균 DAU/MAU 비율
   activity_average_arpdau	일별 실 사용 유저 당 평균 매출 - 모든 고유 사용자의 특정 일자 평균 매출
   activity_sessions	선택한 기간 동안 발생한 세션 수
   activity_revenue	선택한 기간 동안 리포트된 매출
   activity_event_counter_[event_name]	선택한 기간 동안 사용자가 생성한 이벤트 수
   activity_sales_in_usd_[event_name]	선택한 기간 동안 리포트된 이벤트의 일부로서 리포트된 매출
   activity_average_unique_users_[event_name]	선택된 기간 동안 지정된 이벤트를 수행한 평균 고유 사용자

   코호트

   앱스플라이어의 코호트는 광고주에게 서로 다른 시간 기간에 걸쳐 여러 코호트에 대해 다양한 척도를 보고 비교할 수 있는 기능을 제공합니다.

   참고:

   • 사용자 당 매출은 9/100000=0.00009 입니다. 표시되는 값은 0 입니다.  
   • 코호트 일수 코호트 일수: 최대 코호트 일수는 인스톨 후 90일이며, 여기서 day 0은 앱 설치일입니다. 코호트 일수 값 [x] 범위는 1-90 사이여야 합니다.   참고: cohort_day_0는 코호트 대시보드에서 지원되더라도 마스터 API에서는 지원되지 않습니다.  
   • Master API V2  

   세션

   KPI	설명
   cohort_day_[x]_total_sessions_per_user	Cohort Day x - day x 까지 유저 당 누적 세션 (day x 포함)
   cohort_day_[x]_sessions_per_user	Cohort Day x - 코호트에서 오직 day x의 세션
   cohort_[x]_days_total_sessions_per_user	특정하는 KPI인 Cohort_day_1_total_sessions_per_user를 URL에서 Cohort_day_x_total_sessions_per_user로 바꿉니다.

   수익

   KPI	설명
   cohort_day_[x]_total_revenue_per_user	Cohort Day x - day x 까지 유저 당 누적 매출 (day x 포함)
   cohort_day_[x]_revenue_per_user	Cohort Day x - 코호트에서 오직 day x에 수신한 ARPU
   cohort_[x]_days_total_revenue_per_user	특정하는 KPI인 Cohort_day_1_total_revenue_per_user를 Cohort_day_x_total_revenue_per_user로 바꿉니다.
   cohort_day_[x]_total_event_[eventname]_revenue_per_user	코호트 Day x 특정 인앱 이벤트에 따른 사용자당 누적 수익
   cohort_day_[x]_event_[eventname]_revenue_per_user	코호트 Day x 특정 인앱 이벤트에 따른 사용자당 수익

   이벤트

   KPI	설명
   cohort_day_[x]_total_event_[eventname]_per_user	Cohort Day x - day x 까지 유저 당 누적 이벤트 (day x 포함)
   cohort_day_[x]_event_[eventname]_per_user	Cohort Day x - 코호트에서 오직 day x에 수신한 이벤트
   cohort_[x]_days_total_event_[eventname]_per_user	특정하는 KPI 이벤트를 Cohort_day_x_total_events_per_user로 바꿉니다.

   Protect360

   Protect360 KPI

   설명	KPI
   인스톨
   합계	protect360_total_installs
   차단 수	blocked_installs
   차단율 %	blocked_installs_rate
   포스트 어트리뷰션	post_attribution_installs
   포스트 어트리뷰션 %	post_attribution_installs_rate
   총 프로드 인스톨	total_fraudulent_installs
   프로드 인스톨 %	fraudulent_installs_rate
   가짜 설치
   실시간 차단	real_time_fake_installs
   포스트 어트리뷰션 프로드	post_attribution_fake_installs
   하이재킹된 인스톨
   실시간 차단	real_time_hijacked_installs
   포스트 어트리뷰션 프로드	post_attribution_installs_hijacked_installs
   유효성 검증 규칙
   차단된 인스톨	validation_rules_blocked_installs
   차단된 어트리뷰션	validation_rules_blocked_attribution
   허위 인스톨 차단 상세
   차단된 사이트 ID 블랙리스트	blocked_installs_siteid_blacklist
   포스트 어트리뷰션 사이트 ID 블랙리스트	post_attribution_installs_siteid_blacklist
   차단된 봇	blocked_installs_bots
   포스트 어트리뷰션 봇	post_attribution_installs_bots
   차단된 행동 이상 현상	blocked_installs_behavioral_anomalies
   포스트 어트리뷰션 이상 행동(behavioral anomalies)	post_attribution_installs_behavioral_anomalies
   차단된 인스톨 유효성 검증	blocked_installs_install_validation
   하이재킹 인스톨 차단 상세
   차단된 인스톨 하이재킹	blocked_installs_install_hijacking
   포스트 어트리뷰션 인스톨 하이재킹	post_attribution_installs_installs_hijacking
   차단된 CTIT 이상 현상	blocked_installs_ctit_anomalies
   포스트 어트리뷰션 CTIT 이상현상	post_attribution_installs_ctit_anomalies
   차단된 클릭 플러딩	blocked_installs_click_flood
   포스트 어트리뷰션 클릭 플러딩	post_attribution_installs_click_flood
   클릭
   합계	protect360_total_clicks
   차단 수	blocked_clicks
   %	blocked_clicks_rate
   인앱 이벤트
   합계	protect360_total_in_apps
   차단 수	blocked_in-app-events
   %	blocked_in-app-events_rate
   디바이스 팜 지표 - 뉴 디바이스
   인스톨	install_fraud_new_devices_total
   설치 %	install_fraud_new_devices_total_installs_rate
   충성 유저 %	install_fraud_new_devices_total_loyal_user_rate
   디바이스 팜 지표 - LAT 디바이스
   인스톨	install_fraud_lat_devices_total
   설치 %	install_fraud_lat_devices_total_installs_rate
   충성 유저 %	install_fraud_lat_devices_total_loyal_user_rate
   클릭 플러딩 지표
   전환율	conversion_rate
   클릭 도배 지표 - CTIT
   60분 이상	click_flood_over_1_hour_rate
   5시간 이상	click_flood_over_5_hours_rate

   계산된 KPI

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

   계산된 KPI 수식을 위해, 몇 개 든지의 기본 KPI 개체를 삽입할 수 있습니다. 각 계산 KPI 개체에는 키와 값이 포함됩니다. 키는 KPI에 지정한 이름이고 값은 KPI 수식입니다.

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

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

    예시

   첫 3 일의 리텐션 모음

   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

   코호트 day 7의 ROI

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

   필터 (선택적)

   파라미터	설명	예시	필수적?
   pid	특정 미디어 소스가 표시된 행을 선택하는데 사용됩니다. 쉼표(,)로 구분된 다중 선택이 지원됩니다.	pid=organic,applovin_int	아니요
   c	캠페인 이름으로 필터링하는 데 사용됩니다. 쉼표(,)로 구분된 다중 선택이 지원됩니다.	c=my_sample_campaign	아니요
   af_prt	에이전시 이름으로 필터링하는 데 사용됩니다. 쉼표(,)로 구분된 다중 선택이 지원됩니다.	af_prt=moburst	아니요
   af_채널	채널 이름으로 필터링하는 데 사용됩니다. 쉼표(,)로 구분된 다중 선택이 지원됩니다.	af_channel=Instagram	아니요
   af_siteid	퍼블리셔 ID를 기준으로 필터링하는 데 사용됩니다. 쉼표(,)로 구분된 다중 선택이 지원됩니다.	af_siteid=12345678	아니요
   geo	국가별로 필터링하는 데 사용됩니다. 쉼표(,)로 구분된 다중 선택이 지원됩니다.	geo=US,DE	아니요

   현지화

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

   다음 사항이 적용됩니다.

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

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

   파라미터	설명	예시	필수적?
   통화	앱 별 설정한 통화에 따른 금전적 값.	currency=preferred	아니요
   시간대	앱 별 설정한 시간대에 따라 시간대 사용.	timezone=preferred	아니요

추가 정보