Referência do conector de ingestão de Meta Ads
Beta
O conector Meta Ads 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.
Este artigo 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.
Níveis de granularidade
Especifique o nível em que deseja obter as métricas de desempenho:
account: nível da contacampaignNível de campanha.ad_set: 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áriasgender: Gênerocountry: PaísregionRegião geográficadmaÁrea de mercado designada (somente nos EUA)device_platformPlataforma do dispositivo (móvel, computador, etc.)placement: Local de veiculação do anúnciopublisher_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ãoaction_destinationDestino da ação de conversãoaction_carousel_card_idIdentificador do cartão do carrosselaction_carousel_card_nameNome do cartão do carrosselaction_video_soundConfiguração de som do vídeoaction_video_typeTipo de vídeo
incremento de tempo
O conector utiliza incrementos de tempo diários. Incrementos de tempo por hora não são suportados na versão Beta.
Janelas de atribuição
O conector utiliza as seguintes janelas de atribuição fixas na versão Beta:
- Janela de atribuição: 7 dias
- Visualizar período de atribuição: 1 dia
Versões da API
O conector Meta Ads usa a API de proteção. A Databricks mantém o conector atualizado com a versão estável mais recente da API.