Referencia

Parámetros

Descripciones de los parámetros a nivel de la página

Estos parámetros solo se deben especificar una vez por página. y afectan a todas las unidades de la página.

Obligatorio

Parámetro Descripción y ejemplos
adPage Obligatorio cuando el usuario navega a la página de resultados siguiente o anterior.

El parámetro adPage especifica la página de resultados en la que se muestran los anuncios. Este parámetro se utiliza cuando los usuarios acceden a una página más allá de la primera página de resultados de la búsqueda. Por ejemplo, si se solicitan cinco anuncios y el parámetro adPage está establecido en 2, los anuncios que se muestren corresponderán a la segunda página de cinco anuncios.

pubId Obligatorio
Este es tu ID de cliente de AdSense. El parámetro pubId es la parte de tu ID de cliente que aparece después de "partner-". Por ejemplo, si tu ID de cliente es "partner-test-property", el parámetro pubId es "test-property". Este es un protocolo estándar de CSA.

Ejemplo: 

'pubId' : 'test-property'
query Obligatorio, excepto en la Búsqueda relacionada en las páginas de contenido.
Es la búsqueda que ingresó el usuario. El valor del parámetro de consulta no debe estar codificado.

Nota: Si usas este parámetro en la Búsqueda relacionada en las páginas de contenido, se generarán resultados inesperados.

Ejemplos: 

'query' : 'flowers'
 
'query' : 'black & decker'
 
'query' : myQuery // myQuery is a variable containing the search query
resultsPageBaseUrl Obligatorio cuando hay unidades de búsquedas relacionadas en la página.
Es la URL de la página de resultados de búsqueda en la que la búsqueda es el término de búsqueda relacionado en el que el usuario hizo clic. resultsPageBaseUrl puede incluir sus propios parámetros, excepto la búsqueda, que se agregará automáticamente.

Ejemplo: 

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
relatedSearchTargeting Obligatorio cuando hay unidades de búsquedas relacionadas en la página.
Este parámetro es obligatorio cuando se solicitan unidades de búsqueda relacionadas. Controla el tipo de experiencia de búsqueda relacionada que se muestra, según el contexto de la página:
  • 'content' Usa esta opción para la Búsqueda relacionada en páginas de contenido (p.ej., artículos o entradas de blog).
  • 'query' Usa esta opción exclusivamente para la Búsqueda relacionada en las páginas de resultados de la búsqueda.

Nota: El parámetro de página relatedSearchTargeting se establece automáticamente en "query" de forma predeterminada. Sin embargo, es fundamental tener en cuenta que este valor predeterminado está diseñado específicamente solo para las páginas de resultados de la búsqueda (Búsqueda relacionada en la Búsqueda). Si usas la búsqueda relacionada en cualquier otro tipo de página (p.ej., artículos o publicaciones de blog), debes configurar el parámetro de forma explícita como "content".

Nota: Se aplican los siguientes lineamientos al uso de este parámetro:

  • Algunas funciones de búsqueda relacionadas pueden estar habilitadas o inhabilitadas según el valor de este parámetro de página.
  • Se considera un incumplimiento de estas instrucciones por escrito tergiversar el tipo de página o depender de la configuración predeterminada de "búsqueda" para el parámetro relatedSearchTargeting en páginas que no son de resultados de la búsqueda.
  • Google puede verificar periódicamente la precisión de este valor, independientemente de si se establece manualmente o con el valor predeterminado.

Ejemplos:

'relatedSearchTargeting' : 'content'
 
'relatedSearchTargeting' : 'query'
styleId Obligatorio
Especifica el ID del estilo del anuncio de búsqueda personalizado que se aplicará al anuncio o a las unidades de búsquedas relacionadas en la página. Obtén más información sobre el uso de estilos de anuncios de búsqueda personalizados. Ten en cuenta que, si se establece el atributo styleId en una solicitud, se renderizarán los anuncios o las búsquedas relacionadas con el estilo, y se ignorarán los parámetros de estilo heredados. Si no se especifica styleId en la solicitud, se renderizará un estilo predeterminado del sistema.

Ejemplo: 

'styleId': '1234567890'

Opcional

Parámetro Descripción y ejemplos
linkTarget Opcional
Especifica si, cuando se hace clic en un anuncio, este se abre en la misma ventana o en una nueva. El valor predeterminado es "_top". Este parámetro también se puede usar a nivel de la unidad.
  • '_top' Se abre en la misma ventana.
  • '_blank' Se abre en una ventana nueva.

