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 id_aplicación - Identificador de la aplicación como se encuentra en AppsFlyer.
- Inserta el ID de aplicación tal como se encuentra en AppsFlyer.
- Agrega el prefijo ID a las aplicaciones iOS.
- Usa todos los ID de aplicaciones para consultar todas tus aplicaciones.
Sí desde Límite inferior del rango de fechas de atribución de LTV.
- Formato: cadena aaaa-mm-dd
-
Ejemplo:
from: 2020-01-02
Sí a Límite superior del rango de fechas de atribución de LTV.
- Número de días en el rango: 1 a 31 días
-
Para un solo día: los valores
fromytoson idénticos. - Formato: aaaa-mm-dd
-
Ejemplo:
from: 2021-01-01, to: 2021-01-31es 31 días.
Sí Agrupaciones Agrupar por parámetros, separados por una coma. Consulta la tabla Agrupaciones para ver la lista disponible.
Ejemplo:
groupings=pid,geoSí 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:
kpis=installs,clicks, impressions,sessions,retention_day_7Sí Filtros Los datos se pueden filtrar usando una o más opciones de filtro. No Truemoney Para devolver datos usando el conjunto de divisas específico de la aplicación, establece currency=preferred. No Zona horaria Para devolver datos usando la zona horaria específica de la aplicación, establece timezone=preferred. Consulta las reglas de localización No Formato Por defecto, los datos de respuesta se reciben en formato de archivo CSV. Si prefieres obtener los datos en formato JSON, selecciona format=json.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 APIAgrupar por nombre visible KPIs de LTV KPIs de retención KPIs de actividad Las alertas de Protect360 se actualizan a la hora UTC diaria. cohort_[x]_days_total_sessions_per_user id_aplicación 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_conjunto de anuncios Conjunto de anuncios Sí Sí Sí No No af_anuncio Anuncio Sí Sí Sí No No af_canal Canal Sí Sí Sí Sí No af_siteid ID de anunciante Sí Sí Sí Sí Sí af_palabras_clave Palabras clave Sí Sí Sí No No es_primario 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 id_del_anuncio_af ID de anuncio Sí No Sí No No hora_de_instalación Hora de la Instalación Sí Sí Sí* Sí Sí tipo_táctil_atribuido 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.
Característica
Valor de duración: eventos agregados segmentados por día de instalación y hasta hoy.
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
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 Actividad de la app durante un intervalo de fechas seleccionado
Actividad de la app durante un intervalo de fechas seleccionado Nota: Los KPI de actividad incluyen datos unificados (UA y retargeting combinados).
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 Cohorte
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_day_[x]_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:
Cohort_day_1_total_sessions_per_user+ Cohort_day_2_total_sessions_per_user+Cohort_day_3_total_sessions_per_userIngresos
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_1_total_revenue_per_user+ Cohort_day_2_total_revenue_per_user+Cohort_day_3_total_revenue_per_usercohort_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:
Cohort_day_1_total_events_per_user+ Cohort_day_2_total_events_per_user+Cohort_day_3_total_events_per_userLas alertas de Protect360 se actualizan a la hora UTC diaria.
KPI de Protect360
Descripción KPI Instalaciones Total protect360_total_installs Bloqueos blocked_installs % de bloqueos blocked_installs_rate Después de 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 atribución posterior a la instalación: secuestro de instalaciones Anomalías en el CTIT bloqueadas blocked_installs_ctit_anomalies Anomalías en el CTIT posteriores a la atribución atribución posterior a la instalación: anomalías de CTIT Inundación de clics bloqueados blocked_installs_click_flood Inundación de clics posteriores de la atribución atribución posterior a la instalación: inundación de clics 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 fraude de instalación: total de dispositivos nuevos % 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 fraude de instalación: total de dispositivos con LAT % de instalaciones fraude de instalación: tasa total de instalaciones en dispositivos con LAT % de usuarios leales fraude de instalación: tasa total de usuarios fieles en dispositivos con LAT Indicadores de inundación de clics Tasa de conversión conversion_rate Indicadores de inundación de clics: CTIT Más de 60 minutos tasa de inundación de clics de más de una hora Más de 5 horas tasa de inundación de clics de más de cinco horas 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_3Ingresos medios por impresión
kpis=installs&calculated_kpi_rev_per_impression=revenue%2FimpressionCohort 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_ecpiFiltros (opcional)
Parámetro Descripción Ejemplo Obligatorio? PID - Se utiliza para seleccionar las filas, en las que se muestran las fuentes de medios especificadas.
- Se admite la selección múltiple separada por comas.
pid=organic,applovin_int No C - Se utiliza para filtrar por nombre de campaña.
- Se admite la selección múltiple separada por comas.
c=my_sample_campaign No af_prt - Se utiliza para filtrar por nombre de agencia.
- Se admite la selección múltiple separada por comas.
af_prt=moburst No af_canal - Se utiliza para filtrar por nombre de canal.
- Se admite la selección múltiple separada por comas.
af_channel=Instagram No af_siteid - Se utiliza para filtrar por ID de anunciante.
- Se admite la selección múltiple separada por comas.
af_siteid=12345678 No geolocalización - Se utiliza para filtrar por país.
- Se admite la selección múltiple separada por comas.
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
| Caducado | 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. |
| Dimensiones | Para los datos de cohortes, si una agencia participa en la atribución, la fuente de medios devuelta es el nombre de la agencia |
| 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 / . Para superar esta limitación, evita el uso de / en nombres de eventos. |
| 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 |
|
| Reorientación |
|
This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.