Parâmetros
Descrições dos parâmetros de nível de página
Esses parâmetros só precisam ser especificados uma vez por página. Eles afetam todos os blocos na página.
Obrigatório
Parâmetro | Descrição e exemplos |
---|---|
adPage
|
Obrigatório quando o usuário navega para a próxima página de resultados ou para a anterior. O parâmetro |
pubId
|
Obrigatório É seu ID do cliente do Google 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 CSAs. Exemplo: 'pubId' : 'test-property' |
query
|
Obrigatório, exceto na pesquisa relacionada em páginas de conteúdo. Essa é a consulta de pesquisa inserida pelo usuário. O valor do parâmetro de consulta não pode ser codificado. Observação:o uso desse parâmetro na pesquisa relacionada em páginas de conteúdo gera 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 em que o usuário clicou. O resultsPageBaseUrl pode incluir seus 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 os blocos de pesquisa relacionada são solicitados. Ele controla o tipo de experiência de pesquisa relacionada que é exibido, dependendo do contexto da página:
Observação: o parâmetro da página relatedSearchSegmentação é definido automaticamente como "consulta" por padrão. No entanto, é importante observar que esse valor padrão foi projetado especificamente para ser usado apenas em 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), será necessário definir explicitamente o parâmetro como "content". Observação: as diretrizes a seguir se aplicam ao uso desse parâmetro.
Por exemplo: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId
|
Obrigatório Especifica o ID do estilo de pesquisa personalizado a 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 pesquisas relacionadas serão renderizados com o estilo, e os parâmetros de estilo legados serão ignorados. Se 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 abre na mesma janela ou em uma nova janela. O padrão é "_top". Esse parâmetro também pode ser usado no nível da unidade.
Exemplo: 'linkTarget' : '_blank' |
maxTermLength
|
Opcional Especifica o número máximo de caracteres de um termo de pesquisa relacionada, incluindo espaços. Não há um valor máximo se não for definido. Exemplo: 'maxTermLength' : 50 |
referrerAdCreative
|
Opcional Se um usuário acessar sua página de conteúdo que contém um bloco de pesquisa relacionada para conteúdo clicando em um anúncio ou link em outro site, e esse anúncio ou link estiver sob seu controle, esse parâmetro precisará ser definido como o texto do criativo desse anúncio ou link na íntegra. As diretrizes a seguir se aplicam ao uso desse parâmetro:
Observação:esse parâmetro é obrigatório ao usar 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. Se não for especificado, o padrão será "q". Exemplo: 'resultsPageQueryParam' : 'query' |
terms
|
Opcional Esse parâmetro permite fornecer uma lista delimitada por vírgulas dos seus próprios termos de pesquisa relacionada que serão retornados com uma solicitação de pesquisa relacionada, 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 para 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:antes que os termos de pesquisa relacionada possam ser exibidos no seu site, o Google precisa rastrear suas páginas para garantir que eles sejam contextualmente relevantes. Quando uma página ainda não foi rastreada ou tem o rastreamento bloqueado (por exemplo, por um robots.txt) pelo Rastreador do AdSense, os termos de pesquisa relacionada sugeridos que você fornece ao Google não aparecem. A 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. Os URLs de páginas de conteúdo que contêm parâmetros de consulta, como variáveis de acompanhamento, IDs de usuários, 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 resultar em termos de pesquisa relacionados imprecisos ou irrelevantes. Este 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 o carregamento desnecessário 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 qualificado). As diretrizes a seguir se aplicam ao uso desse parâmetro:
Exemplos:
http://example.com/content?utm_medium=social&page_id=123&click_id=456Fornecer os seguintes parâmetros de URL ignoráveis: 'ignoredPageParams' : 'utm_medium,click_id,session_ref'O URL da página de conteúdo seria tratado como: 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 que correspondem à 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 adsafe é definido como alto. 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 contabiliza as impressões de anúncios nem acompanha os resultados da taxa de cliques. Quando o parâmetro "adtest" tem o valor on, você não gera receita. As 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" retornarão anúncios que têm uma sobreposição de "anúncio de teste" e não são clicáveis. Use esse parâmetro ao fazer testes, mas não em sistemas de produção. Caso contrário, você não vai receber pelos anúncios mostrados. O valor padrão do parâmetro "adtest" é "off". Exemplo: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel
|
Opcional Você pode incluir um canal do AdSense para pesquisas se quiser acompanhar o desempenho de páginas diferentes. Use o ID exclusivo do canal criado na sua conta do Google AdSense ou pelo seu Gerente técnico de contas. Saiba mais sobre canais aqui. Vários canais precisam ser separados pelo símbolo "+". Exemplos: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl
|
Opcional Esse parâmetro identifica o idioma que os anúncios solicitados ou as pesquisas relacionadas precisam 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 do
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Opcional O parâmetro O valor padrão do
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
Opcional Com esse parâmetro, é possível fornecer um booleano que informa ao Google que você quer permitir anúncios que usam armazenamento local e cookies exclusivos para tráfego inválido no tráfego com ou sem consentimento.
Por padrão, o IVT é definido como verdadeiro. 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 vazio <div> onde o anúncio deve ser exibido.
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 a serem exibidos no bloco de anúncios superior. Observação: esse parâmetro é usado no lugar do parâmetro "number". Esse bloco de anúncios precisa 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 do bloco 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 a ser chamada quando os anúncios ou pesquisas relacionadas forem carregados ou quando nenhum anúncio ou pesquisa relacionada for veiculado. O parâmetro precisa ser definido como uma função de callback JavaScript que você implementa, permitindo que uma ação seja realizada quando a chamada de anúncio for 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 se ela interferir no carregamento da 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 ser exibidos nesse bloco. O valor padrão é 2. Exemplo: 'number' : 4 |
||||||||
relatedSearches
|
Opcional É o número de pesquisas relacionadas que devem aparecer nesse bloco. O padrão será 0 se nada for especificado. Exemplo: 'relatedSearches' : 4 |