O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Configurar o caminho de veiculação próprio

O recurso de caminho de veiculação próprio permite recuperar o endereço IP não mascarado do usuário encaminhando uma solicitação pela sua rede de fornecimento de conteúdo (CDN) ou infraestrutura da Web para os servidores de anúncios do Google.

Em solicitações de terceiros, os recursos do navegador e do SO e as configurações de rede podem mascarar endereços IP. Esse mascaramento pode afetar sua receita de publicidade, segmentação geográfica e detecção de tráfego inválido (IVT, na sigla em inglês).

Sua CDN recebe um IP de cliente não mascarado de um usuário em todas as solicitações recebidas para seu domínio. Esse recurso oferece os seguintes benefícios:

Sem mudanças no código do lado do cliente: você não edita o JavaScript nem transmite parâmetros manualmente. A Tag de Publisher do Google (GPT) lê o caminho configurado nas suas configurações do Google Ad Manager e executa a solicitação de recuperação de forma assíncrona.
Menos sobrecarga: a solicitação é leve, armazenada em cache localmente por sessão de visualização de página e executada de forma assíncrona com as definições de espaço do anúncio.
Payload criptografado: por padrão, esse recurso retorna o endereço IP do usuário como um payload criptografado.

Nesta página, explicamos como configurar o caminho de veiculação próprio para sua CDN preferida.

Pré-requisitos

Antes de configurar a CDN, faça o seguinte:

Especifique um caminho de veiculação na sua conta do Ad Manager, por exemplo, /adserver/. Para especificar o caminho, siga as etapas em Método 1: caminho de veiculação próprio.
- Verifique se o caminho de exibição é exclusivo e se nenhum tráfego enviado usa esse caminho.
Tenha ou defina os seguintes itens:
- Host ou origem de destino: securepubads.g.doubleclick.net
- Caminho de destino: /pagead/fpm
- Protocolo: HTTPS com a porta padrão 443.
- Cabeçalhos: defina o cabeçalho como Host: securepubads.g.doubleclick.net.
- Armazenamento em cache: configure a CDN para ignorar o armazenamento em cache de uma rota. Por exemplo, defina as políticas de cache para ignorar o cache ou o cabeçalho Cache-Control: no-store.
Se a CDN for o Cloudflare, você precisará ter um nível Enterprise do Cloudflare para criar uma regra de origem.

Configurar a CDN

Configure sua CDN ou proxy reverso para encaminhar solicitações que correspondam ao caminho configurado para os servidores de anúncios do Google. Selecione a CDN que preferir:

Cloudflare

Crie uma regra no painel com os seguintes valores:
- Expressão de filtro personalizada: adicione o seguinte:
  - Campo: URI Path
  - Operador: starts with
  - Valor: seu caminho, por exemplo, /adserver/.
- Substituição do cabeçalho do host: selecione Reescrever como e adicione o host de destino securepubads.g.doubleclick.net.
- Substituição de DNS: selecione Substituir para e adicione o host de destino securepubads.g.doubleclick.net.
Crie uma reescrita de regra de URL no painel com os seguintes valores:
- Expressão de filtro personalizada: adicione o seguinte:
  - Campo: URI Path
  - Operador: starts with
  - Valor: seu caminho, por exemplo, /adserver/.
- Caminho: selecione Reescrever para > Estático > e adicione o caminho de destino /pagead/fpm.
- Consulta: selecione Preservar.

Amazon CloudFront

Siga as etapas em Configurações de origem com os seguintes valores:
- Domínio de origem: securepubads.g.doubleclick.net
- Protocolo: HTTPS
Siga as instruções em Criar funções e adicione o seguinte exemplo:
```
function handler(event) {
    var request = event.request;
    request.uri = '/pagead/fpm';
    return request;
}
```
Este exemplo usa o evento de solicitação recebido, atribui o URI ao caminho de destino e retorna a solicitação.

