Detalhamento de marketing mix modeling na API de Insights

O detalhamento de marketing mix modeling na API de Insights é uma opção de autoatendimento para extração de dados que pode ser usada pelos clientes para exportar dados de anúncios da Meta de forma rápida e fácil sem passar por um dos nossos Parceiros de Marketing Science nem por agências de terceiros e Parceiros de Métricas para Aplicativos.

As chamadas de API são integradas na API de Insights usando o parâmetro breakdowns=mmm. Ao contrário de outros detalhamentos, não é possível combinar essa opção com diferentes breakdowns nem action_breakdowns.

As respostas contêm métricas e detalhamentos semelhantes aos resultados da exportação de dados de marketing mix modeling na interface Relatórios de Anúncios. Os dados de marketing mix modeling estão disponíveis apenas no nível do conjunto de anúncios, que é o comportamento-padrão (equivalente ao parâmetro level=adset). No momento, as métricas compatíveis com dados de marketing mix modeling são impressions e spend. Observação: spend é uma métrica estimada. Para saber mais, consulte Métricas de insights estimadas e em desenvolvimento.

Início rápido

Para obter os dados de marketing mix modeling:

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

A API de Insights usa valores-padrão para parâmetros não especificados na chamada. Recomendamos usar os parâmetros time_range e date_preset. Para ampliar ainda mais o detalhamento da resposta, use time_increment.

Exemplo

Com esta chamada, você obtém os dados diários de marketing mix modeling da ú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 saber mais sobre a API de Insights e entender como integrar a API de Marketing, consulte API de Insights.

Perguntas sobre o Gerenciador de Negócios

Um caso de uso comum seria recuperar dados de marketing mix modeling para um único Gerenciador de Negócios. Essa operação não é diretamente compatível porque a API de Insights funciona para contas de anúncios e níveis inferiores.

1. Para baixar dados de um Gerenciador de Negócios, primeiro você precisa consultar as contas de anúncios disponíveis com os pontos de extremidade owned_ad_accounts e 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. Itere as identificações de contas de anúncios individuais retornadas para consultar os dados de marketing mix modeling de cada conta.

Limites e boas práticas

O detalhamento dos dados de marketing mix modeling gera uma resposta grande, com um número alto de registros. Isso pode fazer com que suas solicitações expirem durante o cálculo.​ Para resolver esse problema, diminua o tamanho da solicitação usando time_range e filtering, que permitirá consultar o tempo total em seções. Para saber mais, leia Limites e boas práticas.

Para esta versão, existe apenas um filtering específico compatível para consultar os dados de marketing mix modeling. Somente as combinações de operadores listadas abaixo são permitidas para cada campo. Qualquer outro uso de filtering retornará um erro.

Recomendamos o uso da exportação de dados de marketing mix modeling na interface Relatórios de Anúncios para gerar dados históricos caso a API não seja necessária.

Como alternativa, você pode usar o fluxo de trabalhos assíncronos da API de Insights. Isso cria um trabalho que calcula os dados de forma assíncrona. O ponto de extremidade responderá com o id de uma execução de relatório de anúncios, que você poderá usar para consultar o status do trabalho e recuperar os dados computados. No entanto, é importante saber que algumas solicitações podem expirar, mesmo como um trabalho assíncrono. Para saber mais, consulte Trabalhos assíncronos da API de Insights.

Observe que esta versão pode ter mapeamentos e ordenação de cabeçalhos de coluna um pouco diferentes da exportação de dados de marketing mix modeling na interface Relatórios de Anúncios. Além disso, você tem total flexibilidade para combinar os dados-padrão do detalhamento de marketing mix modeling com outras tabelas consultadas a partir da API.