Ejemplo: 

'linkTarget' : '_blank'
referrerAdCreative Opcional
Si un usuario llega a tu página de contenido que contiene una unidad de búsqueda relacionada de contenido haciendo clic en un anuncio o un vínculo en otro sitio web, y ese anuncio o vínculo está bajo tu control, se debe establecer con exactitud este parámetro en el texto de la creatividad de ese anuncio o vínculo.

Los siguientes lineamientos se aplican al uso de este parámetro:

  • El parámetro solo debe proporcionarse en una solicitud de búsqueda relacionada de contenido y se ignorará en todas las demás solicitudes.
  • Solo debería utilizarse en el tráfico que obtienes intencionalmente de otros sitios web y no debería usarse en el tráfico orgánico.
  • Debe incluir la línea de título, la descripción o cualquier otro texto del anuncio o la creatividad del vínculo.
  • Omitir valores de la creatividad del anuncio o del vínculo (o incluir valores adicionales) se considera un incumplimiento de estas instrucciones por escrito.
  • No distingue mayúsculas de minúsculas.
  • Acepta codificación UTF-8 válida y admite caracteres Unicode o signos diacríticos.
  • Google puede usar o ignorar el parámetro que envíes. Si se usa, la selección y clasificación de los términos pueden verse afectadas.

Nota: Este parámetro es obligatorio cuando se usa el parámetro terms.

Ejemplos: 

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam Opcional
Es el nombre del parámetro de URL de la búsqueda en la página de resultados. El valor predeterminado es "q" si no se especifica.

Ejemplo: 

'resultsPageQueryParam' : 'query'
terms Opcional
Este parámetro te permite proporcionar una lista delimitada por comas de tus propios términos de búsqueda relacionados que se mostrarán con una solicitud de búsqueda relacionada; ten en cuenta que Google puede usar o no los términos que se proporcionen.

Nota: Cuando usas este parámetro, referrerAdCreative también es obligatorio y relatedSearchTargeting es obligatorio y debe establecerse en "content".

Ejemplos: 

'terms' : 'cars rental, flight ticket'
ignoredPageParams Opcional
Especifica la lista de parámetros de URL de una página de contenido con una unidad de búsqueda relacionada para contenido que se puede ignorar de forma segura sin afectar el contenido principal ni la experiencia del usuario.

Nota: Para que los términos de búsqueda relacionados puedan aparecer en tu sitio, Google debe rastrear tus páginas para asegurarse de que los términos sean relevantes en función del contexto. Cuando el rastreador de AdSense aún no rastrea una página o bloquea su rastreo (p. ej., con un archivo robots.txt), no mostraremos los términos de búsqueda relacionados sugeridos que proporciones a Google.

El producto Búsqueda relacionada en el contenido se basa en el sistema de rastreo de contenido de Google para indexar páginas y generar términos de búsqueda relevantes. Las URLs de las páginas de contenido que contienen parámetros de consulta, como variables de seguimiento, IDs de usuario, IDs de sesión o algún otro identificador dinámico, pueden interferir en la capacidad del rastreador para evaluar el contenido principal de la página y pueden generar términos de búsqueda relacionados inexactos o irrelevantes. Este parámetro de página le indica al rastreador de Google que ignore estos parámetros no esenciales, lo que garantiza la indexación adecuada del contenido y reduce la carga de rastreo innecesaria. Esto permite que Google reconozca mejor que una página ya se rastreó y comience a mostrar términos sugeridos (tanto de Google como del socio, si es apto).

Los siguientes lineamientos se aplican al uso de este parámetro:

  • El parámetro solo debe proporcionarse en una solicitud de búsqueda relacionada de contenido y se ignorará en todas las demás solicitudes.
  • El valor de este parámetro debe ser una lista delimitada por comas de parámetros de URL que pueden aparecer cuando cualquier usuario navega a la página de contenido.
  • Distingue entre mayúsculas y minúsculas.
  • Cuando se quita cualquier parámetro de URL de esta lista de la URL de la página de contenido, no debería haber un impacto significativo en el contenido, la apariencia ni la experiencia del usuario de las páginas.
  • Incluir un parámetro de URL que afecte de forma significativa el contenido, la apariencia o la experiencia del usuario de las páginas se considera un incumplimiento de estas instrucciones por escrito.
  • Google puede verificar periódicamente el efecto de ignorar los parámetros de URL proporcionados.

