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

프리미엄

대상:

마케터 개발자

마지막 업데이트: 2023년 06월 29일 11:42

요약: 선택한 LTV, 액티비티, 리텐션, 코호트, 및 Protect360 캠페인 성과 KPI를 API별로 CSV 또는 JSON 형식으로 가져옵니다. 1개 이상의 앱을 선택합니다.

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

마스터 API는:

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

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

마스터 API 사용 방법:

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

API 파라미터

파라미터	value	필수적
app_id	앱스플라이어에서 확인되는 앱 식별자입니다. 앱스플라이어에서 찾은대로 정확하게 앱 ID를 입력하십시오. iOS 앱은 접두사 id를 붙입니다. 모든 앱 ID를 사용하여 모든 앱 쿼리	예
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=preferred 를 설정합니다.	아니요
시간대	데이터를 앱 고유 시간대를 사용해 리턴하려면, timezone=preferred를 설정합니다. 현지화 규칙 참조	아니요
형식	기본으로, 응답 데이터는 CSV 파일 형식으로 받아집니다. JSON 형식으로 받고싶은 경우, URI에 `&format=json` 를 선택하십시오.	아니요

그룹화

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

조회 기준(Group by) API 이름	조회 기준(Group by) 표시 이름	LTV KPI	리텐션 KPI	액티비티 KPI	Protect360	코호트
app_id	앱 ID	예	예	예	예	예
pid	미디어 소스	예	예	예	예	예
af_prt	에이전시	예	예	예	예	아니요
C	캠페인	예	예	예	예	예
af_adset	광고세트	예	예	예	아니요	아니요
af_ad	광고	예	예	예	아니요	아니요
af_channel	채널	예	예	예	예	아니요
af_siteid	퍼블리셔 ID	예	예	예	예	예
af_keywords	키워드	예	예	예	아니요	아니요
is_primary	초기 어트리뷰션입니다	예	아니요	예	예	아니요
af_c_id	캠페인 ID	예	아니요	예	예	아니요
af_adset_id	광고세트 ID	예	아니요	예	아니요	아니요
af_ad_id	광고 아이디	예	아니요	예	아니요	아니요
install_time	Install Time	예	예	확인 가능*	예	예
attributed_touch_type	Touch Type	예	예	예	예	아니요
지역	지역	예	예	예	예	예
* 활동 KPI 컨텍스트에서 인스톨 시간은 이벤트 시간으로 간주됩니다.

KPI

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

라이프타임 값(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에 보유한 사용자 수 비율

선택된 기간의 앱 액티비티

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]	선택된 기간 동안 지정된 이벤트를 수행한 평균 고유 사용자

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

일러두기:

자릿수 버림 오류: 사용자 당 코호트 KPI는 소수점 넷째자리까지 계산됩니다. 즉, 만약 계산된 사용자 당 값이 < 0.0001 이라면, 이 값은 0으로 표시됩니다. 예를 들어 사용자 수가 100,000 명이고 총 매출이 $9 이라면, 사용자 당 매출은 9/100000=0.00009 입니다. 0.00009<0.0001 이기 때문에, 표시되는 값은 0 입니다.
코호트 일수: 최대 코호트 일수는 인스톨 후 90일이며, 여기서 day 0은 앱 설치일입니다. 코호트 일수 값 [x] 범위는 1-90 사이여야 합니다. 참고: cohort_day_0는 코호트 대시보드에서 지원되더라도 마스터 API에서는 지원되지 않습니다.
마스터 API 대비 코호트 API 및 코호트 대시보드: 리인스톨 및 타이밍 문제에 따라 결과가 달라질 수 있습니다.

세션(Sessions)

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로 바꿉니다.

예시: URL의 cohort_3_days_total_sessions_per_user은 3 개의 리포트 열을 만듭니다.
Cohort_day_1_total_sessions_per_user+ Cohort_day_2_total_sessions_per_user+Cohort_day_3_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로 바꿉니다. 예시: URL의 cohort_3_days_total_revenue_per_user은 3 개의 리포트 열을 만듭니다. Cohort_day_1_total_revenue_per_user+ Cohort_day_2_total_revenue_per_user+Cohort_day_3_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로 바꿉니다.

예시: URL의 cohort_3_days_total_events_per_user은 3 개의 리포트 열을 만듭니다.
Cohort_day_1_total_events_per_user+ Cohort_day_2_total_events_per_user+Cohort_day_3_total_events_per_user

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
차단된 인스톨	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_channel	채널 이름으로 필터링하는 데 사용됩니다. 쉼표(,)로 구분된 다중 선택이 지원됩니다.	af_channel=Instagram	아니요
af_siteid	퍼블리셔 ID를 기준으로 필터링하는 데 사용됩니다. 쉼표(,)로 구분된 다중 선택이 지원됩니다.	af_siteid=12345678	아니요
지역	국가별로 필터링하는 데 사용됩니다. 쉼표(,)로 구분된 다중 선택이 지원됩니다.	geo=US,DE	아니요

현지화

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

다음 사항이 적용됩니다.

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

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

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

추가 정보

특성과 제한 사항

항목	참고
비용 데이터	광고 세트, 광고, 지역, 채널 및 사이트 ID를 의미하는 다른 비용 차원의 가용성은 ad network dependant입니다. eCPI를 얻는 방법: 비용 데이터가 가능한 상황에서, 호출에 인스톨과 비용을 모두 포함하십시오. 일반적으로 앱스플라이어 링크를 사용하고 링크에 cost 파라미터가 있는 온드 미디어를 포함한 모든 소스는 요청된 차원에 관계없이 비용 데이터를 완벽하게 지원합니다. 자체 API를 사용하는 자체 보고 네트워크는 일반적으로 사용 가능한 차원 중 일부만 있는 비용 데이터를 지원합니다. 예를 들어 Meta 광고 는 동일한 통화에서 지역 및 채널별 그룹화를 지원하지 않습니다. 둘 중 하나를 기준으로 개별적으로 그룹화할 수 있습니다. 비용 데이터는 있지만 최근 인스톨 데이터가 없는 캠페인(약 7일)은 마스터 API에서 사용할 수 없습니다.
그룹화	특정 그룹화는 오직 LTV KPI, 액티비티 또는 리텐션 KPI에 대해서만 사용할 수 있습니다. 특정 KPI를 위한 데이터가 가능하지 않을 때는 API가 N/A을 반환합니다. 예를 들어, af_channel로 그룹화한 retention_rate_day_7d 요청은 N/A를 반환합니다.
리포트 당 최대 행 개수	200K
이벤트 이름	마스터 API는 현재 슬래시 `/` 를 포함하는 이벤트 이름을 지원하지 않습니다. 이 제한사항을 해결하려면 이벤트 이름에 `/`를 사용하지 마십시오.
처리 시간	두 개 이상의 앱을 선택하면 처리 시간이 늘어나고 응답 시간이 길어질 수 있습니다.
날짜 범위	시간 세분성은 매일입니다.
에이전시	마스터 API를 사용할 수 없음
광고 네트워크	마스터 API를 사용할 수 없음
과거 데이터	LTV 데이터: 5년 코호트 데이터(일일 코호트): 2년 액티비티 데이터: 3년
리타게팅	지원 안됨.