Parámetros
Descripciones de parámetros a nivel de la página
Estos parámetros solo se deben especificar una vez por página. 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 a la anterior. El parámetro |
pubId
|
Obligatorio Este es tu ID de cliente de AdSense. Su pubId es la parte de su ID de cliente que aparece después de "partner-". Por ejemplo, si su ID de cliente es "partner-test-property", su pubId es "test-property". Este es un protocolo estándar para CSA. Ejemplo: 'pubId' : 'test-property' |
query
|
Obligatorio, excepto en la Búsqueda relacionada en las páginas de contenido. Esta es la búsqueda ingresada por el usuario. El valor del parámetro de consulta no debe estar codificado. Nota: El uso de este parámetro en la búsqueda relacionada en las páginas de contenido generará 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. Especifica 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. La herramienta 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úsquedas relacionadas. Controla qué tipo de experiencia de búsqueda relacionada se muestra, según el contexto de la página:
Nota:El parámetro de la 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 páginas de resultados de 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 entradas de blog), debes configurar explícitamente el parámetro como "content". Nota: Los siguientes lineamientos se aplican al uso de este parámetro:
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 para usar los estilos del anuncio de búsqueda personalizado. Ten en cuenta que, si se establece el styleId para una solicitud, los anuncios o las búsquedas relacionadas se renderizarán con el estilo y se ignorarán los parámetros de estilo heredados. Si no se especifica styleId en la solicitud, se renderizará un diseño predeterminado del sistema. Ejemplo: 'styleId': '1234567890' |
Opcional
| Parámetro | Descripción y ejemplos |
|---|---|
linkTarget
|
Opcional Especifica si, cuando se hace clic en un anuncio, se abre en la misma ventana o en una nueva. El valor predeterminado es "_top". Este parámetro también se puede utilizar a nivel de la unidad.
Ejemplo: 'linkTarget' : '_blank' |
maxTermLength
|
Opcional Especifica la cantidad máxima de caracteres de un término de búsqueda relacionada, incluidos los espacios. No hay un máximo si no se establece. Ejemplo: 'maxTermLength' : 50 |
referrerAdCreative
|
Opcional Si un usuario llega a tu página de contenido que contiene una unidad de búsqueda relacionada de contenido tras hacer clic en un anuncio o vínculo de otro sitio web, y ese anuncio o vínculo está bajo tu control, este parámetro debe establecerse textualmente en el texto de la creatividad de ese anuncio o vínculo. Los siguientes lineamientos se aplican al uso de este parámetro:
Nota: Este parámetro es obligatorio cuando se usa el parámetro Ejemplos: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam
|
Opcional Especifica el nombre del parámetro de URL para la búsqueda en la página de resultados. Si no se especifica, el valor predeterminado es “q”. Ejemplo: 'resultsPageQueryParam' : 'query' |
terms
|
Opcional Este parámetro te permite proporcionar una lista delimitada por comas de tus propios términos de la búsqueda relacionada para mostrarlos en una solicitud de búsqueda relacionada, aunque Google puede o no usar los términos proporcionados aquí.
Nota: Cuando se usa este parámetro, Ejemplos: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
Opcional Especifica la lista de parámetros de URL para una página de contenido con una unidad de búsqueda relacionada de contenido que se puede ignorar de forma segura sin afectar el contenido principal ni la experiencia del usuario. Nota: Antes de que los términos de búsqueda relacionados puedan aparecer en tu sitio, Google debe rastrear tus páginas para asegurarse de que sean relevantes según el contexto. Si el rastreador de AdSense aún no rastreó una página o bloquea su rastreo (p. ej., mediante un archivo robots.txt), no mostraremos a Google los términos de búsqueda relacionada sugeridos que proporcione. El producto Búsqueda relacionada en 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 páginas de contenido que incluyan parámetros de búsqueda, como variables de seguimiento, IDs de usuario, IDs de sesión y otros identificadores dinámicos, 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 imprecisos o irrelevantes. Este parámetro de página le indica al rastreador de Google que ignore estos parámetros no esenciales para garantizar una indexación adecuada del contenido y reducir las cargas de rastreo innecesarias. Esto permite que Google reconozca mejor una página como ya se rastreó y comience a mostrar los términos sugeridos (tanto de Google como del socio, si reúne los requisitos). Los siguientes lineamientos se aplican al uso de este parámetro:
Ejemplos:
http://example.com/content?utm_medium=social&page_id=123&click_id=456Proporcionar los siguientes parámetros de URL que se pueden omitir: 'ignoredPageParams' : 'utm_medium,click_id,session_ref'Se considerarí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 Especifica las reglas de filtrado 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:
De forma predeterminada, adSafe está configurado en alto. Ejemplo: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
Opcional El parámetro adtest se utiliza 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 cuenta las impresiones de anuncios ni realiza un seguimiento de los resultados de clics. Cuando el parámetro adtest tiene el valor on, no se generan ingresos. Las solicitudes de anuncios con el parámetro adtest establecido en on que provienen de un dominio que no se aprobó en la pestaña Sitios mostrarán anuncios que tengan una superposición de "anuncio de prueba" y no se pueda hacer clic en ellos. Usa este parámetro cuando realices pruebas, pero no en sistemas de producción. De lo contrario, 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 a fin de realizar un seguimiento del rendimiento de las diferentes páginas. Usa el ID del canal único creado en tu cuenta de AdSense o por tu administrador técnico de cuentas. Obtén más información sobre los canales aquí. Si hay 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 orientar 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 para los que se segmentan sus anuncios. Si incluye este parámetro en su solicitud, Google solo mostrará anuncios orientados a ese idioma o a todos los idiomas, pero no garantizará que el texto del anuncio esté en el idioma especificado. En 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 El valor predeterminado de
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Opcional El parámetro El valor predeterminado de
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
Opcional Este parámetro te permite proporcionar un valor booleano que informe a Google que deseas permitir anuncios que usen cookies solo para el tráfico no válido y almacenamiento local en el tráfico con consentimiento y sin consentimiento.
De forma predeterminada, el IVT se establece como verdadero. Ejemplo: 'ivt': false |
Descripciones de parámetros a nivel de la unidad
Estos parámetros afectan la forma en que se presentan las unidades de anuncios individuales en una página al usuario. Cada parámetro se puede configurar individualmente para cada unidad de anuncios.
Obligatorio
| Parámetro | Descripción y ejemplos |
|---|---|
container
|
Obligatorio Es el ID del contenedor de anuncios vacío <div> en el que debería 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 superior. Nota: Este parámetro se utiliza en lugar del parámetro "number". Esta unidad de anuncios debe ser lo suficientemente ancha para que no deba ajustarse la primera línea de los anuncios. Usar el parámetro maxTop en cualquier otra posición de la página constituye un incumplimiento de política. Ejemplo: 'maxTop' : 4 |
width
|
Obligatorio Especifica 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 Especifica la función de JavaScript que se llamará cuando se carguen los anuncios o búsquedas relacionadas, o cuando no se publiquen anuncios ni búsquedas relacionadas. El parámetro debe establecerse como una función de devolución de llamada de JavaScript que implementes, la cual permita que se realice una acción cuando se complete la llamada del anuncio. La función de devolución de llamada adopta los siguientes parámetros:
Nota: Prueba la función de devolución de llamada para asegurarte de que no genere ningún error, especialmente aquellos que puedan interferir con la carga de la 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 Indica la cantidad de anuncios que deberían aparecer en este bloque. El valor predeterminado es 2. Ejemplo: 'number' : 4 |
||||||||
relatedSearches
|
Opcional Es la cantidad de búsquedas relacionadas que deberían aparecer en esta unidad. El valor predeterminado es 0 si no se especifica. Ejemplo: 'relatedSearches' : 4 |