Ejemplos:
Un usuario visita una página de contenido y la URL es la siguiente: 

http://example.com/content?utm_medium=social&page_id=123&click_id=456
 Proporciona los siguientes parámetros de URL que se pueden ignorar: 
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
 Trataría la URL de la página de contenido de la siguiente manera: 
http://example.com/content?page_id=123

Parámetros de configuración

Parámetro Descripción y ejemplos
adsafe Opcional
Establece las reglas de filtro que Google debe aplicar a los anuncios que coinciden con la búsqueda. A continuación, se presentan las configuraciones válidas de adsafe y el efecto que cada valor tiene en los anuncios mostrados:
  • 'high' Muestra anuncios aptos para todo público. No muestra anuncios no aptos para menores ni con contenido sexual para adultos.
  • 'medium' Devuelve anuncios aptos para todo público y no aptos para menores. No muestra anuncios con contenido sexual para adultos.
  • 'low' Muestra todos los tipos de anuncios.

De forma predeterminada, adsafe se establece en alto.

Ejemplo: 

'adsafe': 'medium'
adtest Opcional
El parámetro adtest se usa para indicar que una solicitud de anuncios es una prueba. Cuando el parámetro adtest tiene el valor on, Google trata la solicitud como una prueba y no registra las impresiones de anuncios ni hace un seguimiento de los resultados relacionados con los clics.

Cuando el parámetro adtest tiene el valor on, no generas ingresos.

Las solicitudes de anuncios con el parámetro adtest establecido en on que provengan de un dominio que no esté aprobado en la pestaña Sitios mostrarán anuncios que contienen una superposición que indica "anuncio de prueba", y no se puede hacer clic en ellos.

Utiliza este parámetro cuando realices pruebas, pero no en sistemas de producción, ya que no se te pagará por los anuncios que muestres.

El valor predeterminado de adtest está desactivado.

Ejemplo: 

'adtest' : 'on'
channel Opcional
Puedes incluir un canal de AdSense para búsquedas para hacer un seguimiento del rendimiento de las diferentes páginas. Usa el ID de canal único que creaste en tu cuenta de AdSense o que creó tu administrador técnico de cuentas. Obtén más información sobre los canales aquí.

Si se incluyen varios canales, estos se deben separar con un signo "+".

Ejemplos: 

'channel' :  'testA'  
'channel' :  'testA+testB'
hl Opcional
Este parámetro identifica el idioma al que se deben segmentar los anuncios solicitados o las búsquedas relacionadas. El valor predeterminado es en.

Google admite todos los códigos de idioma de la API de AdWords.

Nota: Los anunciantes especifican los idiomas a los que se orientan sus anuncios. Si incluyes este parámetro en tu solicitud, Google mostrará únicamente los anuncios que se segmenten para ese idioma, o bien para todos los idiomas, pero no garantizará que el texto del anuncio esté en el idioma especificado.

Por lo general, debes establecer el parámetro hl en el idioma principal de la página desde la que se envía este parámetro.

Ejemplos: 

'hl' : 'es'
ie Opcional

El parámetro ie establece el esquema de codificación de caracteres que se debe utilizar para interpretar la cadena de consulta.

El valor predeterminado de ie es utf-8.

Valor Nombre estándar Idiomas admitidos relacionados
latin1 ISO-8859-1 Europa occidental (alemán, catalán, danés, español, finés, francés, holandés, indonesio, inglés, italiano, noruego, portugués, sueco)
latin2 ISO-8859-2 Europa oriental (checo, croata, húngaro,, rumano, serbio, esloveno, eslovaco)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Báltico (estonio, letón, lituano)
cirílico ISO-8859-5 Búlgaro, ruso
arabic ISO-8859-6  
griego/griega ISO-8859-7 Griego
hebrew ISO-8859-8 Hebreo
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandés
euc-jp EUC-JP Japonés
euc-kr EUC-KR Coreano
sjis Shift_JIS Japonés
big5 Big5 Chino tradicional
gb GB2312 Chino simplificado
utf-8 UTF-8 Todos
oe Opcional

El parámetro oe establece el esquema de codificación de caracteres que Google debe utilizar para codificar el texto de los anuncios. Si bien se trata de un parámetro técnicamente opcional, se recomienda pasar un valor de todas formas.

El valor predeterminado de oe es utf-8.

