Carregar o código do criativo com uma Solicitação sem tag

É possível usar uma Solicitação sem Tag no lugar de uma tag de anúncio para solicitar o código do criativo bruto processado no Google Ad Manager. Em geral, esse recurso é usado quando há necessidade de análise e exibição personalizadas, como conversores ou outros ambientes que não têm compatibilidade com as tags do Google ou com o SDK.

Ao fazer uma Solicitação sem tag, o Ad Manager retorna somente o código do criativo bruto, exatamente como programado, sem executar nem exibir o anúncio. Se nenhum anúncio for encontrado, o status 200/OK será retornado com uma resposta vazia.

Seu app, player ou site precisa executar o código para exibir o anúncio e ativar o rastreamento de impressões.

Criar uma solicitação sem tag manualmente

Para criar uma Solicitação sem tag, comece com o URL de base, inclua todos os parâmetros obrigatórios e mais os opcionais. Esses parâmetros especificam itens como bloco de anúncios, tamanho do criativo, chaves-valor e outras informações sobre a solicitação.

As Solicitações sem tag precisam ser feitas com segurança usando SSL (https://).

Começar com um URL de base

Use este URL de base:  https://securepubads.g.doubleclick.net/gampad/adx?

Especificar os parâmetros da sua solicitação de anúncio

Para ver detalhes sobre os parâmetros obrigatórios e opcionais, consulte as tabelas a seguir. Se quiser informações sobre os parâmetros do GDPR, acesse Integração do publisher com a TCF do IAB Europa.

Parâmetros obrigatórios

Parâmetro	Descrição
iu	É o código do bloco de anúncios do Google Ad Manager, incluindo seu código de rede na plataforma. Para incluir vários níveis, use o caractere de barra (/) como separador. Exemplo iu=/123/homepage iu=/456/sports/baseball Ao usar o Gerenciamento de múltiplos clientes (GMC) com Solicitações sem tags, aplique a estrutura parent,child para o código de rede. Exemplo (GMC) iu=/123,456/homepage
sz	O tamanho do criativo. Para incluir vários tamanhos, use o caractere de barra vertical (|) como separador. Exemplo sz=320x50 para um único tamanho sz=320x50|300x50 para vários tamanhos Recomendamos que você codifique caracteres de barra vertical (|) em Solicitações sem tag com %7c. Exemplo &sz=216x36|300x50|320x50 se torna &sz=216x36%7c300x50%7c320x50.
url	É o URL do domínio que hospeda a solicitação de anúncio inicial. Obrigatório apenas para solicitações do MCM. Exemplo url=www.example.com
c	Valor do correlator (ou impedimento de cache). Precisa ser um número aleatório (letras não são permitidas) gerado por um editor para garantir que uma nova chamada ao servidor de anúncios aconteça cada vez que a página for carregada, a fim de evitar discrepâncias na contagem de impressões. Exemplo c=8362527364
tile	A posição da tag em uma página da Web. O valor deve ser um número inteiro exclusivo. Para facilitar a implementação, recomenda-se um valor de contagem mais alto. Ele só será necessário se várias tags de anúncios usarem os mesmos valores de código do bloco de anúncios (iu=) e correlator (c=) na mesma página. Exemplo https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2 Todas as solicitações com os valores de bloco incrementados (tile=) precisam ser acionadas em 30 segundos para garantir que o mesmo criativo não seja selecionado novamente para um determinado correlator (c=).

Parâmetros opcionais

Parâmetro	Descrição
d_imp	Alternância de impressões atrasadas. Se for ativado, a contagem de impressões mediante solicitação será desativada, e a macro de impressão visualizada no criativo retornado ou as informações do parâmetro d_imp_hdr serão usadas para gravar uma impressão. Exemplo d_imp=1 d_imp=0 é o valor padrão da contagem de impressões do Google Ad Manager.
d_imp_hdr	Alternância das informações do cabeçalho de impressão atrasada. Se incluído, o URL de visualização a ser usado para a contagem de impressão é retornado no cabeçalho HTTP.Por padrão, essas informações do cabeçalho não estão definidas. Um publisher precisa dar um ping manual nesse URL de visualização para contar uma impressão. Saiba mais sobre a contagem de impressões e as solicitações sem tag. O cabeçalho Google-Delayed-Impression contém o URL de impressão do Google Ad Manager. O cabeçalho Google-3rdParty-Delayed-Impression contém o URL de impressão de terceiros quando ele está no criativo. Exemplo d_imp_hdr=1 d_imp_hdr=0 desativa explicitamente as informações do cabeçalho de impressão atrasada.
t	Pares de chave-valor no nível do local. Cada chave e cada valor são separados pelo caractere do sinal de igual =. Pares de chaves-valor são separados pelo caractere do "e" comercial &. Cada chave e valor deve ser individualmente codificado para URL. Dessa forma, toda a string será codificada para URL.Todas as chaves de um conjunto de chaves-valor precisam ser únicas. Se você fornecer a mesma chave mais de uma vez, somente um dos valores associados será considerado. Exemplo O parâmetro t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith atribui a chave "genre" ao valor "action", e a chave "movie" ao valor "Mr & Mrs Smith". O "&" entre as atribuições de chave-valor é codificado individualmente (%26), mas é duplamente codificado (%2526) quando ocorre dentro de um valor. Use excl_cat como uma chave especial para exclusões competitivas. Exemplo t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines Os seguintes caracteres não são permitidos em chaves ou valores: " ' ! + # * ~ ; ^ ( ) < > [ ] = Espaços são permitidos em valores, com escape como %20 ou +, mas não em chaves. Exemplo Definir a chave "a" como o valor "b+c" com t=a%3Db%252Bc não funciona.
m	É o valor do tipo mime no cabeçalho HTTP. Exemplo m=text/wml
mob	É o indicador da solicitação de anúncio para dispositivos móveis. Exemplo mob=js (único valor aceito)
ppid	Com o Identificador fornecido pelo publisher (PPID), você pode enviar um identificador para o Google Ad Manager. Esse identificador poderá ser usado no limite de frequência, na segmentação de audiência e por público-alvo, na rotação sequencial de anúncios e em outros controles de entrega de anúncios com base no público-alvo em vários dispositivos. Exemplo ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	É a largura da tela do dispositivo móvel que substitui a detecção automática feita pelo servidor de anúncios. Exemplo u_w=1024
u_h	É a altura da tela do dispositivo móvel que substitui a detecção automática feita pelo servidor de anúncios. Exemplo u_h=768
submodel	É a informação de hardware do dispositivo móvel que substitui a detecção automática feita pelo servidor de anúncios. Exemplo submodel=iPhone4%2C1 (a vírgula para delimitar o valor do submodelo é codificada) Valores do submodelo: iPhone (primeira geração): iphone1,1 iPhone 3G: iphone1,2 iPhone 3GS: iphone2,1 iPhone 4 (GSM): iphone3,1 iPhone 4 (GSM): iphone3,2 iPhone 4 (CDMA): iphone3,3 iPhone 4S: iPhone4,1 iPhone 5 (GSM e LTE): iPhone5,1 iPhone 5 (CDMA e LTE): iPhone5,2 iPhone 5c (GSM e CDMA): iPhone5,3 iPhone 5c (GSM e CDMA): iPhone5,4 iPhone 5s (GSM e CDMA): iPhone6,1 iPhone 5s (GSM e CDMA): iPhone6,2 iPhone 6: iPhone7,2 iPhone 6 Plus: iPhone7,1 iPhone 6s: iPhone8,1 iPhone 6s Plus: iPhone8,2 iPhone SE: iPhone8,4 iPhone 7: iPhone9,1 iPhone 7 Plus: iPhone9,2 iPod da primeira geração: iPod1,1 iPod da segunda geração: iPod2,1 iPod da terceira geração: iPod3,1 iPod da quarta geração: iPod4,1 iPod da quinta geração: iPod5,1 iPad da primeira geração (Wi-Fi): iPad1,1 iPad da primeira geração (AT&T): iPad1,2 iPad da segunda geração (Wi-Fi): iPad2,1 iPad da segunda geração (AT&T): iPad2,2 iPad da segunda geração (Verizon): iPad2,3 iPad da segunda geração (Wi-Fi): iPad2,4 iPad da terceira geração (Wi-Fi): iPad3,1 iPad da terceira geração (Verizon): iPad3,2 iPad da terceira geração (AT&T): iPad3,3 iPad da quarta geração (Wi-Fi): iPad3,4 iPad da quarta geração (AT&T): iPad3,5 iPad da quarta geração (Verizon): iPad3,6 iPad Mini (Wi-Fi): iPad2,5 iPad Mini (AT&T EUA, GSM e LTE 4, 17): iPad2,6 iPad Mini (Verizon global; GSM, DMA e LTE 1, 3, 5, 13, 25): iPad2,7 iPad Mini Retina (Wi-Fi): iPad4,4 iPad Mini Retina (LTE): iPad4,5 iPad Air (Wi-Fi): iPad4,1 iPad Air (LTE): iPad4,2

 

Use o ID reconfigurável do dispositivo (RDID) para limite de frequência e segmentação por público-alvo. Saiba mais sobre como configurar o RDID para Solicitações sem tag.

Ativar o rastreamento de impressões

As Solicitações sem Tag só são compatíveis com um pixel de rastreamento de impressões de terceiros. Se mais de um for configurado em um criativo, apenas o primeiro pixel renderizado será usado.

O Google Ad Manager pode rastrear impressões, também conhecidas como impressões "atrasadas", para Solicitações sem Tag. Use uma das opções abaixo, mas não as duas ao mesmo tempo. Usar todas as opções em conjunto faz com que as impressões sejam contadas duas ou três vezes.

Recomendamos a opção 1. No entanto, você precisará ter acesso aos cabeçalhos da resposta HTTP e ser capaz de implementar um protocolo baseado em cabeçalho.

Opção 1: ler o cabeçalho da resposta HTTP para controlar a contagem de impressões

Adicione os parâmetros d_imp=1 e d_imp_hdr=1 à sua Solicitação sem Tag para o Google Ad Manager não registrar uma impressão até você acionar manualmente um ping de impressão com o URL do cabeçalho HTTP Google-Delayed-Impression. Quando o ping de impressão for acionado, uma "impressão do servidor de anúncios" e uma "impressão begin-to-render do servidor de anúncios" serão registradas pelo Google Ad Manager.

Não inclua a macro de impressão visualizada dos criativos retornados por Solicitações sem tag para evitar que as impressões sejam contadas duas vezes.

Opção 2: usar a macro de impressão visualizada

Se você não puder acessar cabeçalhos de resposta HTTP, segmente seu inventário e adicione a macro de impressão visualizada ao snippet de código de cada criativo retornado por uma Solicitação sem tag. Essa macro se expande para o URL a ser enviado pelo criativo durante a renderização.

Fazer uma Solicitação sem tag para recuperar o código do criativo

Conteúdo da Web

Em geral, as Solicitações sem tag são usadas em ambientes incompatíveis com as tags do Google ou com o SDK. Se você fizer uma Solicitação sem tag na Web, ela precisará ser carregada em um <iframe> para que possa executar o código bruto retornado.

Ambientes personalizados sem um SDK do Google

Para recuperar o código do criativo bruto em ambientes sem as tags do Google ou a compatibilidade com o SDK (por exemplo, um conversor que não é do Google), consulte as diretrizes a seguir:

• Defina um user agent válido no cabeçalho User-Agent da solicitação para garantir que a segmentação funcione.
• Garanta que seu ambiente possa lidar com os comportamentos de rich media, incluindo expansão do criativo e JavaScript.
• Faça uma solicitação HTTPS para o Google Ad Manager.
• Inspecione o status da resposta para encontrar "HTTP 200/OK", indicando que a solicitação foi realizada corretamente.

Recursos não compatíveis com as Solicitações sem tag

• Active View
• Ad Exchange
• Identificadores de apps para dispositivos móveis ou cookies usados para rastreamento
• Wrappers de criativo
• Alocação dinâmica com o Google AdSense, Ad Exchange ou AdMob
• Inventário nativo
• Transações preferenciais
• Visualização de criativos
• AdChoices

As Solicitações sem Tag que usam gampad/ad em tags HTML de imagem (<img>) não são compatíveis com códigos de acompanhamento JavaScript nem com a contagem de impressões.

Para gerar relatórios sobre esses anúncios, use a métrica "Contagem total de veiculações de código" no Google Ad Manager.

Os selos de anúncio não são compatíveis com os criativos veiculados em Solicitações sem tag. Seu anúncio precisa obedecer aos requisitos regulatórios aplicáveis para anúncios veiculados no Espaço Econômico Europeu (EEE). Isso inclui um mecanismo para os usuários denunciarem conteúdo ilegal. Os publishers precisam notificar o Google sobre denúncias de conteúdo ilegal usando o formulário adequado.