Guia de implementação do servidor

Este recurso está disponível somente para redes com um gerente da Conta do Google dedicado e pode não estar ativado para sua rede. Entre em contato com seu gerente de contas para mais informações. Se você não tiver gerente da conta, sua rede não estará qualificada para esse recurso.

Talvez seja necessário que você possa enviar solicitações de anúncio ao Google Ad Manager de servidores de terceiros ou reservados, provedores de inserção do lado do servidor ou integradores de anúncios dinâmicos. Conclua as seguintes etapas para enviar solicitações de anúncio do lado do servidor ao Google Ad Manager e gerar relatórios precisos sobre impressões, cliques e conversões atribuídas.

1. Compartilhar as instruções de integração com o parceiro em tecnologia do lado do servidor

Para que o Google Ad Manager autentique as chamadas do lado de servidores terceirizados (por exemplo, provedores de Inserção de anúncios dinâmicos ou integradores do lado do servidor), elas precisam ser conectadas aos servidores do Google Ad Manager usando um certificado SSL emitido por ele.

Instrua o parceiro em tecnologia do lado do servidor a concluir as etapas detalhadas nesta página.

O Campaign Manager 360 também exige a instalação de um certificado SSL com as solicitações de anúncio do lado do servidor. O parceiro em tecnologia do servidor precisa seguir as instruções de integração do Campaign Manager 360 se os criativos de vídeo forem solicitados por chamadas do lado do servidor.

2. Gerar uma tag de anúncio do lado do servidor

Os publishers que usam servidores de terceiros para enviar solicitações de anúncio ao Google Ad Manager são responsáveis por gerar uma tag de vídeo de uma das seguintes formas:

Na interface do Google Ad Manager

Saiba como gerar uma tag de vídeo no Ad Manager

Construir o URL da tag de anúncio em vídeo manualmente

Consulte os parâmetros de URL compatíveis com as tags de anúncios em vídeo VAST necessários e opcionais, além dos requisitos adicionais para registrar visualizações, conversões e cliques.

Os URLs das tags de anúncios do lado do servidor que fazem referência a /gampad/ads ou /gampad/live/ads precisam usar serverside.doubleclick.net (em vez de pubads.g.doubleclick.net). Talvez seja necessário modificar manualmente os URLs das tags de anúncios para atender a esse requisito.

3. Gerar uma solicitação de anúncio do lado do servidor

Depois que a tag de anúncio for gerada, o parceiro em tecnologia responsável pelo envio da solicitação de anúncio do lado do servidor ao Google Ad Manager terá que fazer o seguinte:

• Transmitir a origem de integração do lado do servidor como um valor do parâmetro ssss na solicitação do Google Ad Manager.

  O valor do parâmetro ssss diferencia maiúsculas de minúsculas. Se o editor receber o valor de examplesource, a transmissão de ssss=examplesource vai estar correta, e ssss=ExampleSource não vai estar correto.
  Os fornecedores que usam integrações de servidor para servidor com o Google recebem esse valor do Google e podem fornecê-lo a você. Entre em contato com seu gerente de contas do Google em caso de dúvidas sobre o valor a ser definido para esse parâmetro.

• Informar dinamicamente o endereço IP do dispositivo cliente usando o cabeçalho X-Forwarded-For ou o valor do parâmetro ip na solicitação do Ad Manager. Faça isso usando apenas um desses métodos, e não ambos.

  Não transmitir corretamente o endereço IP completo do dispositivo cliente em um desses dois métodos poderá causar problemas na veiculação e na exibição de anúncios.

• Transmitir os cabeçalhos HTTP completos do ambiente/dispositivo cliente, inclusive estes:

  • User-Agent: é a string completa e não modificada informada pelo navegador do usuário.  No caso de anúncios para dispositivos móveis renderizados em WebViews ou navegadores nativos para dispositivos móveis, é necessário transmitir o user agent utilizado pela plataforma para dispositivos móveis em WebViews ou no navegador (por exemplo, o user agent do Mobile Safari no iOS). Se os anúncios forem renderizados no app nativo para dispositivos móveis, o user agent precisará seguir as diretrizes para apps móveis.

    As strings do user agent geradas pelas classes de conexão do URL da plataforma para dispositivos móveis (por exemplo, "Dalvik" no Android ou "CFNetwork" no iOS) não são válidas.

  • Accept-Encoding: deve ser definido como gzip,deflate para que o Ad Manager compacte as respostas. Isso é um requisito porque as respostas não compactadas são 20 vezes maiores.

O único cabeçalho que não pode ser encaminhado na solicitação de anúncio do lado do servidor é o cabeçalho cookie.

Requisitos adicionais para registrar visualizações, conversões e cliques

É altamente recomendável que todas as visualizações e conversões sejam enviadas do cliente, e não do servidor. Os editores precisam enviar impressões e pings de conversão do cliente. Em alguns casos, os editores podem receber permissão para registrar visualizações, conversões e cliques do servidor.

Se a configuração técnica exige que você envie visualizações, conversões e cliques do servidor, é preciso incluir ipe=ssb nas solicitações de anúncios iniciais enviadas do ambiente do lado do servidor.

Outras práticas recomendadas para garantir que o Ad Manager consiga processar as solicitações de anúncio e conversões de implementações medidas do servidor:

• Envie todos os eventos de visualização, conversão e clique na ordem em que ocorreram. Por exemplo, não envie o evento de clique antes do evento de impressão, já que um usuário não consegue clicar em um evento antes que a impressão seja acionada e o anúncio renderizado.
• Não envie eventos em lote. Em vez disso, envie os eventos no momento em que são registrados.

Esse tráfego só é válido para a demanda de reserva e não será certificado pelo MRC, a menos que seja especificado o contrário nas condições de um contrato de versão Beta.