Dinheiro

Google Ads: conexão e conversões

Todos os ajustes Google ficam em Fontes → Conta de anúncios → Google: seu aplicativo OAuth, conta, ações, tags, gasto e histórico. No fluxo, apenas selecione essa fonte. O fluxo não tem conexão Google nem IDs de ações separados.

Neste guia: propriedade dos recursos · opções de conexão · pré-requisitos · Google Cloud e OAuth · conectar uma fonte · seleção de conta · IDs de ação manuais · IDs e rótulos · fluxos individuais · envio de postbacks · tags do navegador · gastos · verificação · solução de problemas · manutenção · perguntas frequentes.

1. A quem pertencem as contas e as permissões?

Esta integração com o Ads não usa um aplicativo OAuth, projeto do Cloud, developer token ou MCC compartilhado do ArtisanClo. Também não substitui suas credenciais pelas de outro cliente. As solicitações do servidor continuam sendo executadas na infraestrutura do ArtisanClo; usar seu próprio aplicativo não significa que elas saiam do seu computador.

O Client Secret e os tokens de acesso e atualização são armazenados criptografados. Os segredos salvos não são devolvidos ao formulário. Deixar vazio um campo de segredo já salvo mantém o valor anterior. Os visitantes recebem apenas IDs e rótulos públicos das tags. A separação de recursos não garante proteção contra restrições do Google: suas regras continuam valendo para contas, aplicativos e uso do serviço.

2. Escolha os recursos necessários

Você pode ativar o envio pelo servidor e pelo navegador juntos. Eles registram momentos diferentes e não são unidos automaticamente em uma conversão. Veja duplicatas e metas de conversão.

3. Prepare o rastreamento e a fonte

1. Seu plano deve incluir o envio de conversões para plataformas de anúncios. A importação de gastos é um recurso separado do plano. As configurações mostram as restrições quando um recurso está indisponível.
2. Use um fluxo com o tracker ativado. Fluxos apenas com cloaking não enviam conversões da fonte. Selecione a fonte nas configurações de rastreamento do fluxo.
3. Configure as conversões recebidas do seu site, rede de afiliados ou tracker externo. Passe o ID de clique do ArtisanClo para a oferta e devolva-o no postback.
4. Confira se as visitas de anúncios preservam um gclid, gbraid ou wbraid real. O click_id interno do ArtisanClo relaciona o postback à visita; o identificador do Google relaciona a visita ao anúncio. Os dois vínculos são necessários.
5. Use um usuário do Google com permissões suficientes na conta de destino do Ads ou em um MCC acessível. As permissões do Cloud, sozinhas, não dão acesso à conta do Google Ads.

Não invente um ID de clique do Google para um envio normal. gad_source, valores UTM, e-mail e IDs de transação não podem substituí-lo. Conectar o Google depois não recupera um identificador ausente na visita original.

4. Configure seu próprio aplicativo do Google Cloud

1. Abra o Google Cloud Console e selecione ou crie um projeto sob seu controle.
2. Ative a Data Manager API na biblioteca de APIs para enviar conversões pelo servidor.
3. Para listar contas, criar ações automaticamente ou importar gastos, ative também a Google Ads API. Confira o nível de acesso do projeto no Google Ads API Overview e cumpra os requisitos do Google para as contas desejadas. Acesso apenas de teste não basta para contas de anúncios de produção. Níveis de acesso do projeto.
4. Configure a identidade do aplicativo, o e-mail de contato e o público no Google Auth Platform. Um público interno permite apenas usuários daquela organização. Em Testing, adicione o endereço do Google que usará como usuário de teste.
5. Crie um OAuth Client ID do tipo Web application. No ArtisanClo, abra a fonte → Conta de anúncios → Google → conversões do servidor → seu próprio aplicativo OAuth do Google Cloud. Copie o Authorized redirect URI exibido para as configurações desse cliente OAuth.
6. Copie o Client ID e o Client Secret para a fonte. O Client ID normalmente termina em .apps.googleusercontent.com. Não cole uma chave de API, número de conta do Ads ou arquivo JSON inteiro nesses campos.

Copie a URL de retorno exatamente, incluindo protocolo, domínio e caminho. Não substitua /en/ pelo idioma do painel: o caminho de retorno é fixo. Instalações locais e de produção podem exibir endereços diferentes. Requisitos do Google para OAuth na web.

