Parâmetros
Descrições dos parâmetros de nível de página
Esses parâmetros precisam ser especificados apenas uma vez por página. É importante destacar que eles afetam todos os blocos na página.
Obrigatório
| Parâmetro | Descrição e exemplos |
|---|---|
adPage
|
Obrigatório quando o usuário acessa a página de resultados seguintes ou anteriores. O parâmetro |
pubId
|
Obrigatório É seu ID do cliente do AdSense. O pubId é a parte do ID do cliente que vem depois de "partner-". Por exemplo, se o ID for "partner-test-property", o pubId será "test-property". Esse é o protocolo padrão para os CSAs. Exemplo: 'pubId' : 'test-property' |
query
|
Obrigatório, exceto na pesquisa relacionada em páginas de conteúdo. É a consulta de pesquisa inserida pelo usuário. O valor do parâmetro de consulta não pode estar codificado. Observação:usar esse parâmetro na pesquisa relacionada em páginas de conteúdo causa resultados inesperados. Exemplos: 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // myQuery is a variable containing the search query |
resultsPageBaseUrl
|
Obrigatório quando há blocos de pesquisa relacionada na página. Especifica o URL da página de resultados da pesquisa em que a consulta é o termo de pesquisa relacionada clicado pelo usuário. O resultsPageBaseUrl pode incluir os próprios parâmetros, exceto a consulta de pesquisa, que será anexada automaticamente. Exemplo: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2' |
relatedSearchTargeting
|
Obrigatório quando há blocos de pesquisa relacionada na página. Esse parâmetro é obrigatório quando blocos de pesquisa relacionada são solicitados. Ele controla o tipo de experiência de Pesquisa relacionada que é mostrada, dependendo do contexto da página:
Observação:por padrão, o parâmetro de página relatedSearchTargeting é definido automaticamente como "query". No entanto, é importante observar que esse valor padrão foi projetado apenas para páginas de resultados da pesquisa (Pesquisa relacionada na Pesquisa). Se você estiver usando a pesquisa relacionada em qualquer outro tipo de página (por exemplo, artigos, postagens de blog), defina explicitamente o parâmetro como "content". Observação:estas diretrizes se aplicam ao uso do parâmetro em questão:
Exemplos: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId
|
Obrigatório Especifica o ID do estilo de pesquisa personalizada que será aplicado ao anúncio ou aos blocos de pesquisa relacionada na página. Saiba mais sobre como usar estilos de pesquisa personalizados. Com o styleId definido para uma solicitação, os anúncios ou as pesquisas relacionadas serão renderizados com o estilo, e os parâmetros de estilo legados serão ignorados. Se o styleId não for especificado na solicitação, um estilo padrão do sistema será renderizado. Exemplo: 'styleId': '1234567890' |
Opcional
| Parâmetro | Descrição e exemplos |
|---|---|
linkTarget
|
Opcional Especifica se clicar em um anúncio faz ele ser aberto na mesma janela ou em outra nova. O padrão é "_top". Esse parâmetro também pode ser usado no nível do bloco.
Exemplo: 'linkTarget' : '_blank' |
referrerAdCreative
|
Opcional Se um usuário acessar sua página de conteúdo que contém um bloco de pesquisa relacionada de conteúdo após clicar em um anúncio ou link em outro site, e esse anúncio ou link estiver sob seu controle, o parâmetro vai precisar usar o texto completo do criativo do anúncio ou link. Estas diretrizes se aplicam ao uso do parâmetro em questão:
Observação:esse parâmetro é obrigatório ao usar o
parâmetro Exemplos: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam
|
Opcional Especifica o nome do parâmetro de URL da consulta de pesquisa na página de resultados da pesquisa. O padrão será "q" se nada for especificado. Exemplo: 'resultsPageQueryParam' : 'query' |
terms
|
Opcional Com esse parâmetro, você pode fornecer uma lista separada por vírgulas dos seus próprios termos de pesquisa relacionada que devem ser retornados com uma solicitação de pesquisa desse tipo, embora o Google possa ou não usar os termos fornecidos aqui.
Observação:ao usar esse parâmetro, Exemplos: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
Opcional Especifica a lista de parâmetros de URL de uma página de conteúdo com uma unidade de pesquisa relacionada para conteúdo que pode ser ignorada com segurança sem afetar o conteúdo principal ou a experiência do usuário. Observação:para que os termos de pesquisa relacionada possam ser mostrados no seu site, o Google precisa rastrear suas páginas e garantir que os termos sejam contextualmente relevantes. Quando uma página ainda não foi rastreada ou está bloqueada para rastreamento (por exemplo, por um robots.txt) pelo Rastreador do AdSense, não vamos mostrar os termos sugeridos da Pesquisa relacionada que você fornece ao Google. O produto Pesquisa relacionada no conteúdo depende do sistema de rastreamento de conteúdo do Google para indexar páginas e gerar termos de pesquisa relevantes. URLs de páginas de conteúdo com parâmetros de consulta, como variáveis de rastreamento, IDs de usuário, IDs de sessão ou outros identificadores dinâmicos, podem interferir na capacidade do rastreador de avaliar o conteúdo principal da página e gerar termos de pesquisa relacionados imprecisos ou irrelevantes. Esse parâmetro de página instrui o rastreador do Google a ignorar esses parâmetros não essenciais, garantindo a indexação adequada do conteúdo e reduzindo a carga desnecessária de rastreamento. Isso permite que o Google reconheça melhor uma página como já rastreada e comece a mostrar termos sugeridos (do Google e do parceiro, se qualificados). Estas diretrizes se aplicam ao uso do parâmetro em questão:
Exemplos:
http://example.com/content?utm_medium=social&page_id=123&click_id=456 'ignoredPageParams' : 'utm_medium,click_id,session_ref' http://example.com/content?page_id=123 |
Definições de configuração
| Parâmetro | Descrição e exemplos | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe
|
Opcional Especifica as regras de filtragem que o Google deve aplicar aos anúncios relacionados à consulta de pesquisa. Confira a seguir as configurações válidas para "adsafe" e o efeito de cada valor nos anúncios retornados:
Por padrão, o parâmetro adsafe é definido como "high". Exemplo: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
Opcional O parâmetro adtest é usado para indicar que uma solicitação de anúncios é um teste. Quando o parâmetro adtest tem o valor on, o Google trata a solicitação como um teste e não conta as impressões de anúncios nem acompanha a taxa de cliques. Quando o parâmetro adtest tem o valor on, você não gera receita. Solicitações de anúncios com o parâmetro adtest definido como on provenientes de um domínio que não foi aprovado na guia "Sites" retornam anúncios com uma sobreposição de "anúncio de teste" não clicáveis. Use esse parâmetro ao realizar testes, mas não em sistemas de produção. Se fizer isso, você não vai receber pelos anúncios veiculados. O valor padrão do parâmetro "adtest" é "off". Exemplo: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel
|
Opcional Inclua um canal do AdSense para pesquisas se quiser acompanhar a performance de páginas diferentes. Use o ID do canal exclusivo criado na sua conta do Google AdSense ou pelo seu gerente técnico de contas. Saiba mais sobre os canais aqui. No caso de vários canais, separe usando o símbolo "+". Exemplos: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl
|
Opcional Esse parâmetro identifica o idioma que os anúncios ou pesquisas relacionadas solicitados devem segmentar. O valor padrão é en. O Google aceita todos os códigos de idioma da API AdWords. Observação: os anunciantes devem especificar os idiomas em que seus anúncios estão segmentados. Se você incluir esse parâmetro na sua solicitação, o Google retornará somente anúncios segmentados no idioma escolhido ou em todos os idiomas. No entanto, isso não garante que o texto do anúncio estará no idioma especificado. Normalmente, você deve definir o parâmetro "hl" como o idioma principal da página a partir da qual o parâmetro é enviado. Exemplos: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie
|
Opcional O parâmetro O valor padrão de
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Opcional O parâmetro O valor padrão de
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
Opcional Esse parâmetro permite fornecer um booleano que informa ao Google que você quer permitir anúncios que usam armazenamento local e de cookies exclusivo para tráfego inválido no tráfego com ou sem consentimento.
Por padrão, a IVT é definida como "true". Exemplo: 'ivt': false |
Descrições dos parâmetros de nível de unidade
Esses parâmetros afetam a forma como os blocos de anúncios individuais em uma página são apresentados ao usuário. Cada parâmetro pode ser definido individualmente para cada bloco de anúncios.
Obrigatório
| Parâmetro | Descrição e exemplos |
|---|---|
container
|
Obrigatório O ID do contêiner de anúncio vazio <div> em que o anúncio deve aparecer.
Exemplo: 'container' : 'afscontainer1' |
maxTop
|
Obrigatório quando o bloco de anúncios está acima dos resultados da pesquisa. Use esse parâmetro para especificar o número de anúncios que vão aparecer no bloco de anúncios de cima. Observação: esse parâmetro é usado no lugar do parâmetro "number". Esse bloco de anúncios deve ter largura suficiente para que a primeira linha dos anúncios não seja quebrada. O uso do parâmetro maxTop em qualquer outro canal na página é uma violação da política. Exemplo: 'maxTop' : 4 |
width
|
Obrigatório Especifica a largura do anúncio ou da unidade de pesquisa relacionada em pixels. Exemplo: 'width' : '700px' 'width' : 700 |
Definições de configuração
| Parâmetro | Descrição e exemplos | ||||||||
|---|---|---|---|---|---|---|---|---|---|
adLoadedCallback
|
Opcional Especifica uma função JavaScript que será chamada quando os anúncios ou pesquisas relacionadas carregarem ou quando nenhuma pesquisa relacionada ou anúncio é veiculado. O parâmetro deve ser definido como uma função de callback JavaScript que você implementa. Assim, é possível realizar uma ação quando a chamada de anúncio é concluída. A função de callback usa os seguintes parâmetros:
Observação: teste a função de callback para garantir que ela não gere erros, principalmente aqueles que podem interferir no carregamento da sua página. Exemplo de um callback JavaScript: var adblock1 = { 'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // most likely do nothing } catch (e) { alert ("Error in callback function"); // Do something to handle error gracefully } } else { // as you always do when there is no ad coverage from Google } } }; |
||||||||
number
|
Opcional O número de anúncios que devem aparecer nesse bloco. O valor padrão é 2. Exemplo: 'number' : 4 |
||||||||
relatedSearches
|
Opcional O número de pesquisas relacionadas que devem aparecer nesse bloco. Se esse valor for menor que 3, nenhuma pesquisa relacionada será mostrada. Exemplo: 'relatedSearches' : 4 |