Desglose del modelo de marketing mix en la API de insights

El desglose del modelo de marketing mix de la API de insights es una opción de autoservicio para la extracción de datos que los clientes pueden utilizar a fin de exportar datos de anuncios de Meta de manera fácil y rápida para su uso en el modelo de marketing mix sin necesidad de recurrir a un partner de Meta Marketing Science, agencias de terceros ni socios de evaluación de la actividad en móviles.

Las llamadas a la API están integradas en la API de insights mediante el parámetro breakdowns=mmm. A diferencia de otros, este desglose no puede combinarse con breakdowns ni action_breakdowns.

Las respuestas contienen métricas y desgloses similares como resultado de la exportación de datos del modelo de marketing mix en los informes de anuncios. Los datos del modelo de marketing mix solo están disponibles en el nivel del conjunto de anuncios, que es el comportamiento predeterminado (equivalente al parámetro level=adset). Actualmente, las métricas admitidas para los datos del modelo de marketing mix son impressions y spend. Nota:spend es una métrica estimada. Para obtener más información, consulta API de insights, Métricas estimadas y obsoletas.

Inicio rápido

Para obtener los datos del modelo de marketing mix, haz lo siguiente:

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

La API de insights usa valores predeterminados para los parámetros no especificados en la llamada. Recomendamos usar los parámetros time_range y date_preset. La granularidad de la respuesta puede incrementarse aún más usando 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 insights y cómo integrar la API de marketing, consulta el inicio rápido de la API de insights.

Consultas en el nivel de Business Manager

Un caso de uso habitual sería recuperar los datos del modelo de marketing mix para una única cuenta de Business Manager. Esta operación no se admite directamente porque la API de insights funciona en el nivel de la cuenta publicitaria o niveles inferiores.

1. Para descargar los datos de una cuenta de Business Manager, primero debes realizar una consulta a las cuentas publicitarias disponibles con los extremos 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 devueltos para realizar consultas a los datos del modelo de marketing mix de cada cuenta publicitaria.

Límites y prácticas recomendadas

La granularidad de los datos del modelo de marketing mix hace que la respuesta contenga un gran número de registros, que además son de gran tamaño. Esto puede provocar que el tiempo de espera de tus solicitudes se agote durante el cómputo. Para evitarlo, reduce 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 API de insights, Límites y prácticas recomendadas.

En esta versión, solo se admite un filtering específico consultar los datos del modelo de marketing mix. Solo se permiten las siguientes combinaciones de operador en un campo. Cualquier otro uso de filtering devolverá un error.

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

Como alternativa, puedes usar el proceso de trabajos asíncronos de la API de insights. Este crea un trabajo que calcula los datos de manera asíncrona. El extremo responde con el id de la ejecución del informe de anuncios. Puedes incluir este resultado en una consulta para obtener el estado del trabajo y recuperar los datos computados. Sin embargo, ten en cuenta que el tiempo de espera de algunas consultas se puede agotar aunque se trate de un trabajo asíncrono. Para obtener más información, consulta Trabajos asíncronos de la API de insights.

Ten en cuenta que, en esta versión, los encabezados de las columnas pueden estar asignados y ordenados de distinta manera a los de las exportaciones de datos del modelo de marketing mix en los informes de anuncios. Además, tienes total libertad para unir los datos predeterminados del desglose del modelo de marketing mix con otras tablas consultadas desde la API.