A conexão do servidor solicita openid, email e https://www.googleapis.com/auth/datamanager. Ativar a opção Google Ads API adiciona https://www.googleapis.com/auth/adwords. Conceda as permissões necessárias para os recursos escolhidos. A permissão do Data Manager é obrigatória para concluir esta conexão do servidor.

Os nomes das telas do Google podem mudar. Use a identidade do seu próprio aplicativo e declare apenas domínios sob seu controle. Se o Google exigir verificação de domínio ou aplicativo, siga os requisitos da sua configuração real; conectar o ArtisanClo não substitui esse processo.

5. Conecte a fonte

1. Abra Fontes e crie ou edite sua fonte do Google. Dê a ela um nome que identifique a empresa ou conta.
2. Expanda o bloco de conversões e gastos da conta de anúncios, selecione Google e ative o envio de leads e vendas pelo servidor.
3. Informe Client ID e Client Secret. Ative «Lista de contas, criação de conversões e gastos (Google Ads API)» se seu projeto do Cloud estiver preparado para esses recursos.
4. Clique em «Salvar e conectar meu Google». A fonte é salva antes de abrir o Google. Selecione o usuário adequado e autorize seu próprio aplicativo.
5. Ao retornar, confira o e-mail conectado e configure a conta de anúncios e as ações de conversão. «Conectado» confirma a autorização salva, não o envio de uma conversão específica.

Entrar no painel do ArtisanClo com o Google e autorizar uma fonte de anúncios são operações separadas. A conexão do Ads usa o Client ID salvo nessa fonte.

Conclua a autorização na mesma sessão do navegador em até dez minutos. Iniciar outra conexão substitui a pendente. Se voltar a uma aba antiga ou a solicitação expirar, recomece pela fonte.

Se o login falhar, o painel mostra o motivo:

6. Selecione uma conta e configure as ações automaticamente

1. Após autorizar a Google Ads API, clique em «Mostrar minhas contas». A lista inclui as contas de anúncios acessíveis, inclusive clientes de MCC. Se estiver vazia, confira o usuário do Google, as permissões do Ads e o acesso do projeto do Cloud.
2. Confira o ID de dez dígitos e clique em «Selecionar e configurar». Esse botão pode criar ações de conversão reais na conta.
3. Revise o ID da conta preenchido, o ID do administrador quando aplicável e os IDs das ações de lead e venda.

Ações ativadas e compatíveis com esses nomes exatos são reutilizadas. Um tipo ou status incompatível interrompe a configuração com erro; ações existentes não são alteradas silenciosamente. As duas criações são operações separadas: se a segunda falhar, a primeira pode já existir e será reutilizada quando você corrigir o erro e tentar novamente.

Se o acompanhamento de conversões pertencer a outra conta em uma configuração MCC, a configuração automática retorna google_shared_conversion_account. Primeiro confira a propriedade das conversões no Google Ads; mudar o ID do administrador não transfere ações.

A configuração automática preenche os IDs de ações do servidor. Ela não cria nem busca Conversion IDs/labels do navegador. Configure os eventos do navegador separadamente e revise as metas de conversão e os lances das campanhas no Google Ads.

7. Use IDs manuais sem Google Ads API

A Data Manager API com sua autorização OAuth pode enviar postbacks mesmo com a lista de contas e a criação de ações desativadas.

1. Prepare ações de conversão de importação por cliques no Google Ads. Use ações separadas para lead e venda se quiser os dois status.
2. Informe o número da conta de anúncios em Google Ads Account ID, por exemplo 123-456-7890. Os hífens são removidos nas solicitações de API.
3. Informe o ID do MCC se o acesso for por ele. Deixe vazio para acesso direto.
4. Abra cada ação de conversão no Google Ads e copie seu ID numérico, o parâmetro ctId na URL da página, para o campo correspondente de lead ou venda.
5. Salve a fonte e execute a validação de cada status ativado.

Um campo de ação vazio desativa o status. Para enviar somente vendas, preencha venda e deixe lead vazio. Não coloque AW-… ou uma Conversion label no campo de ID de ação do servidor.

8. Diferencie IDs de conta, IDs de ação e rótulos de tags

