Perguntas Frequentes sobre o conector de ingestão 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 responde a perguntas frequentes sobre o conector de ingestão do Reddit Ads no Databricks Lakeflow Connect.
Perguntas frequentes gerais sobre conectores gerenciados
As respostas nas Perguntas Frequentes sobre conectores gerenciados se aplicam a todos os conectores gerenciados no Lakeflow Connect. Continue lendo para as Perguntas Frequentes específicas do Reddit Ads.
Como o Databricks se conecta ao Reddit Ads?
A Databricks se conecta à API do Reddit Ads usando autenticação OAuth 2.0 user-to-machine (U2M) com PKCE. O escopo adsread é definido automaticamente pela Databricks. As credenciais de conexão são armazenadas com segurança no Unity Catalog e só podem ser recuperadas se o usuário que executa o fluxo de ingestão tiver as permissões apropriadas.
Que tipos de tabelas o conector pode ingerir?
O conector suporta dois tipos de tabelas:
- Tabelas de entidade (
ad_account,campaign,ad_group,ad): Dados de configuração sobre sua account. As tabelas de entidade são totalmente atualizadas a cada execução de pipeline e não oferecem suporte ao acompanhamento da história (SCD tipo 2). - Tabelas de relatório : Métricas de desempenho, como impressões, cliques e gastos. As tabelas de relatório suportam a ingestão incremental com uma janela de lookback configurável.
Para a lista completa de tabelas compatíveis e seus esquemas, consulte referência do conector do Reddit Ads.
Como o conector extrai as atualizações incrementalmente?
As tabelas de relatório usam ingestão incremental. Como as métricas do Reddit Ads podem mudar depois que são relatadas pela primeira vez (por exemplo, quando as conversões ou a atribuição são recalculadas), o conector relê os dias de dados mais recentes a cada sincronização. Por default, ele relê os últimos 30 dias. Você pode alterar isso com o parâmetro lookback_window_days (qualquer valor de 1 a 30). As tabelas de entidade são totalmente atualizadas a cada execução.
Como defino a janela de retrospectiva para corresponder à minha janela de atribuição?
Defina lookback_window_days para corresponder à janela de atribuição de conversão de sua organização. Por exemplo, se sua organização usa uma janela de atribuição de 14 dias, defina lookback_window_days: 14. Consulte Janelas de atribuição e de lookback.
Quanta data histórica o conector ingere?
Por default, o conector ingere dois anos de dados históricos para tabelas de relatório. É possível configurar isso com o parâmetro sync_start_date (uma data no formato YYYY-MM-DD). Este parâmetro se aplica apenas à primeira execução — após o primeiro checkpoint, alterá-lo não tem efeito sem um refresh completo.
Por que os dados do meu relatório estão sem datas mais antigas?
A API de relatórios do Reddit Ads serve dados de relatório de aproximadamente os últimos 24 meses. Independentemente de sync_start_date, as tabelas de relatório não podem recuperar dados mais antigos do que esta janela — solicitações de dados mais antigos são rejeitadas pelo Reddit. Este limite se aplica apenas às tabelas de relatório, não às tabelas de entidade. Consulte Retenção de dados de relatório.
Como faço para definir um relatório personalizado?
Defina source_table como custom_report, forneça um nome destination_table e especifique a configuração do relatório em connector_options.reddit_ads_options.custom_report_options. A lista breakdowns deve incluir pelo menos uma dimensão de tempo (DATE ou HOUR), que se torna o cursor incremental da tabela. Os valores de detalhamento e campo devem vir das listas compatíveis. Consulte Detalhamentos e campos de relatórios personalizados.
Em qual fuso horário estão as datas do relatório?
Os limites de data do relatório são interpretados no fuso horário da própria conta de anúncio. O conector lê isso automaticamente da account. Você não define um fuso horário na especificação do pipeline.
Em que moeda estão as colunas monetárias?
Colunas monetárias (por exemplo, spend, cpc, bid_value) são armazenadas na moeda da conta de anúncios como valores decimais (por exemplo, 12.34), não em micros. O código da moeda da conta está disponível na coluna ad_account.currency e na coluna currency do relatório.
Um pipeline pode ingerir de várias contas de anúncios?
Sim. Um pipeline pode ingerir de vários esquemas de conta de anúncio, e cada entrada source_schema em um pipeline mapeia para uma conta de anúncio. Consulte Esquemas de origem.
O conector detecta exclusões?
Tabelas de entidade recebem um refresh completo em cada execução, portanto, seu estado atual sempre reflete a origem. Tabelas de relatório usam ingestão incremental dentro da janela de retrospectiva. Para ressincronizar completamente uma tabela, execute um refresh completo.