Nossas integrações com o Google Ads sofrerão alterações e nós disponibilizamos abaixo o cronograma para que você possa fazer a migração sem sobressaltos.
Você pode realizar esse processo entre 7 de Março de 2022 e 25 de abril de 2022 – nós recomendamos que comece logo, as integrações novas serão gratuitas durante esse período 😉
Estamos fazendo essa migração porque, a partir do final de abril de 2022, o Google irá descontinuar a API que é utilizada nas integrações atuais e realizaremos as alterações necessárias para nos adequar e continuar oferecendo nossas integrações sem interrupções.
Abaixo, explicamos estas mudanças mais a fundo e as ações que você precisará tomar para evitar interrupções no seu fluxo de dados.
Porque a mudança?
Atualmente, nossas integrações do Google Ads utilizam-se da AdWords API, que será descontinuada pelo Google em favor da Google Ads API ao final de abril de 2022.
Novos tipos de relatórios, métricas e dimensões
Com a nova API, também virão novos tipos de relatórios, que são mais completos do que os disponíveis atualmente. O conceito de métricas e dimensões continuará existindo – e as dimensões e métricas também são diferentes nesta nova versão.
Para ajudar na migração, o google disponibilizou um guia com um “de-para” de relatórios e campos (métricas e dimensões)
Veja abaixo um exemplo de migração da integração da Kondado de relatório customizado
Além disso, nem todas as integrações serão incrementais, você poderá acompanhar na documentação do conector o que irá determinar se uma integração será integral ou incremental, bem como o comportamento da janela de atualização.
As integrações da versão anterior, que deverão ser migradas, serão marcadas na Kondado com o pos-fixo “[V1]” enquanto as integrações da nova versão terão o pos-fixo “[Versão Atual]” durante o período de migração
Ações que devem ser tomadas por você
A partir do dia 7 de março de 2022, iremos disponibilizar a nova integração de relatório customizado de forma gratuita. Deste dia em diante, você já poderá criar suas novas integrações e testá-las sem que isso desconte do seu plano. Recomendamos que faça a migração entre o seu relatório na versão anterior e a nova versão o quanto antes, para assim se familiarizar com os novos relatórios e campos.
A versão antiga da integração continuará disponível por um tempo, conforme as fases do cronograma abaixo
Cronograma de implementação
- 7 de março de 2022
- Nova integração de relatório customizado será disponibilizada e sua utilização não irá descontar do seu plano
- Ação necessária da sua parte: comece a utilizar a nova integração e migrar as suas integrações de relatório customizados o quanto antes – veja este exemplo de como é simples o processo de migração
- As suas integrações existentes da versão anterior não sofrerão nenhuma alteração
- 8 de março de 2022
Nova integração de contas será disponibilizada e sua utilização não irá descontar do seu plano- Atualização 2022-03-08: Ao invés de uma nova integração, optamos por criar um exemplo de como a integração de contas da versão anterior pode ser replicada utilizando a nova integração de relatório customizado
- Ação necessária da sua parte: comece a utilizar a nova integração e migrar as suas integrações de contas o quanto antes- veja este exemplo de como é simples o processo de migração
- As suas integrações existentes da versão anterior não sofrerão nenhuma alteração
- 9 de março de 2022
- As integrações da versão antiga (V1) não serão acessíveis a contas da Kondado (clientes e testes grátis) criadas a partir de hoje
- Ação necessária da sua parte: Se você já era nosso cliente ou criou o seu teste grátis antes desta data, esta fase não afeta os seus conectores. Esta fase vale apenas para contas novas da Kondado, criadas a partir de 9/3/22
- 11 de abril de 2022
- Não será mais possível criar ou fazer edições avançadas nas integrações existentes da versão anterior, mas elas continuarão executando
- Ação necessária da sua parte: comece a utilizar as novas versões das integrações e migrar as suas integrações o quanto antes – veja este exemplo de como é simples o processo de migração
- As integrações da versão nova continuam gratuitas
- 25 de abril de 2022
- As integrações da versão anterior (marcadas como V1) deixarão de funcionar
- Ação necessária da sua parte: utilize as novas versões das integrações
- As integrações da versão nova continuam gratuitas
- 26 de abril de 2022
- As integrações da versão nova deixarão de ser gratuitas
- As integrações da versão atual terão seu nome trocado para remover o label “Versão Atual”, já que serão a única versão ativa
Como sempre, fique à vontade para tirar qualquer dúvidas conosco através do nosso chat!
Exemplo de migração da integração de Relatório Customizado [V1]
Vamos considerar uma integração do tipo “Relatório Customizado [V1]”, que possui a seguinte configuração:
1) O primeiro passo para realizar a migração é criar uma nova integração que poderá executar em paralelo à atual, já que a versão nova será gratuita durante o período de migração.
2) Após os primeiros passos normais do processo de criação de uma nova integração, você chegará no ponto de escolher o objeto/integração. Selecione “Relatório Customizado [Versão Atual]”, que é o correspondente desse tipo de integração na nova versão.
3) Agora você pode escolher o relatório a ser utilizado
- Na versão [V1], está sendo utilizado o relatório “AD_PERFORMANCE_REPORT”
- Ao consultar o mapa de correspondência do Google (disponibilizado aqui), é possível ver que esse relatório corresponde ao “ad_group_ad” da nova versão, que na Kondado é representado pelo label “Ad Group Ad”, então basta selecionar esse relatório na nova integração
Dica: Os nomes de relatórios novos na Kondado serão Capitalizados após o underline. Então por exemplo, “ad_group_ad” ser transformará em “Ad Group Ad”
4) Agora é hora de selecionar as novas dimensões e métricas (campos) do relatório
A maneira mais fácil de fazer essa seleção é acessando as propriedades da sua integração da versão antiga, que está localizada na região à direita após você clicar em “DETALHES”
Na seção de propriedades, você encontra o nome dos campos (dimensões e propriedades) conforme estarão no mapa de correspondência do Google (disponibilizado aqui) e poderá buscar buscar por eles mais facilmente.
Abaixo você pode conferir o resultado dessa migração. As colunas da tabela, são encontradas da seguinte forma:
- Campo V1: Nome do campo antigo, conforme pode ser encontrado no menu de criação/edição avançada da integração
- Código campo V1: Código do campo antigo, conforme pode ser encontrado nas propriedades da integração existente
- Novo código campo: novo código do campo, encontrado no mapa de correspondência do google
- Novo campo: nome do novo campo, conforme representado no menu de criação da nova integração
Dimensões
| 1. Campo V1 | 2. Código campo V1 | 3. Novo código campo | 4. Novo campo |
|---|---|---|---|
| Ad Group | AdGroupName | ad_group.name | Ad Group: Name |
| Campaign | CampaignName | campaign.name | Campaign: Name |
| Ad | Headline | ad_group_ad.ad.text_ad.headline | Ad Group Ad: Ad: Text Ad: Headline |
| Ad Type | AdType | ad_group_ad.ad.type | Ad Group Ad: Ad: Type |
| Final URL | CreativeFinalUrls | ad_group_ad.ad.final_urls | Ad Group Ad: Ad: Final Urls |
| Day | Date | segments.date | Date |
Métricas
| 1. Campo V1 | 2. Código campo V1 | 3. Novo código campo | 4. Novo campo |
|---|---|---|---|
| Cost | Cost | metrics.cost_micros | Cost |
| Clicks | Clicks | metrics.clicks | Clicks |
| Impressions | Impressions | metrics.impressions | Impressions |
Dica: Os nomes dos campos (métricas e dimensões na Kondado) são formatados na Kondado levando em conta que quando há um pertencimento entre recursos (representado no guia do google por “.”), será utilizado “:” na Kondado, além disso, os nomes também terão sua primeira letra maiúscula. Outro ponto importante é que a Kondado já faz a divisão do que o Google traz como “micros”, então esse prefixo/posfixo pode ser ignorado
5) Os outros parâmetros são correspondentes na versão nova, assim, a configuração daintegração na versão atual ficaria desta forma:
6) Agora basta clicar em próximo, escolher um novo nome para a tabela, e clicar em SALVAR
Este é apenas um exemplo de como fazer a migração da integração de Relatório Customizado [V1] para a [Versão Atual]. Os resultados finais podem variar entre as integrações devido a alguns fatores, alguns deles estão descritos em uma nota ao final da documentação da integração de Relatório Customizado [Versão Atual].
Além disso, caso o relatório/campo não seja diretamente encontrado como o fluxo do nosso exemplo, pode ser necessário utilizar outro campo/relatório. Aqui está a referência de campos e relatórios encontrados
Exemplo de migração da integração de Conta [V1]
A integração de Conta pode ser replicada utilizando a nova integração de Relatório Customizado, com a seguinte configuração:
Este é apenas um exemplo de como fazer a migração da integração de Contas [V1] para utilizando a [Versão Atual]. Os resultados finais podem variar entre as integrações
Publicado em 2022-03-03