Estes valores são exemplos, não credenciais utilizáveis.

9. Selecione uma fonte no fluxo

Todos os ajustes Google ficam em Fontes → Conta de anúncios → Google: seu aplicativo OAuth, conta, ações, tags, gasto e histórico. No fluxo, apenas selecione essa fonte. O fluxo não tem conexão Google nem IDs de ações separados.

Para outra conta Google ou ações diferentes, crie outra fonte e selecione-a no fluxo. Alterações na fonte afetam todos os fluxos que a selecionam. A tag do navegador e os postbacks usam essa fonte. Se ela mudar antes do envio de uma conversão na fila, o envio anterior para com google_connection_changed.

10. Acompanhe uma conversão do servidor

1. A visita de anúncio é armazenada com o identificador real de clique do Google e o ID interno de clique do ArtisanClo.
2. Seu site ou rede informa um lead/venda pelo receptor de conversões configurado, devolvendo o ID de clique do ArtisanClo.
3. Todos os ajustes Google ficam em Fontes → Conta de anúncios → Google: seu aplicativo OAuth, conta, ações, tags, gasto e histórico. No fluxo, apenas selecione essa fonte. O fluxo não tem conexão Google nem IDs de ações separados.
4. O servidor usa um token OAuth válido do seu aplicativo para chamar a Data Manager API com sua conta e ação.
5. O resultado é registrado no histórico de envios. O Google processa e atribui o evento separadamente.

A solicitação contém o identificador de clique do Google, a hora do evento, o valor da conversão em USD e um identificador de evento para evitar duplicatas. O valor vem do pagamento da conversão registrado no ArtisanClo, não do gasto com anúncios. O envio pelo servidor não espera pela importação matinal de gastos.

Cada par conversão/status é enviado uma vez. A mudança de lead para venda pode enviar duas ações separadas. Hold, rejected e trash não são enviados por esse mapeamento. Rejeitar um lead já enviado não retira automaticamente sua conversão do Google. Reenviar um valor alterado no mesmo status não é um ajuste de valor do Google Ads.

11. Eventos do navegador com IDs e rótulos do Google

Com Google Ads API ativada e a conta selecionada, clique em «Configurar tags pelo Google» na seção do navegador da fonte. Cria ou reutiliza AC — Offer visit e AC — Form lead e obtém seus IDs/rótulos. As ações novas são metas secundárias. Instale a tag JavaScript do ArtisanClo na página; o botão não a instala. Sem API, use os campos manuais abaixo.

O envio pelo navegador independe do OAuth. Ele observa visitas à oferta e envios de formulário enquanto o visitante está na página; não pode enviar um postback tardio depois que ele sair.

1. Instale a tag JavaScript do ArtisanClo na página e ative o rastreamento do fluxo.
2. Abra a conversão de site correspondente no Google Ads → configuração da tag → «Use Google Tag Manager». Copie Conversion ID e Conversion label. Essa aba mostra os valores; usar o ArtisanClo não exige, por si só, instalar o GTM.
3. Ative as conversões do navegador na fonte. Preencha GTAG ID e GTAG Click Label para a visita à oferta, e GTAG Conversion ID e GTAG Conversion Label (Lead) para o formulário.
4. Você também pode expandir «Colar um snippet de evento» e colar o snippet de um único destino. O ArtisanClo extrai o ID/rótulo; o JavaScript colado não é executado.
5. Confira o AW-ID/label exibido e salve. Enquanto o recurso estiver ativado, pelo menos um evento deve estar completo. Para desativar todos os eventos, desligue a opção do navegador.

Por exemplo, gtag('event', 'conversion', {'send_to': 'AW-12345678901/ExampleLeadLabel'}); se torna o destino salvo AW-12345678901/ExampleLeadLabel. Não misture dois destinos diferentes no mesmo campo. Um ID sem rótulo está incompleto.

O código carrega a tag do Google automaticamente e reutiliza uma função gtag existente. Em uma pré-landing, o evento da oferta ocorre ao seguir o link da oferta, não ao abrir a pré-landing. Antes de navegar, aguarda o retorno do evento por no máximo 800 ms e continua mesmo que o Google esteja bloqueado.

