Enviar indicadores do Google Ad Manager usando servidores de anúncios de terceiros

Se você usa um servidor de anúncios de terceiros com a inserção de anúncios pelo servidor (SSAI, na sigla em inglês) do Google Ad Manager, o IMA oferece suporte à monetização de inventários adicionais pelo Google Ad Manager enviando um valor de uso único criptografado pelo servidor de anúncios de terceiros para o Ad Manager. Este guia mostra como enviar esses indicadores usando o SDK do IMA.

Termo-chave :neste guia, um "servidor de anúncios de terceiros" é qualquer servidor de anúncios que não seja do Google Ad Manager.

Neste guia, usamos um exemplo de tag de anúncio: https://youradserver.com. Atualize a tag do anúncio para que ela funcione com seus servidores de anúncios.

Pré-requisitos

• SDK HTML5 do IMA v3.523.0 ou mais recente.

• Leia o Guia explicativo.

1. Configurar o app para enviar um valor de uso único aos servidores do DAI do Google

Defina enableNonce como true para que o SDK de DAI do IMA envie um valor de uso único criptografado aos servidores da DAI.

const streamRequest = new LiveStreamRequest();
streamRequest.enableNonce = true;

2. Atualizar a tag de anúncio com uma macro para preencher o valor de uso único

Adicione a macro [GOOGLE_INSTREAM_VIDEO_NONCE] à tag do servidor de anúncios na interface do Ad Manager. Quando o servidor da DAI preenche os intervalos de anúncio com os URLs do servidor de anúncios de terceiros, o Ad Manager preenche dinamicamente a macro com o valor de uso único criptografado. O resultado será semelhante à seguinte tag de anúncio de exemplo, que usa uma chave que precisa ser configurada no servidor de terceiros:

https://youradserver.com?ad_manager_nonce=[GOOGLE_INSTREAM_VIDEO_NONCE]

Essa tag de anúncio usa ad_manager_nonce como chave de exemplo, mas você precisa confirmar com seu servidor de anúncios de terceiros como ele aceita o valor de uso único.

Para atualizar a tag do servidor de anúncios no Ad Manager, acesse Vídeo > Transmissões ao vivo e selecione uma transmissão ao vivo ativa ou crie uma nova.

Agora, adicione a macro à tag de anúncio configurada no fluxo selecionado. Defina a tag em Configurações do intervalo comercial > Tag de anúncio principal.

3. Configurar a solicitação do servidor de anúncios de terceiros para o Ad Manager

Configure o servidor de anúncios de terceiros para incluir esse valor na solicitação do servidor ao Ad Manager. Confira um exemplo de tag de anúncio configurada no servidor de anúncios de terceiros:

https://pubads.g.doubleclick.net/gampad/ads?givn=%%custom_key_for_google_nonce%%&iu=/21775744923/external/single_ad_samples&sz=640x480

O Ad Manager procura givn= para identificar o valor de uso único. O servidor de anúncios de terceiros precisa oferecer suporte a uma macro própria, como %%custom_key_for_google_nonce%%, e substituí-la pelo parâmetro de consulta de valor único fornecido na etapa anterior. Mais informações sobre como fazer isso estão disponíveis na documentação do servidor de anúncios de terceiros.

Observação:este guia usa duas macros.

1. As solicitações de anúncios para seus servidores de anúncios de terceiros precisam conter a macro [GOOGLE_INSTREAM_VIDEO_NONCE]. Essa tag de anúncio é armazenada na interface do Ad Manager. O SDK do IMA pesquisa (com correspondência exata e diferencia maiúsculas de minúsculas) e substitui essa macro pelo valor de uso único criptografado.
2. A segunda macro, %%custom_key_for_google_nonce%%, é usada pelo servidor de anúncios de terceiros para preencher o valor de uso único criptografado da solicitação ao Google Ad Manager. Essa macro é um exemplo e pode ser configurada para qualquer string aceita pelo servidor de anúncios de terceiros.

Pronto! Agora, o parâmetro de valor de uso único será propagado do SDK de DAI do IMA pelo servidor de DAI para o servidor de anúncios de terceiros e de volta para o Ad Manager. Isso melhora a monetização com o Google Ad Manager.