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. 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 página de resultados anterior. El parámetro |
pubId
|
Obligatorio Este es tu ID de cliente de AdSense. Tu 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", tu pubId es "test-property". Este es el protocolo estándar de CSA. Ejemplo: 'pubId' : 'test-property' |
query
|
Obligatorio, excepto en la Búsqueda relacionada en las páginas de contenido. Esta es la búsqueda que ingresó 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. 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 relacionada. Controla qué tipo de experiencia de la 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 las páginas de resultados de la búsqueda (Búsqueda relacionada en la Búsqueda). Si utilizas la búsqueda relacionada en cualquier otro tipo de página (p.ej., artículos y entradas de blog), debes configurar explícitamente el parámetro como "contenido". 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 personalizados. Ten en cuenta que, con el styleId establecido 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 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, 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.
Ejemplo: 'linkTarget' : '_blank' |
maxTermLength
|
Opcional Especifica la cantidad máxima de caracteres de un término de búsqueda relacionado, 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 mediante un clic en un anuncio o vínculo en otro sitio web, y ese anuncio o vínculo está bajo tu control, se debe establecer este parámetro tal como se indica 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 búsqueda relacionados que se mostrarán con una solicitud de búsqueda relacionada, aunque Google puede o no usar los términos que se proporcionan aquí.
Nota: Cuando usas 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 los términos sean relevantes contextualmente. Si el rastreador de AdSense aún no rastrea una página o su rastreo (p. ej., un archivo robots.txt) bloquea el rastreo, no mostraremos los términos sugeridos de la Búsqueda relacionada que proporciones a Google. El producto Búsqueda relacionada de 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ágina de contenido que contienen parámetros de búsqueda, 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 imprecisos o irrelevantes. Este parámetro de la 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 la carga de rastreo innecesaria. 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 corresponde). 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 ignorar: 'ignoredPageParams' : 'utm_medium,click_id,session_ref'Se 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 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 tiene cada valor en los anuncios mostrados:
De forma predeterminada, adsafe está configurado en alta. Ejemplo: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
Opcional Se utiliza el parámetro adtest 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 hace un seguimiento de los resultados de clics. Cuando el parámetro adtest tiene el valor on, usted no genera ningún ingreso. Use este parámetro cuando realice pruebas, pero no en sistemas de producción. De lo contrario, no se le pagará por los anuncios que muestre. 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 diferentes páginas. Usa el ID del canal único que creó en tu cuenta de AdSense o 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 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 a los que se segmentan sus anuncios. Si incluyes este parámetro en tu solicitud, Google mostrará únicamente anuncios que estén orientados a ese idioma, o bien 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 le informa a Google que deseas permitir anuncios que usen almacenamiento local y cookies solo para el tráfico no válido en el tráfico con y sin consentimiento.
De forma predeterminada, el IVT se establece como verdadero. Ejemplo: 'ivt': false |
Descripciones de los parámetros a nivel de unidad
Estos parámetros afectan la forma en que se presentan al usuario las unidades de anuncios individuales de una página. Cada parámetro se puede configurar de manera individual 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 se encuentra 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 se ajuste 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 Especifica el ancho en píxeles del anuncio o de 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 una función de JavaScript que se llamará cuando se carguen los anuncios o las búsquedas relacionadas, o bien cuando no se publiquen anuncios ni búsquedas relacionadas. El parámetro se debe establecer en una función de devolución de llamada de JavaScript que implementes y que permita realizar una acción cuando se complete la llamada del anuncio. La función de devolución de llamada incluye 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 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 deberían 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. El valor predeterminado es 0 si no se especifica. Ejemplo: 'relatedSearches' : 4 |