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 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 un protocolo estándar de CSA. Ejemplo: 'pubId' : 'test-property' |
query
|
Obligatorio, excepto en las páginas de Búsqueda relacionada en contenido Es la búsqueda que ingresó el usuario. El valor del parámetro de búsqueda 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. 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. El parámetro resultsPageBaseUrl puede incluir sus propios parámetros, excepto el de 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 Búsqueda relacionada se muestra, según el contexto de la página:
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 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 o publicaciones de blog), debes establecer el parámetro de forma explícita 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 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 diseño 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.
Ejemplo: 'linkTarget' : '_blank' |
referrerAdCreative
|
Opcional Si un usuario accede 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:
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 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 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 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 relacionada puedan aparecer en tu sitio, Google debe rastrear tus páginas para asegurarse de que los términos sean pertinentes en función del contexto. Cuando el rastreador de AdSense aún no haya rastreado una página o se le impida hacerlo (p. ej., con un archivo robots.txt), no mostraremos los términos de la Búsqueda relacionada sugeridos que proporciones a Google. 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 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 irrelevantes o inexactos. 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 innecesaria del rastreo. Esto permite que Google reconozca mejor que ya se rastreó una página 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:
Ejemplos:
http://example.com/content?utm_medium=social&page_id=123&click_id=456 'ignoredPageParams' : 'utm_medium,click_id,session_ref' 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 los parámetros de configuración válidos para adsafe y el efecto que cada valor tiene en los anuncios devueltos:
De forma predeterminada, adsafe se establece en high. 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 registra las impresiones de anuncios ni realiza un seguimiento de los resultados de 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 provenientes de un dominio que no se aprobó 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 del parámetro adtest es off. 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. Utiliza el ID de canal único que creaste en tu cuenta de AdSense o que te proporcionó tu administrador de cuentas técnicas. 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 o las búsquedas relacionadas solicitados. 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 solo devolverá los anuncios segmentados para ese idioma o para todos los idiomas, pero no garantizará que el texto del anuncio esté en el idioma especificado. En general, deberías 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 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.
De forma predeterminada, IVT se establece en verdadero. Ejemplo: 'ivt': false |
Descripciones de los parámetros a nivel del bloque
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 bloque 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 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 Especifica el ancho del anuncio o de la unidad de búsquedas relacionadas en píxeles. 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 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 usa 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 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 este valor es inferior a 3, no se mostrarán búsquedas relacionadas. Ejemplo: 'relatedSearches' : 4 |