Desglose del modelo de marketing mix en la API de estadísticas

El desglose del modelo de marketing mix en a API de estadísticas es una opción de extracción de datos autoservicio que los clientes pueden usar con el objetivo de exportar datos de anuncios de Meta de manera rápida y sencilla para el modelo de marketing mix sin pasar por un socio de ciencia de marketing de Meta o agencias de terceros y socios de medición de dispositivos móviles.

Las llamadas a la API se incorporan en la API de estadísticas mediante el parámetro breakdowns=mmm. A diferencia de otros desgloses, este no admite la combinación con otros breakdowns o action_breakdowns.

Las respuestas contienen métricas y desgloses similares a los resultados de la exportación de datos de modelos de marketing mix de los informes publicitarios. Los datos del modelo de marketing mix están disponibles sólo en el nivel del conjunto de anuncios, que es el comportamiento predeterminado (equivalente al parámetro level=adset). Por el momento, las métricas admitidas para los datos del modelo de marketing mix son impressions y spend. Nota:spend es un resultado estimado. Para obtener más información, consulta API de estadísticas, Métricas estimadas y obsoletas.

Inicio rápido

Para obtener los datos del modelo de marketing mix:

curl \
  -F "access_token=ACCESS_TOKEN" \ 
  -F "breakdowns=mmm" \ 
  "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/insights"

La API de estadísticas utiliza valores predeterminados para los parámetros no especificados en la llamada. Recomendamos usar los parámetros time_range y date_preset. Puedes aumentar aun más la granularidad de la respuesta si usas time_increment.

Ejemplo:

Esta llamada a la API recibe los datos diarios del modelo de marketing mix de la última semana:

curl \
  -F "access_token=ACCESS_TOKEN" \ 
  -F "breakdowns=mmm" \ 
  -F "date_preset=last_7d" \ 
  -F "time_increment=1” \ 
  "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/insights"

Para obtener más información sobre la API de estadísticas y cómo registrarte en la API de marketing, consulta Inicio rápido de la API de estadísticas.

Consultas en el nivel del administrador comercial

Un caso de uso común sería recuperar datos del modelo de marketing mix para un administrador comercial único. Esta no se admite de manera directa porque la API de estadísticas funciona en el nivel de la cuenta publicitaria y por debajo de este.

1. Si deseas descargar datos para un administrador comercial, primero debes consultar las cuentas publicitarias disponibles con los puntos de conexión owned_ad_accounts y client_ad_accounts.

   curl \
     -F "access_token=ACCESS_TOKEN" \ 
     "https://graph.facebook.com/v21.0/BUSINESS_ID/owned_ad_accounts"
   

   curl \
     -F "access_token=ACCESS_TOKEN" \ 
     "https://graph.facebook.com/v21.0/BUSINESS_ID/client_ad_accounts"
   

2. Itera sobre los identificadores de cuentas publicitarias individuales devueltos para consultar los datos del modelo de marketing mix de cada cuenta.

Limitaciones y prácticas recomendadas

La granularidad de los datos del modelo de marketing mix hace que la respuesta tenga un gran número de registros, que además son de gran tamaño. Esto puede hacer que se agote el tiempo de espera de tus solicitudes durante el cómputo. Para resolver este problema, disminuye el tamaño de la solicitud usando time_range y filtering y consulta el intervalo de tiempo total en secciones. Para obtener más información, consulta Límites y mejores prácticas de la API de estadísticas.

En esta versión, solo se admite un filtering específico para consultar los datos del modelo de marketing mix. Solo se permiten estas combinaciones de operador en un campo y otros usos de filtering devuelven un error.

Recomendamos aprovechar la función de exportar datos del modelo de marketing mix en los informes de anuncios para exportar datos históricos si no se necesita la API.

Como alternativa, puedes usar el proceso de tareas asincrónicas de la API de estadísticas. Este crea una tarea que calcula los datos de una manera asincrónica. El punto de conexión responde con el id de un informe publicitario, en el que puedes consultar el estado de la tarea y recuperar los datos computados. Sin embargo, ten en cuenta que algunas solicitudes pueden ser temporales, incluso en el caso de las tareas asincrónicas. Para obtener más información, consulta Tareas asincrónicas de la API de estadísticas.

Ten en cuenta que esta versión puede tener asignaciones y órdenes de encabezados de columna ligeramente diferentes de los de la exportación de datos del modelo de marketing mix en los informes publicitarios. Además, tienes plena flexibilidad para unir los datos predeterminados del desglose del modelo de marketing mix con otras tablas consultadas desde la API.