Clique em Salvar alterações, navegue até a guia Publicar e clique em Publicar função.
Siga as instruções em Atualizar uma distribuição no console com os seguintes valores:
- Padrão de caminho: seu caminho, por exemplo, /adserver/*.
- Origem e grupos de origem: o host de destino, securepubads.g.doubleclick.net.
- Política de cache: selecione CachingDisabled.
- Política de solicitações de origem: selecione AllViewerExceptHostHeader.
- Associações de função:
  - Solicitação do visualizador: selecione Função do CloudFront e adicione o nome da sua função.

Fastly

Siga as instruções em Como adicionar um host com os seguintes valores:
- Endereço: o host de destino, securepubads.g.doubleclick.net
- Porta: a porta padrão, 443.
- Ativar TLS?: Sim
  - Nome do host do certificado: securepubads.g.doubleclick.net
    - Selecione Match the SNI hostname to the Certificate Name.
  - Nome do host SNI: securepubads.g.doubleclick.net
  - Substituir host: securepubads.g.doubleclick.net

Siga as instruções em Como criar snippets de VCL com o seguinte exemplo:

if (req.url ~ "^PATH") {
    set req.backend = F_NAME;
    set req.http.Host = "securepubads.g.doubleclick.net";
    set req.url = regsub(req.url, "^PATH", "/pagead/fpm");
    return(pass);
}

Substitua:

NAME: o nome do host, por exemplo, Google_GAM_FPM_Backend.
PATH: seu caminho, por exemplo, /adserver/.

Google Cloud

Siga as instruções em Criar o NEG e o endpoint de Internet com os seguintes valores:
- Tipo de grupo de endpoints de rede: selecione NEG de Internet (global).
- Porta padrão: 443
- Novo endpoint de rede: selecione Nome de domínio totalmente qualificado (FQDN) e porta.
- FQDN: adicione o host de destino, securepubads.g.doubleclick.net.
Crie o serviço de back-end global e configure cabeçalhos da solicitação personalizados com os seguintes valores:
- Tipo de back-end: selecione Grupo de endpoints de rede na Internet.
- Protocolo: selecione HTTPS.
  - Nome do cabeçalho: Host
  - Valor do cabeçalho: adicione o host de destino, securepubads.g.doubleclick.net.
Siga as etapas em Configurar mapas de URL.
Em Regras de roteamento, localize a regra de host de produção que corresponde ao seu subdomínio.

Atualize as correspondências de caminho com a configuração routeRules:
```
name: NAME
defaultService: projects/PROJECT_ID/global/backendServices/DEFAULT_BACKEND
routeRules:
  - priority: 1
    matchRules:
      - prefixMatch: PATH
    service: projects/PROJECT_ID/global/backendServices/BACKEND_NAME
    routeAction:
      urlRewrite:
        pathPrefixRewrite: /pagead/fpm
```
Substitua:
- BACKEND_NAME: o nome do serviço de back-end criado na etapa 2, por exemplo, gam-fpm-backend-service.
- DEFAULT_BACKEND: o serviço de back-end padrão que hospeda seu site.
  - Se você hospedar seu site no Cloud Storage, substitua backendServices pelo parâmetro backendBuckets no caminho do recurso do campo defaultService.
- NAME: o nome da correspondência de caminho, por exemplo, gam-fpm-matcher.
- PATH: seu caminho, por exemplo, /adserver/.
- PROJECT_ID: o ID do projeto.

Como testar a implementação

Para verificar se a CDN faz o proxy da solicitação e transmite o endereço IP, execute um teste usando o comando curl:

curl -i https://example.comPATH

Substitua PATH pelo caminho, por exemplo, /adserver/.

Se ela for bem-sucedida, você vai receber a seguinte saída:

Status HTTP: 200 OK
Conteúdo da resposta: um payload dos servidores de back-end do Google que contém um token de IP criptografado por padrão.

Resolver problemas de implementação

Nesta seção, abordamos os fluxos de trabalho para resolver problemas na implementação do caminho de veiculação próprio na sua CDN.

A tabela a seguir detalha problemas, causas e soluções para solução de problemas:

Problema	Causa	Solução
Você recebe o status HTTP 404 ou 502 da sua CDN	A reescrita de caminho não está ativa ou o cabeçalho `Host` está ausente.	Verifique se as reescritas são mapeadas para o caminho de destino `/pagead/fpm` e se o cabeçalho `Host` é substituído pelo host de destino, `securepubads.g.doubleclick.net`.
O endereço IP não é atualizado nas solicitações de anúncio.	Armazenamento em cache ativado no proxy da CDN	Defina a política de cache na rota como a política `CachingDisabled` ou o cabeçalho `Cache-Control: no-store`. Cada cliente precisa acessar o serviço de back-end para avaliar o endereço IP específico.
Falha no handshake de SSL ou TLS	Incompatibilidade de SNI na conexão de origem do back-end	Verifique se você configurou a CDN para enviar o host de destino `securepubads.g.doubleclick.net` na extensão SNI do TLS.
O parâmetro `ips` está ausente na solicitação de anúncio.	O caminho do Ad Manager não corresponde ao caminho da CDN	Verifique se o caminho inserido na página Configurações globais da interface do Ad Manager corresponde ao caminho configurado na CDN. Para mais detalhes, consulte Transmitir IP sem máscara fornecido pelo publisher (Beta).