Para usuários avançados, oferecemos uma lista dos parâmetros de estilo de pesquisa compatíveis. O código gerado no Google AdSense inclui todas as configurações de parâmetros usadas com mais frequência. Há dois parâmetros obrigatórios: pubId e query. O Google AdSense fornece o pubId, mas você precisa editar o código e informar um valor para o parâmetro query. Todos os outros parâmetros são opcionais e estão descritos abaixo.
Tipos de parâmetro
Há dois tipos de parâmetro:
- Parâmetros no nível da página, que se aplicam a todos os blocos de anúncios da página
- Parâmetros no nível do bloco, que se aplicam a blocos de anúncios individuais
Veja alguns exemplos de saída do gerador de código com dois blocos de anúncios. Para configurar esse código, defina o parâmetro query obrigatório no mapa pageOptions (por exemplo, “query”: myQuery). Não é necessário fazer mais nada para começar a exibir anúncios. Você também pode definir parâmetros opcionais de página no snippet no nível da página, além de definir parâmetros específicos no nível do bloco nos mapas adblock1 e adblock2.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Parâmetros no nível da página
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Parâmetros no nível do bloco
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Descrições dos parâmetros no nível da 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 É a consulta de pesquisa inserida pelo usuário. O valor do parâmetro de consulta não pode estar codificado. Exemplos:
|
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:
|
styleId |
Obrigatório Especifica o ID do estilo de pesquisa personalizado que será aplicado aos blocos de anúncios ou de pesquisa relacionada na página. Saiba mais sobre como usar os estilos de pesquisa. Com o styleId definido para uma solicitação, as pesquisas relacionadas ou os anúncios 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
|
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 uma nova janela. O padrão é "_top". Esse parâmetro também pode ser usado no nível do bloco.
Exemplo: 'linkTarget' : '_blank' |
maxTermLength |
Opcional Especifica o número máximo de caracteres de um termo de pesquisa relacionada, incluindo espaços. Quando o parâmetro não é definido, não há um valor máximo. Exemplo: 'maxTermLength' : 50 |
referrerAdCreative |
Opcional Se um usuário acessar sua página 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:
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. Exemplo: 'terms' : 'cars rental, flight ticket' |
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. Veja a seguir as configurações válidas para adsafe e o efeito de cada valor nos anúncios retornados:
Observação: 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 Observação: use esse parâmetro apenas ao realizar testes. Se ele for usado em sistemas de produção, você não receberá pelos anúncios exibidos.
O valor padrão de 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 do canal exclusivo que você criou na sua conta do Google AdSense. Saiba mais sobre como acompanhar o desempenho de anúncios com canais personalizados. 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 solicitados devem segmentar. O valor padrão é "en". O Google aceita todos os códigos de idioma da API Google Ads. Observação: os anunciantes especificam os idiomas que os anúncios segmentam. Se você incluir esse parâmetro na sua solicitação, o Google vai retornar apenas anúncios segmentados para o idioma em questão ou para todos os idiomas, mas não vai garantir que o texto do anúncio esteja no idioma definido.
Normalmente, você deve definir o parâmetro Exemplos: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Opcional
O parâmetro O valor padrão de
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Opcional
O parâmetro O valor padrão de
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Opcional Especifica se os usuários aceitaram que o editor compartilhe informações pessoais com o Google para publicidade personalizada.
Observação: por padrão,
personalizedAds é definido como "true".Exemplo: 'personalizedAds': false |
Descrições dos parâmetros no nível do bloco
Esses parâmetros afetam como blocos de anúncios individuais em uma página são apresentados aos usuários. Cada parâmetro pode ser definido individualmente por 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 id='afscontainer1'></div> em que o anúncio deve aparecer.
Exemplo: |
maxTop |
Obrigatório
Use esse parâmetro para especificar o número de anúncios que vão aparecer no bloco de anúncios superior. 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: |
width |
Obrigatório Especifica a largura do bloco de anúncios ou de pesquisa relacionada em pixels. Exemplos: '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 pode ser implementada. 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 { // Provavelmente não faz nada } catch (e) { alert ("Error in callback function"); // Toma medidas para lidar com o erro } } else { // Como você sempre faz quando não há cobertura de anúncios do Google } } }; |
||||||||
number |
Opcional O número de anúncios que devem aparecer nesse bloco. O valor padrão é "2". Exemplo: |
||||||||
relatedSearches |
Opcional O número de pesquisas relacionadas que devem aparecer nesse bloco. Esse parâmetro retorna um mínimo de três pesquisas relacionadas, a menos que seja definido como zero. O padrão será "0" se nada for especificado. Exemplo: 'relatedSearches' : 4 |
