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 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 apenas o código do criativo bruto, exatamente como programado, sem executar e exibir o anúncio. Se nenhum anúncio for encontrado, o status 200/OK vai 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.

Não use solicitações sem tag para veicular anúncios em e-mails. Confira todos os recursos não compatíveis.

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 todos os parâmetros 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

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 GMC. 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

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 editor 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	O parâmetro Identificador fornecido pelo editor (PPID) permite que você envie um identificador para o Google Ad Manager que pode 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 exibição 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, na sigla em inglês) 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

O Ad Manager pode rastrear impressões baixadas, 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 que o Google Ad Manager não registre uma impressão nem uma impressão baixada até que você acione 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 baixada do servidor de anúncios" vão ser 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 que vai 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, vai ser preciso carregar a solicitação em um <iframe> para poder 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

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 baixadas.

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