O evento de um formulário comum ocorre após a validação nativa dos campos pelo navegador, se submit não tiver sido cancelado. Isso não comprova que o servidor aceitou o formulário. Para formulários AJAX, dispare o seguinte após uma resposta de sucesso do processador do formulário:

document.dispatchEvent(new Event('artisanclo:lead'));

Não dispare apenas no clique de um botão, em uma falha de validação ou antes da resposta do servidor. O evento notifica a tag do Google e não cria, por si só, uma conversão no ArtisanClo. Configure as conversões recebidas separadamente.

A tag da página principal não pode observar formulários em iframes de terceiros ou ações posteriores em um site externo sem sua tag. Bloqueadores, CSP e configurações de consentimento podem afetar o envio. A integração não substitui a configuração de consentimento do seu site.

12. Evite duplicatas e escolha as metas de conversão

Evite enviar a mesma ação do navegador pelo GTM e pelo ArtisanClo com o mesmo ID/rótulo. O ArtisanClo limita eventos repetidos do mesmo tipo para um clique e fornece ao Google um identificador de transação.

Eventos do servidor e do navegador usam mecanismos separados, sem garantia de deduplicação automática conjunta. Um envio de formulário e um postback confirmado podem representar metas diferentes. Confira quais ações são principais e usadas na otimização de campanhas no Google Ads. Rejeitar um postback não cancela um evento do navegador já enviado.

13. Importe gastos

1. Autorize seu aplicativo OAuth para a Google Ads API e confira o acesso do projeto do Cloud às contas de produção.
2. Escolha Google no bloco de gastos da conta de anúncios da fonte.
3. Defina a conta de anúncios que fornecerá os gastos. Confira o número sugerido após a configuração automática; uma conta de gastos já preenchida não é sobrescrita automaticamente.
4. Salve a fonte. Os gastos são importados conforme o agendamento quando seu plano inclui esse recurso.

Toda manhã, a importação relê os três dias completos anteriores para incorporar correções. Não é um contador em tempo real do gasto de hoje. Os valores são lidos na moeda da conta de anúncios e convertidos em USD com uma taxa de câmbio disponível.

Quando vários fluxos compartilham uma fonte, preserve os IDs de campanha nos cliques, normalmente com utm_campaign={campaignid} no modelo do Google Ads. Uma campanha compartilhada é distribuída pela proporção de cliques relacionados de cada fluxo que chegaram às ofertas; se nenhum chegou, todos os cliques relacionados são usados. Campanhas sem cliques correspondentes não são distribuídas arbitrariamente: seus IDs aparecem em um erro de importação.

Se a fonte tiver apenas um fluxo com rastreamento, ele recebe todo o gasto importado da conta. Não trate essa configuração como um filtro de uma campanha em uma conta maior. Os valores importados não sobrescrevem gastos inseridos manualmente. Confira o horário da última sincronização e o erro nas configurações de gastos.

14. Verifique configuração, envio e atribuição separadamente

Todos os ajustes Google ficam em Fontes → Conta de anúncios → Google: seu aplicativo OAuth, conta, ações, tags, gasto e histórico. No fluxo, apenas selecione essa fonte. O fluxo não tem conexão Google nem IDs de ações separados.

Validação sem registro. Clique em «Salvar e enviar validação» ao lado de um status do servidor preenchido. A ação salva o formulário e chama o Google com validateOnly = true, validando sem executar a conversão. Nenhuma conversão real é criada no ArtisanClo; o histórico identifica a tentativa de validação. Referência de validateOnly do Google.

Todos os ajustes Google ficam em Fontes → Conta de anúncios → Google: seu aplicativo OAuth, conta, ações, tags, gasto e histórico. No fluxo, apenas selecione essa fonte. O fluxo não tem conexão Google nem IDs de ações separados.

Verificação da cadeia completa. Em um cenário de teste autorizado, registre um clique de anúncio, confira seu ID do Google, use o ID interno de clique em uma nova conversão, encontre-a no ArtisanClo e confira o envio normal ao Google. Confirme o destino e o resultado e, depois, confira o Google Ads. É um envio real que pode afetar os relatórios.

Verificação do navegador. Use o Google Tag Assistant, realize a ação e inspecione o evento conversion e o destino send_to. Formulários com falha não devem disparar seu evento de sucesso. Eventos do navegador não têm log de respostas do Google no servidor nem botão validateOnly.