Valor Nombre estándar Idiomas admitidos relacionados
latin1 ISO-8859-1 Europa occidental (alemán, catalán, danés, español, finés, francés, holandés, indonesio, inglés, italiano, noruego, portugués, sueco)
latin2 ISO-8859-2 Europa oriental (checo, croata, húngaro,, rumano, serbio, esloveno, eslovaco)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Báltico (estonio, letón, lituano)
cirílico ISO-8859-5 Búlgaro, ruso
arabic ISO-8859-6  
griego/griega ISO-8859-7 Griego
hebrew ISO-8859-8 Hebreo
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandés
euc-jp EUC-JP Japonés
euc-kr EUC-KR Coreano
sjis Shift_JIS Japonés
gb GB2312 Chino simplificado
utf-8 UTF-8 Todos
ivt Opcional
Este parámetro te permite proporcionar un valor booleano que le informe a Google que deseas permitir los anuncios que utilizan una cookie exclusiva para el tráfico no válido y el almacenamiento local en el tráfico con consentimiento y sin este.
  • true Cuando este parámetro no esté presente o lo configures como "true", estableceremos una cookie solo para el tráfico no válido y usaremos el almacenamiento local solo en el tráfico con consentimiento.
  • false Cuando configures este parámetro como "false", estableceremos una cookie solo para el tráfico no válido y usaremos el almacenamiento local en el tráfico con consentimiento y sin este.

De forma predeterminada, IVT se establece como verdadero.

Ejemplo: 

'ivt': false

Descripciones de los parámetros a nivel de la unidad

Estos parámetros afectan la manera en que se presentan los bloques de anuncios individuales de una página al usuario. Se puede establecer cada parámetro por separado para cada unidad de anuncios.

Obligatorio

Parámetro Descripción y ejemplos
container Obligatorio
Es el ID del contenedor de anuncios vacío <div> donde debe aparecer el anuncio.

Ejemplo: 

'container' : 'afscontainer1'
maxTop Obligatorio cuando la unidad de anuncios está por encima de los resultados de la búsqueda.

Utiliza este parámetro para especificar la cantidad de anuncios que se mostrarán en la unidad de anuncios en la parte superior de la página.

Nota: Este parámetro se utiliza en lugar del parámetro "number". Esta unidad de anuncios debe tener un ancho suficiente para que no deba ajustarse la primera línea de los anuncios. Utilizar el parámetro maxTop en cualquier otra posición de la página constituye un incumplimiento de política.

Ejemplo:

'maxTop' : 4
width Obligatorio
Es el ancho en píxeles del anuncio o la unidad de búsquedas relacionadas.

Ejemplo: 

'width' : '700px'
 
'width' : 700

Parámetros de configuración

Parámetro Descripción y ejemplos
adLoadedCallback Opcional
Establece una función de JavaScript a la que se llamará cuando se carguen los anuncios o las búsquedas relacionadas, o cuando estos no se publiquen. El parámetro se debe establecer como una función de devolución de llamada de JavaScript que usted implemente, lo que permite que se realice una acción cuando se complete la llamada del anuncio.

La función de devolución de llamada toma los siguientes parámetros:

containerName Es el nombre del contenedor del anuncio o de la unidad de búsquedas relacionadas.
adsLoaded Se establece como verdadero cuando hay para mostrar al menos un anuncio o un término de búsqueda relacionado y como falso cuando no se muestran anuncios o búsquedas relacionadas.
isExperimentVariant Se establece como verdadero si se está ejecutando un experimento de diseño personalizado y se elige la variante del experimento para renderizar los anuncios.
callbackOptions Un objeto JSON que contiene los siguientes campos:
termPositions: Para un bloque de búsqueda relacionada, contiene un map<string,int> de los términos proporcionados por el publicador a una posición no indexada de estos términos en la respuesta. Si se proporciona un término, pero no se muestra, no aparecerá en el mapa.

Nota: Prueba la función de devolución de llamada para asegurarte de que no genere ningún error, especialmente aquellos que puedan interferir en la carga de tu página.

Ejemplo de una devolución de llamada de 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
Es la cantidad de anuncios que deben aparecer en esta unidad. El valor predeterminado es 2.

Ejemplo: 

'number' : 4
relatedSearches Opcional
Es la cantidad de búsquedas relacionadas que deberían aparecer en esta unidad. Si no se especifica, el valor predeterminado es 0.

Ejemplo: 

'relatedSearches' : 4