Guia de implementação do lado do servidor

Esta funcionalidade apenas está disponível para redes com um gestor de conta Google dedicado e pode não estar ativada para a sua rede. Contacte o seu gestor de conta para obter mais informações. Se não tiver um gestor de conta, a sua rede não é elegível para esta funcionalidade.

Pode precisar da capacidade de enviar pedidos de anúncios ao Ad Manager a partir de servidores próprios ou de terceiros, editores de anúncios dinâmicos ou fornecedores de inserção do lado do servidor. Conclua o seguinte para enviar pedidos de anúncios do lado do servidor ao Ad Manager e gerar relatórios precisos acerca das impressões, dos cliques e das conversões atribuídas.

1. Partilhe as instruções de integração com o parceiro tecnológico do lado do servidor

Para que o Ad Manager consiga autenticar as chamadas do lado do servidor de servidores de terceiros (por exemplo, fornecedores de Inserção de anúncios dinâmicos ou junções do lado do servidor), é necessário que estabeleçam ligação aos servidores do Ad Manager através de um certificado SSL (camada de ligação segura) emitido pelo Ad Manager.

Dê instruções ao seu parceiro tecnológico do lado do servidor para concluir os passos detalhados nesta página.

O Campaign Manager 360 com pedidos de anúncios do lado do servidor também requer a instalação de um certificado SSL. O seu parceiro tecnológico do lado do servidor tem de seguir as instruções de integração do Campaign Manager 360 se os criativos de vídeo forem pedidos através de chamadas do lado do servidor.

2. Gere uma etiqueta do anúncio do lado do servidor

Os publicadores que tiram partido de servidores de terceiros para enviar pedidos de anúncios ao Ad Manager são responsáveis por gerar uma etiqueta de vídeo de uma das duas seguintes formas:

Na interface do Ad Manager

Saiba como gerar uma etiqueta de vídeo do Ad Manager 

Crie o URL da etiqueta do anúncio de vídeo manualmente

Veja os parâmetros de URL suportados nas etiquetas de anúncios de vídeo VAST obrigatórios e opcionais e os requisitos adicionais para registar visualizações, conversões e cliques.

Os URLs da etiqueta do anúncio do lado do servidor que fazem referência a /gampad/ads ou /gampad/live/ads têm de utilizar serverside.doubleclick.net (em vez de pubads.g.doubleclick.net). Pode ter de modificar manualmente os URLs da etiqueta do anúncio para cumprir este requisito.

3. Gere um pedido de anúncio do lado do servidor

Após a geração da etiqueta do anúncio, o parceiro tecnológico responsável pelo envio do pedido de anúncio do lado do servidor ao Ad Manager tem de:

• Transmitir a origem da edição do lado do servidor como um valor do parâmetro ssss no pedido do Ad Manager.

  O valor do parâmetro ssss é sensível a maiúsculas e minúsculas. Se o publicador receber o valor de examplesource, a transmissão de ssss=examplesource está correta, enquanto ssss=ExampleSource não está correta.
  Os fornecedores de tecnologia de edição de vídeo que usam integrações servidor a servidor com a Google recebem este valor da Google e podem facultá-lo a si. Pode contactar o seu gestor de contas da Google para esclarecer quaisquer dúvidas sobre o valor a definir para este parâmetro.

• Transmitir dinamicamente o endereço IP do dispositivo cliente ao utilizar o cabeçalho X-Forwarded-For ou como um valor do parâmetro ip no pedido do Ad Manager. O valor deve ser transmitido apenas através de um destes métodos e não de ambos.

  A não transmissão correta do endereço IP completo do dispositivo cliente num destes dois métodos pode causar problemas de publicação e fornecimento de anúncios.

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

  • User-Agent: deve ser a string completa, não modificada e comunicada pelo navegador do utilizador.  Para anúncios para dispositivos móveis renderizados em WebViews ou navegadores para dispositivos móveis nativos, tem de ser transmitido o agente do utilizador usado pela plataforma para dispositivos móveis para WebViews ou o navegador (por exemplo, o agente do utilizador do Mobile Safari para iOS). Se os anúncios forem renderizados na app nativa para dispositivos móveis, o agente do utilizador tem de seguir as Diretrizes de apps para dispositivos móveis.

    As strings de agentes do utilizador geradas pelas classes de ligaçã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 comprima as respostas. Isto é um requisito porque as respostas não comprimidas são 20 vezes maiores.

O único cabeçalho que não deve ser encaminhado no pedido de anúncio do lado do servidor é o cabeçalho "cookie".

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

É altamente recomendado que todas as visualizações e conversões sejam enviadas a partir do cliente e não do servidor. Os publicadores devem enviar pings de impressões e conversão a partir do cliente. Em casos limitados, pode ser concedida aos publicadores a capacidade de registar visualizações, conversões e cliques do servidor.

Se a configuração técnica exigir o envio de visualizações, conversões e cliques do servidor, tem de incluir ipe=ssb nos pedidos de anúncios iniciais enviados a partir do ambiente do lado do servidor.

Outras práticas recomendadas para garantir que o Ad Manager consegue processar pedidos de anúncios e conversões de implementações medidas do lado do servidor:

• Envie todos os eventos de visualização, conversão e clique na ordem pela qual o evento ocorreu. Por exemplo, não envie o evento de clique antes do evento de impressão, uma vez que não é possível que um utilizador clique num evento antes de a impressão ser acionada e o anúncio ser renderizado.
• Não envie eventos em lote. Em alternativa, envie os eventos aquando do registo dos mesmos.

Este tráfego só é válido para a procura de reservas e não será acreditado pelo MRC, a menos que especificado em contrário nas condições do contrato de uma versão beta.