# Google Ads

Descubra de qual campanha do Google Ads vem cada instalação e assinatura, e envie essas conversões ao Google para ele otimizar seus anúncios.

## Como funciona

Você cria campanhas de Pesquisa, Display ou YouTube com a página do app na loja como URL final. O link do Paywallo vai no **Modelo de acompanhamento** da campanha: ele registra o clique e leva a pessoa para a loja.

## Como o clique funciona

O Google manda a pessoa direto para a **URL final** e chama o link do Paywallo em segundo plano (rastreamento paralelo, obrigatório no Google). Por isso a URL final deve ser a página da loja ou a sua landing, e o link do Paywallo vai só no **Modelo de acompanhamento**.

Não funciona com campanha de app (App Campaign, antiga UAC). Use Pesquisa, Display ou YouTube.

## Antes de começar

-   Você tem acesso de administrador na conta do Google Ads.
-   O app já usa o SDK do Paywallo e envia eventos.

## Passo 1: Criar as 3 conversões no Google Ads

1. No Google Ads, abra Metas, depois Conversões e Resumo. Clique em + Criar ação de conversão.

2. Escolha Importar, depois Outras fontes de dados ou CRMs e Acompanhar conversões de cliques.

3. Crie uma ação para cada evento. Nomes sugeridos: Paywallo - Instalação, Paywallo - Início de trial e Paywallo - Assinatura.

4. Em Contagem, escolha Todas. É obrigatório: com Uma as conversões de cliques do iPhone (gbraid) não funcionam.

5. Deixe a janela de clique em 90 dias. Em Instalação e Início de trial, não use valor. Em Assinatura, use valores diferentes para cada conversão, na moeda USD.

6. Anote o ID de cada ação. Abra a ação e olhe a URL do navegador: o ID é o número depois de ctId=.

## Passo 2: Conectar no Paywallo

1. No Paywallo, abra Configurações, aba Integrações, card Google Ads. Clique em Conectar Google Ads e autorize, deixando todos os acessos marcados.

2. Em Conta de anúncios, escolha a conta. Se ela fica dentro de uma conta gerenciadora (MCC) e não aparece na lista, escolha Outra conta (digitar ID), digite o ID de 10 dígitos e selecione a Conta gerenciadora (MCC).

3. Cole os 3 IDs de conversão nos campos ID da conversão: Instalação, Início de trial e Assinatura.

4. Clique em Salvar e depois em Testar envio. Aparece Envio de teste validado.

## Passo 3: Criar o link

1. No Paywallo, abra o Growth Hub, aba Google Ads, seção Link de Rastreamento, clique em Novo link.

2. Copie o Tracking template que o Paywallo mostra e cole no campo Modelo de acompanhamento do Google Ads.

## Passo 4: Configurar a campanha

1. Crie uma campanha de Pesquisa, Display ou YouTube. Faça uma campanha para iOS e outra para Android.

2. Como URL final, use a página do app na App Store (campanha de iOS) ou no Google Play (campanha de Android), ou a sua landing (veja a seção abaixo). A URL da App Store tem que ser a atual, sem redirecionamento: abra a URL no navegador e copie o endereço final. Se o app mudou de nome, a URL antiga redireciona e o Google acusa Destino não correspondente.

3. Abra Configurações da campanha, depois Opções de URL da campanha, e cole o link em Modelo de acompanhamento. Faça isso no nível da campanha, não do anúncio.

4. Confira se o auto-tagging (marcação automática) está ligado na conta.

## Campanha Android

Para atribuição exata no Android, abra `Configurações da campanha`, `Opções de URL` e cole no **Sufixo do URL final**:

`referrer=gclid%3D{gclid}`

Se a URL final do Google Play já tiver `referrer=`, não use o sufixo: o parâmetro ficaria duplicado.

## Usar landing page ou quiz como URL final

Com a sua landing como URL final, o Google revisa a sua página, não a da loja, e o destino sempre bate com o anúncio.

1. Em Configurações, Integrações, Google Ads, cadastre o domínio exato em Domínios da landing page. Cada subdomínio, inclusive o www, é cadastrado separado.

2. No anúncio, use a sua landing como URL final. O link do Paywallo continua só no Modelo de acompanhamento.

3. Na landing, use o botão <a data-paywallo-download href="LINK">Baixar</a> e cole o script que o painel mostra em Growth Hub, Google Ads.

4. A landing não pode remover os parâmetros da URL (como o gclid) com redirecionamentos próprios. O script é inline: se o site bloqueia script inline (CSP), libere com nonce.

5. Limitações da landing:

-   Usuários de computador não instalam o app: mostre um QR code ou uma instrução para abrir no celular.
-   No iPhone a atribuição segue estimada.
-   Sem o script na landing, a atribuição do Android também fica estimada.

## Privacidade

O `gclid` é um identificador pseudônimo do Google. Cubra-o no aviso de cookies e consentimento do seu site, como você já faz para o Google Ads.

## O que esperar

-   Cliques, instalações e assinaturas aparecem na aba Google Ads do Growth Hub.
-   O gasto das campanhas é sincronizado todo dia.
-   As conversões aparecem no Google Ads em algumas horas.
-   Em Configurações, Integrações, Google Ads, o bloco Entrega ao Google mostra as conversões aceitas e as recusadas nos últimos 7 dias.

## Solução de problemas

| Erro | Como resolver |
| --- | --- |
| Conexão expirada, reconecte | O Google revogou o acesso. Em **Configurações, Integrações, Google Ads**, clique em `Conectar Google Ads` e autorize de novo. |
| O Google negou o acesso | A conta que você usou no login não tem permissão na conta de anúncios, ou você desmarcou algum acesso na tela de autorização. Reconecte com uma conta com acesso de administrador e deixe **todos** os acessos marcados. |
| Recusa: Clique fora da janela de conversão | A janela de clique da ação de conversão é menor que o tempo entre o clique e a conversão. Abra a ação no Google Ads e coloque a janela de clique em **90 dias**. |
| A aba Google Ads do Growth Hub não mostra campanhas | Confira se o modelo de acompanhamento está colado no nível da campanha, e não do anúncio. Se acabou de colar, espere a próxima sincronização, que leva até 24 horas. |
| Anúncio reprovado por URL | A URL final tem que ser a página da loja do mesmo sistema da campanha: App Store numa campanha de iOS e Google Play numa de Android. |
| Destino não correspondente | Três causas comuns: a URL final está desatualizada ou redireciona (abra no navegador e copie o endereço final); o link do Paywallo foi colado como URL final em vez da loja ou da landing; ou o domínio da landing não está cadastrado em **Domínios da landing page**. |
| Termos relacionados a medicamentos restritos | Há nomes de medicamentos em texto, imagem, vídeo, nome da empresa ou na página de destino. Use uma landing própria sem esses termos. |
| Cliques não aparecem no Paywallo | O Modelo de acompanhamento está ausente ou foi colado no nível errado. Cole o link em `Configurações da campanha`, no nível da campanha. |
| Instalações do iOS não batem com o Google Ads | No iOS a atribuição é estimada, porque o sistema não libera o IDFA. No Android ela é exata. |

## Limitações

-   Reembolsos não ajustam conversões que o Paywallo já enviou.
-   Usuários da União Europeia podem ter conversões ignoradas pelo Google, porque o Paywallo não envia o consentimento.
