Índice

• 01 - Criação de integrações separadas de taxonomia e de estatísticas

#01 - Criação de integrações separadas de taxonomia e estatísticas

O que é?

Consiste na criação de duas integrações separadas: uma para trazer as métricas e estatísticas dos anúncios, grupos de anúncio e campanhas do Google Ads com seus respectivos IDs, e outra para trazer apenas os IDs e seus respectivos nomes, para posterior junção das duas através de um modelo.

Por que fazer?

Os IDs dos anúncios, grupos de anúncios e campanhas do Google Ads são dados imutáveis no Google Ads, porém, os seus nomes podem ser alterados pelos usuários diretamente na ferramenta a qualquer momento.

As integrações do Google Ads que possuem dimensões de data são incrementais com janela de atualização, isso faz com que apenas os dados novos ou atualizados em uma determinada janela de dias sejam atualizados no seu destino. Pelo fato de não precisarmos trazer toda a base histórica em todas as execuções das integrações, elas ficam mais rápidas e consomem menos registros.

Porém, quando há uma mudança de nome de alguma dimensão, isso fará com que campanhas, anúncios ou grupos de mesmo ID possuam nomes diferentes na sua tabela de destino (nome antigo e nome novo) e poderá causar certa confusão na hora da análise.

Ao criar uma integração para trazer a base histórica das métricas de seus anúncios, e outra para trazer apenas os IDs e nomes de suas campanhas, grupos e anúncios (fazendo a junção das duas através de um modelo) você não precisará fazer uma edição avançada em sua integração de estatísticas para trazer todo o seu histórico novamente sempre que houver alguma alteração de nome, garantindo assim que no seu destino estejam sempre os nomes corretos e atualizados e prevenindo a necessidade de refazer cargas históricas.

Primeira parte: Integração de estatísticas

1.Para começar, acesse o tutorial de como criar uma integração de relatório customizado do Google Ads clicando aqui.

2. Siga todos os passos do tutorial até o passo 6.

3. Ao chegar no passo 6 do tutorial, iremos escolher o tipo de relatório “Ad Group Ad” (seguindo o tutorial de exemplo de relatório de estatísticas de anúncios), mas você poderá escolher o tipo de relatório que desejar:

4. Neste passo iremos selecionar as dimensões da integração. Ao selecionar uma dimensão de data é necessário também definir o savepoint e janela de atualização (leia mais sobre aqui). Lembrando que nessa integração deverão ir apenas os IDs dos anúncios, grupos de anúncios e campanhas, sem os nomes delas:

• Ad Group: Id - Id do grupo de anúncio
• Date: Data da métrica
• Campaign: Id - Id da campanha
• Ad Group Ad: Ad: Id - Id do anúncio

5. Após selecionar as dimensões, você poderá definir as métricas que deseja trazer e clicar em "Próximo". Em nosso exemplo trazemos as métricas abaixo:

• Cost: Custo
• Clicks: Cliques
• Impressions: Impressões

6. No passo seguinte, será possível definir o nome que a tabela da integração terá no seu destino e visualizar as colunas dela clicando em "Campos". Note que nesta integração as dimensões são apenas a data e os IDs:

7. No passo final basta dar um nome para sua integração, definir a frequência de execução dela e então clicar em "Salvar Integração".

8. . Após a primeira execução da integração, os dados poderão ser encontrados no seu destino pelo nome de tabela dado no passo 6. A sua tabela será parecida com essa:

Segunda parte: Integração de taxonomia

1. Siga o tutorial da integração anterior até o passo 3.

2. Neste passo iremos definir as dimensões da integração. Como na integração anterior já selecionamos as métricas e dimensões de data, nesta iremos apenas selecionar as dimensões de Id dos anúncios, grupos de anúncios e campanhas juntamente com seus nomes:

3. O campo de "Métricas" deve permanecer vazio.

4. Após clicar em "Próximo", você poderá definir o nome que a tabela da sua integração terá no destino e conferir os seus campos. Note que nesta tabela teremos apenas os Ids de anúncios, grupos de anúncios e campanhas e seus nomes:

5. No passo final você poderá dar um nome para sua integração e definir a sua frequência. Após salvá-la, você poderá executá-la manualmente ou aguardar pela primeira atualização conforme a frequência escolhida.

6. Após a primeira execução você poderá encontrar a tabela no seu destino pelo nome definido no passo 4. A sua tabela no destino será parecida com essa:

Terceira parte: Criação de modelo para junção das duas integrações

Agora, basta criar um modelo na Kondado para junção das duas tabelas, dessa forma você terá uma única tabela em seu destino trazendo os dados dos seus anúncios já com a sua taxonomia. Essa tabela será atualizada automaticamente sempre que as duas integrações acima forem executadas.

1. Siga o tutorial de criação de modelos até o passo 4. Neste passo é importante lembrar que as integrações acionadoras (campo "Acionadores" do modelo) devem ser as duas integrações criadas acima, dessa forma sempre que elas forem executadas, seu modelo será atualizado automaticamente no seu destino.

2. No momento de inserção da query do seu modelo, use a query abaixo como exemplo:

SELECT
    e._kdd_account_id AS id_conta,
    e.segments_date AS data_metrica,
    e.campaign_id AS id_campanha,
    t.campaign_name AS nome_campanha,
    e.adgroup_id AS id_grupo_anuncio,
    t.adgroup_name AS nome_grupo_anuncio,
    e.adgroupad_ad_id AS id_anuncio,
    t.adgroupad_ad_name AS nome_anuncio,
    e.metrics_cost AS custo,
    e.metrics_clicks AS cliques,
    e.metrics_impressions AS impressoes
FROM googleads_estatisticas_anuncios e
LEFT JOIN googleads_taxonomia t ON e._kdd_account_id = t._kdd_account_id AND e.campaign_id = t.campaign_id AND e.adgroup_id = t.adgroup_id AND e.adgroupad_ad_id = t.adgroupad_ad_id

Lembre-se de substituir as informações quando for necessário (nomes das tabelas, nomes dos campos e etc). É importante que o JOIN seja dado com todos os campos de ID (conta, campanha, grupo de anúncio e anúncio) para que os dados sejam refletidos corretamente na tabela do modelo. Caso deseje, conheça um pouco mais sobre o comando JOIN neste artigo.

A query de exemplo usa a sintaxe do banco PostgreSQL, caso seu banco seja de outro tipo, basta adaptá-la para a sintaxe do seu banco.

3. Após adaptar e inserir a sua query no editor de queries do modelo, basta clicar em "Salvar", "Publicar" e então ativá-lo editando o campo "Ativo?" na barra lateral:

4. Sempre que as suas integrações acionadoras forem executadas, o seu modelo será atualizado automaticamente no destino. Você poderá encontrar a tabela pelo nome definido nas configurações do modelo (campo "Nome da tabela"). Após a primeira execução, o ícone do seu modelo mudará para verde:

E a sua tabela terá uma estrutura parecida com essa no seu destino:

Agora, sempre que o nome de algum anúncio, grupo de anúncio ou campanha for modificado diretamente no Google Ads, bastará fazer uma edição avançada na sua segunda integração (contendo os Ids e nomes), não sendo necessária nenhuma modificação no modelo ou na sua integração de estatísticas.