Sobre a Openflow Connector for Google Ads¶
Nota
This connector is subject to the Snowflake Connector Terms.
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.