De un vistazo: Obtén KPI seleccionados de LTV, actividad, retención, cohorte y rendimiento de campañas de Protect360 por API, en formato CSV o JSON. Selecciona 1 o más aplicaciones.
API maestra: métricas de adquisición de usuarios a través de API
API maestra:
- Te permite obtener KPI seleccionados de LTV, actividad, retención, cohorte y rendimiento de campañas de Protect360. Los KPI disponibles son los KPI equivalentes a los que se encuentran en el panel de control, Resumen general, Activity, Retención, Cohorte y Protect360.
- Se calcula diariamente. Los datos actualizados están disponibles para ti dentro de las 24 a 48 horas, dependiendo de la zona horaria específica de tu aplicación.
- Es la infraestructura sobre la que se construye la tabla de pivote de AppsFlyer.
Para usar la API maestra, define los datos que deseas ver (similar a la implementación de la Pull API). El resultado se devuelve como un archivo CSV o JSON.
Para usar la API maestra:
Obtén el token de API. Un administrador deberá recuperar el token.
- Dale a tu desarrollador el token de API que se utilizará en el encabezado de autenticación.
- Proporciona a tus desarrolladores los parámetros que deben introducir cuando realicen la llamada a la API, como se describe en las secciones que siguen. Los parámetros determinan en qué se enfoca el reporte, cómo se organiza, y proporcionan un marco de tiempo para la presentación de reportes.
- Dile a tu desarrollador que siga las instrucciones de la API maestra en el centro de desarrolladores.
Parámetros de API
Parámetro |
Valor | Obligatorio |
---|---|---|
app_id |
|
Sí |
desde |
Límite inferior del rango de fechas de atribución de LTV.
|
Sí |
a |
Límite superior del rango de fechas de atribución de LTV.
|
Sí |
Agrupaciones |
Agrupar por parámetros, separados por una coma. Consulta la tabla Agrupaciones para ver la lista disponible. Ejemplo: |
Sí |
KPIs |
Lista de KPIs a incluir, cada uno separado por una coma. Consulta la tabla de KPIs a seguir para obtener una lista de KPIs. Ejemplo: |
Sí |
Filters |
Los datos se pueden filtrar usando una o más opciones de filtro. |
No |
Currency | Para devolver datos usando el conjunto de divisas específico de la aplicación, establece currency=preferred. | No |
Timezone |
Para devolver datos usando la zona horaria específica de la aplicación, establece timezone=preferred. Consulta las reglas de localización |
No |
Format |
Por defecto, los datos de respuesta se reciben en formato de archivo CSV. Si prefieres obtener los datos en formato JSON, selecciona |
No |
Agrupaciones
Estas dimensiones se utilizan para recopilar los datos en grupos para permitir un análisis más fácil y preciso de la información. Puedes encontrar descripciones de estos campos aquí.
Agrupar por nombre de API |
Agrupar por nombre visible | KPIs de LTV | KPIs de retención | KPIs de actividad | Protect360 | Cohorte |
---|---|---|---|---|---|---|
app_id |
ID de aplicación |
Sí |
Sí |
Sí |
Sí |
Sí |
pid |
Fuente de medios |
Sí |
Sí |
Sí |
Sí |
Sí |
af_prt |
Agencia |
Sí |
Sí |
Sí |
Sí |
No |
c |
Campaña |
Sí |
Sí |
Sí |
Sí |
Sí |
af_adset |
Adset |
Sí |
Sí |
Sí |
No |
No |
af_ad |
Anuncio |
Sí |
Sí |
Sí |
No |
No |
af_channel |
Canal |
Sí |
Sí |
Sí |
Sí |
No |
af_siteid |
ID de anunciante |
Sí |
Sí |
Sí |
Sí |
Sí |
af_keywords |
Palabras clave |
Sí |
Sí |
Sí |
No |
No |
is_primary |
Atribución primaria |
Sí |
No |
Sí |
Sí |
No |
af_c_id |
ID de campaña |
Sí |
No |
Sí |
Sí |
No |
af_adset_id |
ID de adset |
Sí |
No |
Sí |
No |
No |
af_ad_id |
ID de anuncio |
Sí |
No |
Sí |
No |
No |
install_time |
Hora de la Instalación |
Sí |
Sí |
Sí* |
Sí |
Sí |
attributed_touch_type |
Tipo de Toque |
Sí |
Sí |
Sí |
Sí |
No |
geolocalización |
Geolocalización |
Sí |
Sí |
Sí |
Sí |
Sí |
* En el contexto de los KPI de actividad, considera el tiempo de instalación como tiempo de evento. |
KPIs
Los KPI son las métricas utilizadas para obtener insights sobre el comportamiento de tu aplicación. Los KPI se agrupan por tipo en las pestañas que siguen.
KPI del nombre de la API | Descripción |
---|---|
Impresiones | Número de impresiones en el periodo de tiempo seleccionado |
clics | Número de clics en el periodo de tiempo seleccionado |
instalaciones | Número de instalaciones en el periodo de tiempo seleccionado |
cr | Tasa de Conversión |
sesiones | Número de sesiones creadas por los usuarios que instalaron la app en el periodo seleccionado |
loyal_users | Número de usuarios leales que instalaron la app en el periodo seleccionado |
loyal_users_rate | Usuarios leales / Instalaciones |
costo |
Costo total en el período seleccionado. Ver limitaciones. |
ingresos | Ingresos de por vida generados por los usuarios que instalaron la app en el periodo seleccionado |
roi | Retorno de la inversión en un tiempo determinado |
arpu_ltv | Ingresos medios por usuario, para los usuarios que instalaron la app en el periodo seleccionado |
average_ecpi | Costo efectivo por instalación (eCPI) a lo largo de un cierto período de tiempo. Disponible solo si el costo y las instalaciones están incluidas en la llamada. |
desinstalaciones | Desinstalación de usuarios que instalaron la app en el periodo seleccionado |
uninstalls_rate | Tasa de desinstalación |
event_counter_[event_name] | Cantidad de ocurrencias de eventos |
unique_users_[event_name] | Cantidad de usuarios únicos que realizaron el evento |
sales_in_usd_[event_name] | Ingresos declarados como parte de los hechos declarados |
Retención es una medida de cuántos usuarios existentes son activos en tu app
Nota:
- El número máximo de días de retención es de 30 días post-instalación, donde el día 0 es el día de la instalación. Esto significa que el valor [x] no puede superar 30.
- Si solicitas retention_day_1, antes de que los datos de ese día estén disponibles, entonces la métrica que se devuelve se refiere a los usuarios que instalaron el día anterior. Por ejemplo, el 2 de enero, solicitas retention_day_1 para los usuarios que instalaron el 1 de enero. Debido a que la métrica aún no está disponible, la métrica que se devuelve se refiere a los usuarios que instalaron el 31 de diciembre.
KPI | Descripción |
---|---|
retention_day_[x] | Número de usuarios retenidos en el día X |
retention_rate_day_[x] | Número de usuarios retenidos en el día X de los usuarios que instalaron la app |
KPI | Descripción |
---|---|
activity_average_dau | Promedio de usuarios diarios activos (DAU) en el periodo seleccionado |
activity_average_mau | Promedio de usuarios mensuales activos en el periodo seleccionado (un día MAU representa los usuarios únicos en los 30 días anteriores) |
activity_average_dau_mau_rate | Tasa promedio de DAU/MAU |
activity_average_arpdau | Ingresos medios por usuario diario activo: Los ingresos medios de un día determinado de todos los usuarios únicos |
activity_sessions | Número de sesiones realizadas en el periodo determinado |
activity_revenue | Ingresos declarados en el plazo seleccionado |
activity_event_counter_[event_name] | Número de eventos generados por los usuarios en el periodo de tiempo seleccionado |
activity_sales_in_usd_[event_name] | Ingresos declarados como parte de los eventos declarados dentro del plazo seleccionado |
activity_average_unique_users_[event_name] |
Media de usuarios únicos que realizan un evento determinado en el periodo de tiempo seleccionado |
Las cohortes de AppsFlyer brindan a los anunciantes la capacidad de ver y comparar diferentes métricas para múltiples cohortes en diferentes períodos.
Nota:
- Errores de redondeo: los KPI de cohorte por usuario se calculan utilizando cuatro decimales. Esto significa que si el valor calculado por usuario es < 0,0001, entonces esto se muestra como 0. Por ejemplo, el número de usuarios es de 100 000, y los ingresos totales son de 9 USD. Los ingresos por usuario serán de 9/100 000=0,00009. Como 0,00009 < 0,0001, el valor mostrado será 0.
- Días de cohorte: el número máximo de días de cohorte es de 90 días post-instalación, donde el día 0 es el día de la instalación. El valor del día de cohorte [x] debe estar en el rango de 1-90. Nota: cohort_day_0 no es compatible con la API maestra, aunque se admite en el panel de control de cohorte.
- API maestra frente a API de cohorte y panel de control de cohorte: los resultados pueden diferir debido a diferentes problemas con el manejo de las reinstalaciones y el tiempo.
Sesiones
KPI | Descripción |
---|---|
cohort_day_[x]_total_sessions_per_user | Cohorte del día x - Sesiones acumuladas por usuario hasta el día x (incluido el día x) |
cohort_day_[x]_sessions_per_user | Cohorte del día x - Sesiones del día x sólo de la cohorte |
cohort_[x]_days_total_sessions_per_user |
Sustituye la especificación de los KPIs de Cohort_day_1_total_sessions_per_user a Cohort_day_x_total_sessions_per_user en la URL. Por ejemplo: cohort_3_days_total_sessions_per_user en la URL produce 3 columnas de reporte: |
Ingresos
KPI | Descripción |
---|---|
cohort_day_[x]_total_revenue_per_user | Cohorte del día X - Ingresos acumulados por usuario hasta el día x (incluido el día x) |
cohort_day_[x]_revenue_per_user | Cohorte del día x - ARPU recibido el día x sólo de la cohorte |
cohort_[x]_days_total_revenue_per_user |
Reemplaza especificando los KPI Cohort_day_1_Total_Revenue_per_user a Cohort_day_x_total_revenue_per_user. Por ejemplo: cohort_3_days_total_revenue_per_user en la URL produce 3 columnas de reporte: |
cohort_day_[x]_total_event_[eventname]_revenue_per_user |
Día de cohorte x ingresos acumulativos por usuario según evento específico in-app. |
cohort_day_[x]_event_[eventname]_revenue_per_user | Día de cohorte x ingresos por usuario según evento específico in-app. |
Eventos
KPI | Descripción |
---|---|
cohort_day_[x]_total_event_[eventname]_per_user | Cohorte del día x - Eventos acumulados por usuario hasta el día x (incluido el día x) |
cohort_day_[x]_event_[eventname]_per_user | Cohorte del día x - Eventos recibidos el día x sólo de la cohorte |
cohort_[x]_days_total_event_[eventname]_per_user |
Reemplaza la especificación de los eventos de KPI a Cohort_day_x_total_events_per_user. Por ejemplo: cohort_3_days_total_events_per_user en la URL produce 3 columnas de reporte: |
KPI de Protect360
Descripción |
KPI |
---|---|
Instalaciones | |
Total | protect360_total_installs |
Bloqueos | blocked_installs |
% de bloqueos | blocked_installs_rate |
Posterior a la atribución | post_attribution_installs |
% posterior a la atribución | post_attribution_installs_rate |
Total de instalaciones fraudulentas | total_fraudulent_installs |
% de instalaciones fraudulentas | fraudulent_installs_rate |
Instalaciones falsas | |
Bloqueo en tiempo real | real_time_fake_installs |
Fraude posterior a la atribución | post_attribution_fake_installs |
Instalaciones secuestradas (Hijacked installs) | |
Bloqueo en tiempo real | real_time_hijacked_installs |
Fraude posterior a la atribución | post_attribution_installs_hijacked_installs |
Reglas de validación | |
Instalaciones bloqueadas | validation_rules_blocked_installs |
Atribución bloqueada | validation_rules_blocked_attribution |
Desglose de instalaciones falsas bloqueadas | |
Lista negra de ID de sitios bloqueados | blocked_installs_siteid_blacklist |
Lista negra de ID de sitios posteriores a la atribución | post_attribution_installs_siteid_blacklist |
Bots bloqueados | blocked_installs_bots |
Bots posteriores a la atribución | post_attribution_installs_bots |
Bloqueos por anomalías de comportamiento | blocked_installs_behavioral_anomalies |
Anomalías de comportamiento posterior a la atribución | post_attribution_installs_behavioral_anomalies |
Validación de instalación bloqueada | blocked_installs_install_validation |
Desglose de instalaciones secuestradas bloqueadas | |
Secuestro de instalaciones bloqueados | blocked_installs_install_hijacking |
Secuestro de instalaciones posteriores de la atribución | post_attribution_installs_installs_hijacking |
Anomalías en el CTIT bloqueadas | blocked_installs_ctit_anomalies |
Anomalías en el CTIT posteriores a la atribución | post_attribution_installs_ctit_anomalies |
Inundación de clics bloqueados | blocked_installs_click_flood |
Inundación de clics posteriores de la atribución | post_attribution_installs_click_flood |
Clics | |
Total | protect360_total_clicks |
Bloqueos | blocked_clicks |
% | blocked_clicks_rate |
Eventos in-app | |
Total | protect360_total_in_apps |
Bloqueos | blocked_in-app-events |
% | blocked_in-app-events_rate |
Indicadores de granjas de dispositivos (device farm): nuevos dispositivos | |
Instalaciones | install_fraud_new_devices_total |
% de instalaciones | install_fraud_new_devices_total_installs_rate |
% de usuarios leales | install_fraud_new_devices_total_loyal_user_rate |
Indicadores de granjas de dispositivos: dispositivos con LAT | |
Instalaciones | install_fraud_lat_devices_total |
% de instalaciones | install_fraud_lat_devices_total_installs_rate |
% de usuarios leales | install_fraud_lat_devices_total_loyal_user_rate |
Indicadores de inundación de clics | |
Tasa de conversión | conversion_rate |
Indicadores de inundación de clics: CTIT | |
Más de 60 minutos | click_flood_over_1_hour_rate |
Más de 5 horas | click_flood_over_5_hours_rate |
KPIs calculados
Ademas de los KPIs descritos anteriormente, puedes añadir KPIs calculados a tus reportes de master API.Esto te permite tener tus propios reportes calculados incluidos en tus tus reportes de master API.
Puedes insertar cualquier número de objetos de KPI integrados en las fórmulas KPI calculadas. Cada objeto de KPI de cálculo incluye una clave y un valor. La clave es el nombre que le das al KPI y el valor es la fórmula del KPI.
Se admiten los operadores aritméticos estándar: suma (+) codificada como %2b, resta (-), multiplicación (*), división (/) codificada como %2f.
Las claves de campo KPI calculadas deben comenzar con "calculated_kpi_", seguido de cualquier cadena válida, como, "calculated_kpi_purchaserate".
Ejemplo
Retención combinada de los primeros tres días
kpis=installs,loyal_users_rate&calculated_kpi_3days_retention=
retention_day_1%2Bretention_day_2%2Bretention_day_3
Ingresos medios por impresión
kpis=installs&calculated_kpi_rev_per_impression=revenue%2Fimpression
Cohort del ROI del día 7
kpis=installs,roi,arpu_ltv,cost,revenue&calculated_kpi_roi_day_7=
(cohort_day_7_total_revenue_per_user-average_ecpi)%2Faverage_ecpi
Filtros (opcional)
Parámetro | Descripción | Ejemplo | Obligatorio? |
---|---|---|---|
pid |
|
pid=organic,applovin_int |
No |
c |
|
c=my_sample_campaign |
No |
af_prt |
|
af_prt=moburst |
No |
af_channel |
|
af_channel=Instagram |
No |
af_siteid |
|
af_siteid=12345678 |
No |
geolocalización |
|
geo=US,DE |
No |
Localización
La divisa local y la zona horaria específica de la aplicación se establecen en la página de configuración de la aplicación. Los datos de la API maestra pueden extraer los datos utilizando la divisa y la zona horaria predeterminadas del sistema o usando la región y la divisa específicas de la aplicación.
Se aplica lo siguiente:
- El uso de la zona horaria/divisa específica de la aplicación solo se admite si todas las aplicaciones tienen la misma zona horaria/divisa. De lo contrario, se utilizan UTC y USD. La zona horaria y la divisa son independientes. Eso significa que, si la divisa de todas las aplicaciones es la misma pero las zonas horarias no lo son, entonces puedes usar la divisa específica de la aplicación, pero no la zona horaria específica de la aplicación.
- Si la zona horaria preferida se cambió en el panel de control del período solicitado, el reporte generado contiene valores a partir del cambio de zona horaria más reciente.
Utiliza los siguientes parámetros para seleccionar la configuración específica de la aplicación. Nota: Si no usas los parámetros preferidos, obtienes la configuración predeterminada, que es USD para la divisa y UTC para la zona horaria.
Parámetro | Descripción | Ejemplo | Obligatorio? |
---|---|---|---|
divisa |
Los valores monetarios están en la divisa específica de la app |
divisa=preferida |
No |
huso horario |
La zona horaria utilizada coincide con la zona horaria específica de la aplicación. |
huso horario=preferido |
No |
Información adicional
Características y limitaciones
Característica | Observaciones |
---|---|
Datos de costos |
|
Agrupaciones |
Las agrupaciones específicas solo están disponibles para los KPI de LTV, KPI de actividad o retención. La API devuelve N/A cuando los datos de un KPI específico no están disponibles. Por ejemplo, al solicitar retention_rate_day_7 agrupado por af_channel, devuelve N/A. |
Máximo de filas por reporte | 200 000 |
Nombres de los eventos |
Actualmente, la API maestra no admite nombres de eventos que incluyan una barra inclinada |
Tiempo de procesamiento | Seleccionar más de una aplicación aumenta el tiempo de procesamiento y la respuesta puede tardar más tiempo. |
Rango de fechas | La granularidad del período es diaria. |
Agencias | API maestra no disponible |
Redes de publicidad | API maestra no disponible |
Historial de datos |
|
Retargeting | No se admite |