Referência do conector do Reddit Ads
Beta
Esse recurso está em Beta. Administradores do Workspace podem controlar o acesso a este recurso na página **Pré-visualizações**. Consulte Gerenciar prévias do Databricks.
Esta página fornece informações de referência para o conector gerenciado do Reddit Ads no Lakeflow Connect, incluindo tabelas compatíveis, definições de coluna e tipos de dados.
Tabelas de origem compatíveis
O conector Reddit Ads é compatível com os seguintes tipos de tabela:
- **Tabelas de entidade**: dados de configuração sobre sua conta do Reddit Ads, como campanhas, grupos de anúncios e anúncios. Essas tabelas são totalmente atualizadas em cada execução de pipeline.
- Tabelas de relatórios : Métricas de desempenho, como impressões, cliques e gastos. Estas tabelas oferecem suporte à ingestão incremental.
- Relatório personalizado : uma tabela definida pelo usuário que permite escolher dimensões de detalhamento e campos de métrica. Consulte Relatórios personalizados.
Tabelas de entidades
Nome da tabela | Descrição |
|---|---|
| Contas de anúncios acessíveis ao usuário autenticado. Está no esquema de origem |
| Configuração e configurações da campanha. |
| Configuração e configurações do grupo de anúncios. |
| Detalhes e configurações de anúncios individuais. Corresponde a |
Tabelas de relatório
Nome da tabela | Chave primária | Descrição |
|---|---|---|
|
| Métricas de desempenho em nível de campanha. |
|
| Métricas de desempenho em nível de grupo de anúncios. |
|
| Métricas de desempenho em nível de anúncio. |
|
| Métricas de desempenho no nível da campanha divididas por país. |
Convenções de tipo de dados
Moeda
As colunas monetárias — por exemplo, spend, cpc, bid_value — são armazenadas como decimal(19,2) na moeda da account do anúncio. Os valores são quantias decimais (por exemplo, 12.34), não micros. O código da moeda da account está disponível na coluna ad_account.currency e na coluna do relatório currency.
Colunas JSON
Algumas colunas de tabela de entidade contêm objetos aninhados complexos armazenados como strings JSON: targeting, schedule, event_trackers. Analise-os com from_json() ou parse_json() em SQL ou PySpark.
Cursor incremental
As tabelas de relatório usam metrics_updated_at (timestamp) como cursor incremental.
Esquemas de tabela de entidade
ad_account
Contas de anúncios acessíveis ao usuário autenticado. Esta tabela está no esquema de origem default.
Coluna | Tipo de dados | Descrição |
|---|---|---|
|
| Primary key. ID da account de anúncios. |
|
| Nome da account de anúncio. |
|
| Tipo de conta. |
|
| Status de aprovação do administrador. |
|
| ID de negócio associado. |
|
| Quando a conta foi criada. |
|
| Quando a conta foi modificada pela última vez. |
|
| Código da moeda da account, por exemplo |
|
| Fuso horário da conta. |
|
| Configuração do tipo de atribuição. |
|
| Configuração do tipo de atribuição do aplicativo. |
|
| Janela de atribuição de cliques. |
|
| Janela de view de atribuição. |
|
| Janela de atribuição de clique do aplicativo. |
|
| Janela de atribuição de visualização do aplicativo. |
|
| Tipo de limite de gastos. |
|
| Motivo da suspensão da account, se aplicável. |
|
| Comunidades excluídas da segmentação. |
|
| Palavras-chave excluídas da segmentação. |
|
| Preferências de parceiros Pixel. |
|
| ID de membro de contato principal. |
campaign
Configuração e configurações da campanha.
Coluna | Tipo de dados | Descrição |
|---|---|---|
|
| Primary key. ID da campanha. |
|
| ID da conta de anúncio associada. |
|
| Nome da campanha. |
|
| Objetivo da campanha. |
|
| Status definido pelo usuário (ATIVO ou PAUSADO). |
|
| Status de entrega efetivo. |
|
| Motivos detalhados do status de entrega. |
|
| Quando a campanha foi criada. |
|
| Quando a campanha foi modificada pela última vez. |
|
| Hora de início da campanha. |
|
| Hora de término da campanha. |
|
| Tipo de licitação. |
|
| Estratégia de lance. |
|
| Valor do lance na moeda da account. |
|
| Tipo de objetivo. |
|
| Valor da meta na moeda da account. |
|
| Limite de gastos na moeda da account. |
|
| ID de pixel de conversão associado. |
|
| ID de instrumento de financiamento associado. |
|
| Objetivo de otimização. |
|
| Tipo de conversão de view-through. |
|
| ID do aplicativo associado. |
|
| Rótulo de fatura. |
|
| Se a otimização do orçamento da campanha está no modo MAX. |
|
| Se a otimização do orçamento da campanha está ativada. |
|
| Categorias de anúncios especiais (por exemplo, moradia, crédito). |
|
| Metadados SKAdNetwork. |
|
| Configuração de restrição de idade. |
ad_group
Configuração e configurações do grupo de anúncios.
Coluna | Tipo de dados | Descrição |
|---|---|---|
|
| Primary key. ID do grupo de anúncios. |
|
| ID da conta de anúncio associada. |
|
| ID da campanha associada. |
|
| Nome do grupo de anúncios. |
|
| Status definido pelo usuário. |
|
| Status de entrega efetivo. |
|
| Motivos detalhados do status de entrega. |
|
| Quando o grupo de anúncios foi criado. |
|
| Quando o grupo de anúncios foi modificado pela última vez. |
|
| Horário de início do grupo de anúncios. |
|
| Hora de término do grupo de anúncios. |
|
| Tipo de licitação. |
|
| Estratégia de lance. |
|
| Valor do lance na moeda da account. |
|
| Tipo de objetivo. |
|
| Valor da meta na moeda da account. |
|
| ID de pixel de conversão associado. |
|
| Objetivo de otimização. |
|
| Tipo de conversão de view-through. |
|
| Se a otimização do orçamento da campanha está ativa para este grupo de anúncios. |
|
| Tipo de objetivo da campanha. |
|
| ID do aplicativo associado. |
|
| ID do conjunto de produtos associado. |
|
| Tipo de compra. |
|
| ID de público salvo. |
|
| String JSON contendo configurações de segmentação. |
|
| Configurações de segmentação de compras. |
|
| String JSON contendo configurações de programação de anúncios. |
|
| Metadados SKAdNetwork. |
ad
Detalhes e configurações de anúncios individuais. Corresponde a ads na API do Reddit Ads.
Coluna | Tipo de dados | Descrição |
|---|---|---|
|
| Primary key. ID do anúncio. |
|
| ID da conta de anúncio associada. |
|
| ID do grupo de anúncios associado. |
|
| ID da campanha associada. |
|
| Nome do anúncio. |
|
| Tipo de anúncio. |
|
| Status definido pelo usuário. |
|
| Status de entrega efetivo. |
|
| Motivos detalhados do status de entrega. |
|
| Quando o anúncio foi criado. |
|
| Quando o anúncio foi modificado pela última vez. |
|
| URL de destino quando o anúncio é clicado. |
|
| Parâmetros de query anexados ao URL do clique. |
|
| Tipo de objetivo da campanha. |
|
| ID da publicação do Reddit associado. |
|
| URL da publicação associada do Reddit. |
|
| ID de perfil associado. |
|
| URL de visualização de anúncio. |
|
| Quando o URL de pré-visualização expira. |
|
| String JSON contendo configurações de rastreador de eventos. |
|
| Produtos associados. |
|
| Motivo da rejeição do anúncio, se aplicável. |
|
| Configurações de criativos de compras. |
|
| Metadados SKAdNetwork. |
Relatar esquemas de tabela
Todas as tabelas de relatório compartilham as mesmas colunas de métricas. Eles diferem apenas em suas colunas de chave primária.
Colunas de métricas compartilhadas
Cada tabela de relatório inclui account_id (string) e as seguintes colunas de métricas:
Entrega essencial.
Coluna | Tipo de dados | Descrição |
|---|---|---|
|
| Número de impressões. |
|
| Número de cliques. |
|
| Despesa total na moeda da account. |
|
| Custo efetivo por mil impressões. |
|
| Custo por clique. |
|
| Custo por view. |
|
| Taxa de cliques. |
|
| Número de usuários únicos atingido. |
|
| Número médio de vezes que cada usuário viu o anúncio. |
|
| Número de impressões visualizáveis. |
|
| Número de cliques engajados. |
|
| Número de leads do Reddit. |
|
| Retorno sobre o investimento em publicidade proveniente de conversões. |
Engajamento (preenchido para campanhas de engajamento; null para outros tipos de campanha)
Coluna | Tipo de dados | Descrição |
|---|---|---|
|
| Número de curtidas no anúncio. |
|
| Número de votos negativos no anúncio. |
|
| Número de votos positivos em comentários. |
|
| Número de votos negativos em comentários. |
|
| Número de comentários enviados. |
|
| Número de visualizações da página de comentários. |
Reproduções de vídeo e tempo de exibição.
Coluna | Tipo de dados | Descrição |
|---|---|---|
|
| Número de vezes que a reprodução de vídeo foi começada. |
|
| Número de vezes que o vídeo foi expandido. |
|
| Número de reproduções com som ativado. |
|
| Número de visualizações atingindo 3 segundos. |
|
| Número de visualizações que atingem 5 segundos. |
|
| Número de visualizações com 10 segundos. |
|
| Número de visualizações atingindo 25% de conclusão. |
|
| Número de visualizações atingindo 50% de conclusão. |
|
| Número de visualizações que atingem 75% de conclusão. |
|
| Número de views atingindo 95% de conclusão. |
|
| Número de visualizações atingindo 100% de conclusão. |
Taxas de vídeo e visibilidade
Coluna | Tipo de dados | Descrição |
|---|---|---|
|
| Taxa de view de vídeo. |
|
| Taxa de visualização de vídeo aos 6 segundos. |
|
| Taxa de visualização de vídeo aos 15 segundos. |
|
| Taxa de conclusão de vídeo. |
|
| Número de impressões totalmente visualizáveis. |
|
| Número de impressões visualizáveis. |
|
| Número de impressões visíveis assistidas por 6 segundos. |
|
| Número de impressões visualizáveis assistidas por 15 segundos. |
Custo por view
Coluna | Tipo de dados | Descrição |
|---|---|---|
|
| Custo por visualização de 3 segundos. |
|
| Custo por visualização de 6 segundos. |
|
| Custo por vista de 15 segundos. |
|
| Custo por view concluída. |
Outro
Coluna | Tipo de dados | Descrição |
|---|---|---|
|
| Código de moeda para colunas monetárias. |
|
| Quando as métricas foram atualizadas pela última vez. Usado como o cursor incremental. |
campaign_report
Métricas de desempenho em nível de campanha.
Chave primária: campaign_id (string), date (date, YYYY-MM-DD).
Inclui todas as colunas de métricas compartilhadas mais account_id (string).
ad_group_report
Métricas de desempenho em nível de grupo de anúncios.
Chave primária: ad_group_id (string), date (date, YYYY-MM-DD).
Inclui todas as colunas de métricas compartilhadas mais account_id (string) e pacing (double), que são retornadas automaticamente para o detalhamento do grupo de anúncios.
ad_report
Métricas de desempenho em nível de anúncio.
Chave primária: ad_id (string), date (date, YYYY-MM-DD).
Inclui todas as colunas de métricas compartilhadas mais account_id (string).
campaign_country_report
Métricas de desempenho no nível da campanha divididas por país.
Chave primária: campaign_id (string), date (date, AAAA-MM-DD), country (string).
Inclui todas as colunas de métricas compartilhadas mais account_id (string).
Relatórios personalizados
Um relatório personalizado permite escolher as dimensões exatas de detalhamento e os campos de métrica desejados. Declare-o definindo source_table: custom_report e fornecendo a definição do relatório em connector_options.reddit_ads_options.custom_report_options.
O nome destination_table é obrigatório para relatórios personalizados.
A chave primária de um relatório personalizado é composta pelas colunas de detalhamento escolhidas. Campos de métricas são armazenados como valores de dados.
Relatório personalizado, detalhamentos e campos
Detalhamentos compatíveis — você deve incluir pelo menos uma dimensão de tempo (DATE ou HOUR). O nome da coluna de destino é exibido entre parênteses.
DATE (data), HOUR (hora), AD_ACCOUNT_ID (account_id), AD_GROUP_ID (ad_group_id), AD_ID (ad_id), CAMPAIGN_ID (campaign_id), COMMUNITY (comunidade), COUNTRY (país), DMA (dma), GALLERY_ITEM_ID (post_id), GENDER (gênero), INTEREST (interesse), KEYWORD (palavra-chave), OS_TYPE (os_type), PLACEMENT (posicionamento), REGION (região).
**Campos compatíveis** (o nome da coluna de destino é o token em minúsculas):
Entrega principal: IMPRESSIONS (long), CLICKS (long), SPEND (decimal(19,2)), CPC (decimal(19,2)), ECPM (decimal(19,2)), CTR (double), CONVERSION_ROAS (double).
Vídeo: VIDEO_STARTED, VIDEO_PLAYS_EXPANDED, VIDEO_PLAYS_WITH_SOUND, VIDEO_WATCHED_3_SECONDS, VIDEO_WATCHED_5_SECONDS, VIDEO_WATCHED_10_SECONDS, VIDEO_WATCHED_25_PERCENT, VIDEO_WATCHED_50_PERCENT, VIDEO_WATCHED_75_PERCENT, VIDEO_WATCHED_95_PERCENT, VIDEO_WATCHED_100_PERCENT, VIDEO_FULLY_VIEWABLE_IMPRESSIONS, VIDEO_VIEWABLE_IMPRESSIONS (todos long).
Conversões de instalação de aplicativo: APP_INSTALL_ADD_PAYMENT_INFO_COUNT, APP_INSTALL_ADD_TO_CART_COUNT, APP_INSTALL_APP_LAUNCH_COUNT, APP_INSTALL_COMPLETED_TUTORIAL_COUNT, APP_INSTALL_INSTALL_COUNT, APP_INSTALL_MMP_INSTALL_COUNT, APP_INSTALL_MMP_TOTAL_INSTALL_COUNT, APP_INSTALL_SKAN_INSTALL_COUNT, APP_INSTALL_SKAN_TOTAL_INSTALL_COUNT, APP_INSTALL_LEVEL_ACHIEVED_COUNT, APP_INSTALL_PURCHASE_COUNT, APP_INSTALL_SEARCH_COUNT, APP_INSTALL_SIGN_UP_COUNT, APP_INSTALL_SPEND_CREDITS_COUNT, APP_INSTALL_VIEW_CONTENT_COUNT (todas long).
Outros: PRIORITY (string).