Google Ads, parte 1: criar as credenciais no Google Cloud

A integração do Google Ads envia ao Google cada pedido que fica Pago no CRM, como uma conversão offline. O envio usa a Google Data Manager API e leva o valor do pedido, o clique do anúncio (gclid) que o site guardou no lead e o e-mail e o telefone do aluno, criptografados.

Para isso, o CRM precisa de três credenciais criadas no Google Cloud: Client ID, Client Secret e Refresh Token. Este artigo é a parte 1. A parte 2 cria a ação de conversão no Google Ads e cadastra tudo no CRM: Google Ads, parte 2.

O mesmo guia está resumido no CRM, na aba Google Ads, em Como obter as credenciais do Google Ads?.

Antes de começar

• Um e-mail Google com acesso Administrador ou Padrão à conta do Google Ads da sua instituição. Faça todos os passos logado com esse mesmo e-mail.
• O endereço do site da instituição e o endereço da política de privacidade (o Google pede os dois).
• Uns 30 minutos. Siga os passos na ordem: a ordem importa.

Quem pode fazer

No Google: quem administra as contas Google da instituição (muitas vezes o gestor de tráfego ou a agência). No CRM, o cadastro é feito pelo Administrador (parte 2).

Passo a passo

1. Projeto e API

1. Acesse https://console.cloud.google.com e selecione um projeto, ou crie um novo.
2. Vá em APIs e serviços → Biblioteca, procure Data Manager API e clique em Ativar. O status deve ficar Ativado.

2. Tela de permissão OAuth (consentimento) e publicação do app

1. Vá em APIs e serviços → Tela de permissão OAuth. Abre a Google Auth Platform.
2. Em Público-alvo, escolha o tipo de usuário Externo.
3. Em Branding, preencha:
   • Nome do app (por exemplo, "CRM Ellige");
   • E-mail para suporte do usuário;
   • Página inicial do aplicativo: o site da instituição;
   • Link da Política de Privacidade;
   • Domínios autorizados: o domínio do site, sem https:// e sem www;
   • Dados de contato do desenvolvedor.
4. Não envie logotipo. Com logotipo, o Google passa a exigir a verificação do app.
5. Salve.
6. Volte em Público-alvo e clique em Publicar app. O status deve mudar de Testando para Em produção.

Por que publicar: com o app em Testando, o Refresh Token expira em 7 dias e o envio das vendas para sem aviso (erro invalid_grant nos logs). Em produção, ele não expira.

• Se o botão Publicar app estiver cinza, passe o mouse sobre ele: falta algum campo do Branding (normalmente a página inicial ou a política de privacidade).
• O aviso "Seu aplicativo precisa ser verificado" pode ser ignorado: o app é usado só pela sua conta. Não clique em "Voltar para o teste".

3. Cliente OAuth (Client ID e Client Secret)

1. Vá em APIs e serviços → Credenciais → Criar credenciais → ID do cliente OAuth.
2. Em Tipo de aplicativo, escolha Aplicativo da Web. Não use "App para computador".
3. Em URIs de redirecionamento autorizados, adicione exatamente https://developers.google.com/oauthplayground (sem barra no final).
4. Clique em Criar e copie o Client ID (termina em apps.googleusercontent.com) e o Client Secret (começa com GOCSPX-).

4. Refresh Token (OAuth 2.0 Playground)

Gere o token depois de publicar o app (passo 2), usando o seu próprio cliente (passo 3).

1. Acesse https://developers.google.com/oauthplayground.
2. Clique na engrenagem (canto superior direito), marque Use your own OAuth credentials e cole o Client ID e o Client Secret. Confirme Access type: Offline.
3. No Step 1, em Input your own scopes, cole o escopo https://www.googleapis.com/auth/datamanager e clique em Authorize APIs.
4. Entre com o e-mail que tem acesso à conta do Google Ads.
5. Na tela "O Google não verificou este app", clique em Avançado → Acessar (não seguro) → Continuar. É o esperado: o app é da sua instituição.
6. No Step 2, clique em Exchange authorization code for tokens.
7. Clique no campo Refresh token (começa com 1//0), selecione tudo e copie. O campo corta o texto na tela, mas a cópia leva o token inteiro.

O aviso do Playground de que os tokens são revogados em 24 horas não vale quando você usa as suas próprias credenciais (engrenagem).

Como conferir se funcionou

• Na Google Auth Platform, o status do app aparece como Em produção.
• Você tem em mãos o Client ID, o Client Secret e um Refresh Token gerado depois da publicação.
• O teste final é feito no CRM, na parte 2 (botão Testar envio).

Problemas comuns

Erro	Causa	Solução
Erro 400: redirect_uri_mismatch ao autorizar no Playground	Cliente do tipo errado (computador) ou redirecionamento não cadastrado	Crie o cliente como Aplicativo da Web, com https://developers.google.com/oauthplayground exato
invalid_grant nos logs depois de alguns dias	App em Testando ou token gerado antes de publicar	Publique o app, gere outro Refresh Token e troque no CRM
Botão Publicar app cinza	Falta campo no Branding	Preencha página inicial, política de privacidade e domínio autorizado
The caller does not have permission nos logs	O e-mail que gerou o token não tem acesso à conta de anúncios	Veja o passo de permissão na parte 2

Dúvidas comuns

Já gerei o token antes de publicar o app. Preciso gerar de novo? Sim. Um token gerado com o app em Testando continua expirando em 7 dias, mesmo depois de publicar. Gere outro e troque no CRM (botão Editar da integração → Refresh Token).

O que faz o Refresh Token parar de funcionar? App em Testando, troca da senha da conta Google que gerou o token ou remoção do acesso do app nessa conta. Nesses casos, gere um novo token.

Preciso passar pela verificação do Google? Não. Sem logotipo e usado só pela sua conta, o app funciona em produção sem verificação.

Posso guardar o arquivo de credenciais que o Google oferece para baixar? Pode, em local seguro. O Client Secret e o Refresh Token são sensíveis: não compartilhe nem mande em prints.