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 você precise ser capaz de enviar solicitações de anúncio ao Ad Manager de servidores de terceiros ou reservados, provedores de inserção do lado do servidor ou ajustes de anúncios dinâmicos. Conclua as seguintes etapas para enviar solicitações de anúncio do servidor ao 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 servidor

Para que o 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 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 editores que usam servidores de terceiros para enviar solicitações de anúncio ao Ad Manager são responsáveis por gerar uma tag de anúncio de uma das seguintes formas:

Na interface do 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 Ad Manager vai 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 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, o user agent usado pela plataforma móvel para WebViews ou para o navegador (por exemplo, o user agent do Safari para dispositivos móveis para iOS) precisa ser transmitido. Se os anúncios forem renderizados no app nativo para dispositivos móveis, o user agent vai precisar seguir as diretrizes de apps para dispositivos 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.