15. Consulte o histórico de envios

A fonte mostra os últimos dez envios, não uma exportação completa do histórico. A associação de um envio normal à conversão também está disponível no histórico de conversões/cliques. Para o suporte, informe fonte, fluxo, horário, status, código HTTP, texto do erro e requestId, se houver. Não envie Client Secret nem tokens de acesso ou atualização.

16. Solução de problemas

17. Reconecte, desconecte e migre do JSON

Adicionar Google Ads API. Ative-a no projeto e na fonte e reconecte. Salvar a opção não amplia uma autorização existente.

Alterar Client ID ou Secret. Salvar credenciais alteradas do aplicativo limpa a autorização OAuth existente. Conecte novamente e considere todos os fluxos que compartilham a fonte antes de alterá-la.

Parar apenas o envio de postbacks. Desative o envio pelo servidor e salve. Eventos do navegador, arquivos agendados e gastos têm configurações separadas. Desative cada recurso utilizado para interromper toda a atividade da fonte com o Google.

Desconectar o acesso. Remove a autorização OAuth armazenada desta fonte. Não exclui o aplicativo nem as ações no Google Ads. Não executa uma revogação global no Google, que poderia afetar outras fontes com o mesmo aplicativo do cliente. Se você revogar a permissão diretamente no Google, revise todas essas fontes.

Chave JSON existente de uma conta de serviço do cliente. Fontes conectadas anteriormente continuam sendo compatíveis. Para migrar, configure e autorize seu aplicativo OAuth na fonte. Informar um OAuth Client ID seleciona o caminho OAuth; não espere uma volta automática à chave JSON antiga enquanto o login estiver incompleto. A autorização bem-sucedida limpa a chave anterior de conversões do servidor. Confira também os gastos, a permissão da Ads API e cada ação.

Arquivo agendado do Google Ads. Essa opção independente inclui até 90 dias de eventos elegíveis com gclid e usa os nomes de conversão das configurações do feed. Esses nomes não são ctId nem rótulos do navegador. Escolha uma via principal de envio para os mesmos eventos para evitar importações duplicadas involuntárias.

18. Perguntas frequentes

Posso dispensar o Google Cloud?

Sim, para envio pelo navegador com ID/rótulo ou arquivo agendado. O envio automático pelo servidor via OAuth exige seu próprio projeto do Cloud.

Posso dispensar o JSON?

Sim. A nova conexão usa Client ID, Client Secret e autorização do Google, não uma chave baixada de conta de serviço.

Tudo é automático?

Com Google Ads API ativada e a conta selecionada, clique em «Configurar tags pelo Google» na seção do navegador da fonte. Cria ou reutiliza AC — Offer visit e AC — Form lead e obtém seus IDs/rótulos. As ações novas são metas secundárias. Instale a tag JavaScript do ArtisanClo na página; o botão não a instala. Sem API, use os campos manuais abaixo.

Preciso do MCC do ArtisanClo?

Não. Com acesso direto, nem um MCC próprio é necessário. Use um ID de administrador apenas quando sua forma de acesso exigir.

Um fluxo pode usar outra conta?

Para outra conta Google ou ações diferentes, crie outra fonte e selecione-a no fluxo. Alterações na fonte afetam todos os fluxos que a selecionam. A tag do navegador e os postbacks usam essa fonte. Se ela mudar antes do envio de uma conversão na fila, o envio anterior para com google_connection_changed.

O lead será enviado depois que o visitante sair?

Sim, se chegar um postback vinculado e as condições de envio pelo servidor forem atendidas. Uma configuração apenas de navegador não faz isso.

Por que um evento do navegador não aparece nas conversões do ArtisanClo?

A tag do Google não substitui o receptor de conversões. Configure o postback ou processador do site e o ID interno de clique.

Uma validação bem-sucedida comprova a atribuição?

Não. Confirme toda a cadeia com um clique real de anúncio autorizado e confira o resultado final no Google Ads.

Relacionado: fontes, rastreamento do fluxo, conversões recebidas, histórico de conversões, relatórios e gastos. Os requisitos das APIs externas foram conferidos na documentação do Google em 19 de outubro de 2026; consulte a interface atual do Google para as configurações do projeto e os nomes das telas.