Referência do conector de ingestão 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.

Esta página contém material de referência para o conector de ingestão de Meta Ads no Databricks LakeFlow Connect.

transformações automáticas de dados

O Databricks transforma os tipos de dados Meta Ads em tipos de dados compatíveis com Delta da seguinte forma:

Tipo de anúncios Meta	Tipo Delta
string	String
int	Integer
long	Long
Float	Float
double	Double
boolean	Booleana
datetime	Carimbo de data/hora
Data	Data
Lista	matriz
map	Mapa
enumeração	String

Objetos suportados

O conector Meta Ads suporta a ingestão dos seguintes objetos:

Objeto	Descrição
anúncios	Anúncios individuais em suas campanhas
conjuntos_de_anúncios	Conjuntos de anúncios que agrupam anúncios com segmentação, orçamento e configurações programáticas compartilhadas.
campanhas	Objetos de campanha de nível superior que contêm conjuntos de anúncios
imagens_de_anúncio	Imagem ativa usada em anúncios
insights_de_anúncios	dados de desempenho e análises para anúncios, conjuntos de anúncios, campanhas ou contas
anúncios criativos	Elementos criativos (imagens, vídeos, texto) usados em anúncios
públicos_personalizados	Definições de público-alvo personalizadas para segmentação
vídeos_de_anúncios	Vídeo ativo usado em anúncios
conversões_personalizadas	Definições de eventos de conversão personalizados

opções de configuração do ad_insights

O objeto ad_insights suporta opções de configuração adicionais para analisar dados de desempenho.

data de início

Defina a data mais antiga a partir da qual os dados históricos ad_insights devem ser ingeridos. A API secreta retém dados por aproximadamente 36 meses, portanto start_date deve estar dentro dos últimos 36 meses. Se não estiver definido, o conector assume por padrão 36 meses antes da data atual.

Níveis de granularidade

Especifique o nível em que deseja obter as métricas de desempenho:

• account: nível da conta
• campaignNível de campanha.
• adset: Conjunto de anúncios em nível de conjunto.
• ad: métricas em nível de anúncio (default)

Dimensões de decomposição

Configure as dimensões de detalhamento para segmentar os dados de desempenho:

• ageFaixas etárias
• gender: Gênero
• country: País
• regionRegião geográfica
• dmaÁrea de mercado designada (somente nos EUA)
• device_platformPlataforma do dispositivo (móvel, computador, etc.)
• placement: Local de veiculação do anúncio
• publisher_platformPlataforma de publicação (Facebook, Audience Network, etc.)
• impression_deviceTipo de dispositivo para impressões

Dimensões de detalhamento da ação

Configure as dimensões de detalhamento de ações para analisar as ações de conversão:

• action_typeTipo de ação de conversão
• action_destinationDestino da ação de conversão
• action_carousel_card_idIdentificador do cartão do carrossel
• action_carousel_card_nameNome do cartão do carrossel
• action_video_soundConfiguração de som do vídeo
• action_video_typeTipo de vídeo

incremento de tempo

Configure o período de agregação para os dados ad_insights :

• all_daysUm único bucket que abrange todo o intervalo de tempo ( default API de percepções).
• monthlyUm balde por mês civil.
• Um número inteiro de dias como uma string (por exemplo, "1" para intervalos diários, "7" para intervalos semanais).

A API de ocultação não suporta incrementos de tempo por hora.

Hora do relatório de ação

Configure o carimbo de data/hora usado para relatar as estatísticas de ações:

• impressionAs conversões são registradas na data da impressão que as gerou.
• conversionAs conversões são registradas na data em que ocorreram.
• mixedAs conversões por clique utilizam o tempo de impressão, enquanto as conversões por viewutilizam o tempo de conversão.
• lifetime: Conversões ao longo da vida útil da entidade.

Janelas de atribuição

Configure as janelas de atribuição para as ações.

• 1d_click, 7d_click: Janelas de atribuição de clique
• 28d_clickJanela de atribuição por clique. Obsoleto pela Meta. Pode não ser retornado por versões mais recentes da API.
• 1d_view: janela de atribuição de visualização
• 7d_view, 28d_view: visualização através de janelas de atribuição. Obsoleto pela Meta. Pode não ser retornado por versões mais recentes da API.

Você pode especificar vários valores (por exemplo, ["7d_click", "1d_view"]). Se action_attribution_windows não estiver definido, o conector usa as configurações de atribuição default da sua account Meta Ads. Para obter uma lista de valores, consulte a referência API de privacidade da Meta.

Janela de retrospectiva

Configure por quantos dias o conector registará os dados em cada sincronização:

Comportamento:

• Reingestão de intervalo de tempo : Em cada sincronização após a primeira, o conector extrai dados para [last_sync_cursor - <N> days, today] para que as conversões que chegam atrasadas sejam capturadas. Se custom_insights_lookback_window não estiver definido, o conector reengere os últimos 7 dias por default.
• Atribuição fallback : Quando você define custom_insights_lookback_window explicitamente e não definiu action_attribution_windows, o conector também passa <N>d_click,1d_view como a janela de atribuição para a API escondida. Para controlar a atribuição independentemente do lookback, defina action_attribution_windows.

Versões da API

O conector Meta Ads utiliza a API de marketing Meta ( API gráfica). A Databricks mantém o conector atualizado com a versão estável mais recente da API.