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. 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", tu 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 debe ser sin codificación. Nota: Usar este parámetro en la Búsqueda relacionada en las páginas de contenido provocará 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 consulta de búsqueda es término de búsqueda relacionada en el que hizo clic el usuario. La herramienta resultsPageBaseUrl puede incluir su propia 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 Se muestra la experiencia de la Búsqueda relacionada, según el contexto de la página:
Nota:El parámetro de la página relatedSearchTargeting se establece automáticamente en "consulta" de forma predeterminada. Sin embargo, es fundamental tener en cuenta que este valor predeterminado es Están diseñados solo para páginas de resultados de búsqueda (Búsqueda relacionada en la Búsqueda). Si eres usando la búsqueda relacionada en cualquier otro tipo de página (p.ej., artículos o entradas de blog), debes configura 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 con styleId establecido para una solicitud, Los anuncios o las búsquedas relacionadas se renderizarán con el estilo, y los parámetros de estilo heredados se ignoradas. 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, al hacer clic en un anuncio, se abre en la misma ventana o en una en la ventana modal. 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 incluye una unidad de búsqueda relacionada para contenido al hacer clic en un anuncio o vínculo en otro sitio web, y ese anuncio o vínculo está bajo tu control este parámetro se debe establecer 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
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 de búsqueda. 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 para mostrarse con una solicitud de búsqueda relacionada, aunque Google puede o no utilizar el con las condiciones correspondientes.
Nota: Cuando usas este parámetro, también se agrega Ejemplos: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
Opcional Especifica la lista de parámetros de URL para una página de contenido con una búsqueda relacionada de contenido que se pueden ignorar de forma segura sin afectar el contenido central 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 asegurarte de que los términos sean relevantes según el contexto. Cuando una página aún no ha sido rastreado o se le bloquee el rastreo (p. ej., por un archivo robots.txt) rastreador de AdSense, no se mostrarán los términos sugeridos de la Búsqueda relacionada que proporciones a Google. La Búsqueda relacionada en el producto de contenido se basa en el sistema de rastreo de contenido de Google para indexar páginas y genera términos de búsqueda relevantes. Las URL de la página de contenido que contienen parámetros de consulta como ya que las variables de seguimiento, los ID de usuario, los ID de sesión u otros identificadores dinámicos pueden interferir la capacidad del rastreador para evaluar el contenido principal de la página y puede generar errores términos de búsqueda relacionados irrelevantes. El parámetro de esta página le indica al rastreador de Google que ignore estos parámetros no esenciales, lo que garantiza una indexación adecuada del contenido y reduce los rastreos innecesarios de carga de trabajo. Esto permite que Google reconozca mejor una página como si ya se rastreó y empiece Muestre los términos sugeridos (de Google y 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=456Proporciona 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 como: 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 un "anuncio de prueba" se superponen y no se puede 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 para realizar un seguimiento del rendimiento de 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 se incluyen varios canales, estos se deben separar con el 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 los anuncios que utilizan una cookie solo para tráfico no válido. el 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 "número" parámetro. Esta unidad de anuncios debe ser lo suficientemente ancha para que no deba ajustarse la primera línea de los anuncios. Cómo usar el comando maxTop parámetro en cualquier otra posición de la página es 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 la función de JavaScript a la que se llamará cuando los anuncios o las búsquedas relacionadas tengan cargar o cuando no se publican anuncios ni búsquedas relacionadas. El parámetro se debe establecer en una Función de devolución de llamada de JavaScript que implementas y permite que se realice una acción cuando la llamada del anuncio finalice. 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 errores. 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 deben 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 |