Openflow Connector para Google Ads¶
Nota
O conector está sujeito aos termos do conector.
Este tópico descreve os conceitos básicos do Openflow Connector para Google Ads, as etapas para defini-lo e as limitações.
O Google Ads é uma plataforma de publicidade online em que os anunciantes podem criar e veicular anúncios para promover seus produtos ou serviços. Por meio do Google Ads, você pode criar anúncios online para alcançar as pessoas exatamente quando elas estiverem interessadas nos produtos e serviços oferecidos.
O Openflow Connector para Google Ads:
Ingere automaticamente os dados do Google Ads em sua conta Snowflake.
Faz download de dados usando a Google Ads API.
Permite que você configure relatórios personalizados com os atributos escolhidos, metrics e segments.
Use esse conector se quiser fazer o seguinte:
Importe as métricas do Google Ads para acompanhamento e otimização do desempenho
Casos de uso¶
Execute o conector em diferentes modos de ingestão¶
Há duas maneiras de ingerir dados: de forma incremental e como um instantâneo. O modo instantâneo é o padrão e fica ativado enquanto o segmento segments.date não estiver selecionado. Ele cria uma tabela no esquema de destino fornecido e anexa em cada cronograma os dados mais recentes do Google Ads.
Para configurar a ingestão incremental, o usuário deve preencher o parâmetro Report Segments com o segmento denominado segments.date; outros segmentos ainda podem ser predefinidos. Em seguida, os dados serão sobrepostos entre os que foram obtidos anteriormente e o intervalo de datas da execução atual. A sobreposição é causada pela janela de conversão, pois precisamos solicitar os dados históricos para o número de dias igual à janela de conversão; por exemplo, se a janela de conversão for definida como 14 dias e a ingestão ocorrer todos os dias, haverá 13 dias de sobreposição.
Reconfigure o conector atualmente em execução¶
A configuração do relatório pode ser alterada quando o processador estiver em execução. Para isso, acesse GetGoogleAdsReportContext e altere os parâmetros desejados. Ao alterar apenas os parâmetros Report Attributes, Metrics ou Segments, a tabela de destino atual será removida e uma nova tabela com o esquema atualizado será criada; portanto, antes de atualizá-los, esteja ciente de que os dados já baixados serão excluídos.
Quando o nome do recurso ou o ID de cliente da conta for alterado, uma nova tabela será criada. A tabela de destino antiga não será descartada.
A modificação da janela de cronograma e conversão não afetará de forma alguma os dados já obtidos na tabela de destino.
Quando a data de início for alterada, o conector executará uma única ingestão dessa data até a data atual e, em seguida, procederá normalmente no modo incremental. Se houver dados baixados do período entre a nova data de início e a data atual, eles serão substituídos após a alteração. Os dados anteriores à nova data de início não serão afetados.
Restrições de limitação de taxa¶
Os limites da API do Google Ads determinam quantas solicitações podem ser feitas em um determinado período. Se o seu fluxo exceder a cota permitida, as sincronizações poderão ficar lentas ou falhar com um erro. Isso ocorre principalmente quando o seu token de acesso faz um número maior de solicitações do que a fonte normalmente permite. Nesses casos, recomendamos solicitar uma cota de acesso maior (sempre que aplicável) ou reduzir a frequência de sincronização.
Limitações¶
Não há suporte para filtragem. Em vez disso, os dados podem ser filtrados após a ingestão.
Não há suporte para a ingestão de colunas personalizadas.
Ao segmentar relatórios, se todas as métricas selecionadas forem zero, elas serão sempre excluídas.
Não há suporte para a ingestão de recursos atribuídos. Em vez disso, vários relatórios podem ser unidos após a ingestão.
Só pode haver um relatório para cada combinação de nome de recurso e ID de cliente selecionados.
A modificação da definição do relatório quando os processadores estão em execução pode levar a inconsistências de dados. Para garantir a consistência, antes de atualizar a configuração, pare os processadores e limpe as filas.