Pular para o conteúdo principal
Última atualização em

Conceitos de conectores de Meta Ads

info

Beta

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a este recurso na página de Pré-visualizações . Veja as prévias do Gerenciador Databricks.

O conector Meta Ads permite que você ingira dados de publicidade do Meta Ads usando Databricks LakeFlow Connect.

Como funciona a ingestão de Meta Ads?​

O conector recupera dados das APIs Meta Ads e os grava nas tabelas de transmissão. O objeto ad_insights usa a API percepções. Os objetos ads, ad_sets e campaigns usam a API de marketing. Cada objeto Meta Ads corresponde a uma tabela no seu esquema de destino.

Modelo de dados do conector​

O conector Meta Ads pode importar os seguintes objetos da sua account Meta Ads:

  • adsAnúncios individuais em suas campanhas
  • ad_setsConjuntos de anúncios que agrupam anúncios.
  • campaignsObjetos de campanha de nível superior
  • ad_imagesImagens usadas em anúncios
  • ad_insights: avaliações de desempenho e dados analíticos
  • ad_creativesElementos criativos usados em anúncios
  • custom_audiences: Definições de público-alvo personalizadas
  • ad_videosVídeo ativo usado em anúncios
  • custom_conversions: Definições de eventos de conversão personalizados

objeto ad_insights​

O objeto ad_insights fornece métricas de desempenho para suas campanhas publicitárias. Você pode configurar detalhamentos e detalhamentos de ações para analisar o desempenho em diferentes níveis:

  • Níveis de granularidade : account, campaign, adset ou ad
  • Dimensões de detalhamento : idade, sexo, país, localização, plataforma do dispositivo e muito mais.
  • Detalhamento das ações : tipo de ação, destino da ação e outras dimensões relacionadas à conversão.
  • Incremento de tempo : all_days, monthly ou um número personalizado de dias. A API de ocultação não suporta incrementos de tempo por hora.
  • Tempo do relatório de ações : Indica se o conector relata estatísticas de ações por impressão, conversão, mistas e tempo de vida útil.
  • Janela de retrospectiva : quantos dias o conector reengere em cada sincronização para capturar conversões que chegam com atraso.

Para obter detalhes sobre cada opção, consulte as opções de configuração do ad_insights.

Noções básicas de conectores​

  • Na execução inicial do pipeline, o conector ingere todos os dados dos objetos selecionados.
  • Na execução subsequente pipeline , o conector ingere registros recém-criados ou modificados usando ingestão incremental.
  • O conector transforma automaticamente os tipos de dados Meta Ads em tipos de dados compatíveis com Delta.
  • Cada tabela de destino é uma tabela de transmissão, que é uma tabela Delta com suporte adicional para processamento incremental de dados.

Ingestão incremental​

O conector Meta Ads utiliza a ingestão incremental para melhorar a eficiência do pipeline. Na primeira execução do seu pipeline, ele ingere todos os dados selecionados da fonte. Na execução subsequente, o conector usa o acompanhamento de alterações baseado em cursor para ingerir apenas os dados que foram alterados desde a execução anterior.

O conector usa o campo updated_time (quando disponível) como coluna do cursor para detectar alterações. Para objetos sem um campo updated_time , o conector usa a ingestão refresh completa.

Configurações de atribuição​

Por default, o conector Meta Ads usa as configurações de atribuição da sua account Meta Ads ao recuperar dados ad_insights . Você pode substituir isso definindo action_attribution_windows para especificar uma ou mais janelas de atribuição (por exemplo, 7d_click ou 1d_view). Para valores suportados, consulte Janelas de atribuição.

Como os eventos de conversão podem ser relatados após a impressão ou o clique, os dados para datas recentes podem estar incompletos até que a janela de atribuição configurada seja fechada. O conector ingere automaticamente esses dados na execução subsequente pipeline .

Plataformas de publicidade suportadas​

Na versão Beta, o conector suporta apenas anúncios do Facebook. Os anúncios do Instagram não são suportados.

Autenticação​

O conector utiliza o OAuth 2.0 para autenticar com o Meta Ads. Você cria um aplicativo Meta no Portal do Desenvolvedor Meta e configura as definições de OAuth para permitir que o Databricks acesse seus dados de publicidade. As credenciais de conexão são armazenadas com segurança no Unity Catalog.

Próximos passos​

Nesta página