Guía de referencia de la API de Google Publisher Tag

Este artículo ofrece resúmenes del método y detalles del método para la API de etiquetas de editor de Google.

Resumen del método

A continuación, se incluyen resúmenes de los siguientes métodos: googletag, pubService, companionAdsService, contentService, adSlot, googletag.cmd.

Clase: googletag

Es el espacio de nombre global que la etiqueta Google Publisher Tag utiliza para su API.

  • cmd
    Se refiere a la cola de comando global para la ejecución asíncrona de las llamadas relacionadas con la etiqueta de GPT.

  • .clearCategoryExclusions
    Borra todas las exclusiones de anuncios del nivel de espacio para un espacio publicitario concreto.

  • companionAds()
    Devuelve una referencia al servicio de anuncios complementarios.

  • content()
    Devuelve una referencia al servicio de contenido.

  • defineOutOfPageSlot(unitName, divId)
    Crea un espacio publicitario fuera de la página (intersticial) con el nombre del bloque de anuncios determinado. divId es el ID del elemento DIV que contendrá el anuncio.

  • definePassback (unitName, size)
    Cuando se llama a este método en una etiqueta de anuncio de DFP que se ha proporcionado a un servidor de anuncios de terceros, ofrece como resultado la etiqueta a DFP cuando no se encuentra disponible ningún anuncio coincidente en el servidor de anuncios de terceros.

  • defineSlot(unitName, size, divId)
    Genera un espacio publicitario con el tamaño y el nombre del bloque de anuncios indicado. divId representa el ID del elemento DIV que contendrá este bloque de anuncios.

  • display(divId)
    Indica en qué parte de la página se debe mostrar el contenido del espacio publicitario.

  • enableServices()
    Habilita todos los servicios de Google Publisher Tag que se hayan asociado a los espacios publicitarios de la página.

  • pubads()
    Ofrece como resultado una referencia al servicio de anuncios del editor.

  • setCategoryExclusion()
    Establece una exclusión de categoría de anuncio para la etiqueta especificada.

  • setLocation()
    Transmite la información exacta de sitios web y aplicaciones móviles, de modo que pueda segmentar geográficamente las líneas de pedido a ubicaciones concretas.

Clase: pubService

API para configurar el servicio de anuncios de editor de DFP. El servicio de anuncios del editor es el servicio principal que se utiliza para solicitar anuncios desde Google.

  • addEventListener(eventType, listener)
    Este método registra un detector que le permite establecer una función de JavaScript y llamarla cuando ocurre un evento de GPT específico en la página.

  • collapseEmptyDivs()
    Crea un espacio publicitario con los parámetros asociados y lo asocia con el servicio del editor. Equivalente a defineSlot() seguido de addService(pubads). Tenga en cuenta que con este método, no podrá utilizar el modo de solicitud única.

  • enableAsyncRendering()
    Indica al servicio que debe buscar anuncios de forma asíncrona mediante marcos flotantes en el dominio del editor.

  • enableSingleRequest()
    Solicita el contenido de todos los espacios publicitarios en una sola solicitud.

  • enableSyncRendering()
    Indica al servicio que espere a que se completen las solicitudes de anuncios antes de continuar la visualización de la página.

  • enableVideoAds()
    Indica a GPT que la página contendrá anuncios de vídeo.

  • noFetch()
    Procesa el elemento JavaScript pero no hace ninguna llamada de HTTP para el contenido de espacios publicitarios.

  • refresh(slots)
    Actualiza la matriz especificada de los espacios de la página con anuncios nuevos (solo con el modo asíncrono).

  • set(key, value)
    Define valores para parámetros de AdSense que se aplican a todos los espacios publicitarios de pubService.

  • setTagForChildDirectedTreatment(options)
    Define el estado de la solicitud del anuncio dirigido a niños.

  • setTargeting(key, value)
    Establece valores para segmentar claves que se aplican a todos los espacios publicitarios de pubService.

  • setVideoContent(videoContentId, videoCmsId)
    Establece la información de contenido de vídeo que se enviará junto con las solicitudes de vídeo para la segmentación y la exclusión de contenido.

Clase: companionAdsService

API para configurar el servicio de anuncios complementarios de DFP.

  • enableSyncLoading()
    Permite que la implementación del servicio se cargue de forma síncrona.

  • setRefreshUnfilledSlots(value)
    Habilita o inhabilita la actualización automática de los espacios complementarios que no se han rellenado.

Clase: contentService

API para configurar el servicio de contenido de DFP. El servicio de contenido le permite controlar un espacio publicitario para que se muestren otros anuncios antes de que se solicite un anuncio complementario.

  • setContent(slot, content)
    Rellena un espacio con el contenido determinado. Si no se ha visualizado aún el espacio (o no tiene un DIV asociado), el contenido se almacena y se rellena el espacio cuando se crea el DIV.

Clase: adSlot

API para configurar un espacio publicitario específico en la página.

  • addService(service)
    Añade el espacio publicitario al servicio de etiqueta de Google especificado.

  • clearTargeting()
    Borra toda la segmentación del nivel de espacio para un espacio publicitario concreto.

  • set(key, value)
    Establece valores para los parámetros de AdSense en un espacio publicitario determinado.

  • setClickUrl(url)
    Establece la URL de redireccionamiento para un clic en un anuncio en un espacio determinado. Los servidores de DoubleClick registran un clic aunque se sustituya la URL de clic, pero se anula cualquier URL de página de destino asociada con la creatividad publicada.

  • setCollapseEmptyDiv(collapse, collapseBeforeAdFetch [optional])
    Define una anulación específica del espacio dirigida al comportamiento de contracción del elemento DIV que afecta a toda la página y que se indicó mediante el método pubService.collapseEmptyDivs().

  • setTargeting(key, value)
    Establece valores para segmentar claves en un espacio publicitario determinado.

Clase: googletag.cmd

API para poner en cola las llamadas de función de GPT para la ejecución cuando esté preparado.

  • push(JsFunction)
    JsFunction se pondrá en cola para su ejecución, en espera de la carga de gpt.js.

 

Detalles del método

Detalles del método para googletag

companionAds

googletag.companionAds()

Devuelve una referencia al servicio de anuncios complementarios.

  • Resultado:

    • companionAdsService: una referencia al servicio de anuncios complementarios.

content

googletag.content()

Devuelve una referencia al servicio de contenido.

  • Resultado:

    • contentService: una referencia al servicio de contenido.

clearCategoryExclusions

.clearCategoryExclusions()

Borra todas las exclusiones de anuncios del nivel de espacio para un espacio publicitario contrato. Esto puede resultarle útil para actualizar los espacios.

content

googletag.content()

Devuelve una referencia al servicio de contenido.

  • Resultado:

    • contentService: una referencia al servicio de contenido.

defineOutOfPageSlot

googletag.defineOutOfPageSlot(unitName, divId)

Genera un espacio publicitario fuera de la página (intersticial) con el nombre del bloque de anuncios determinado. divId representa el ID del elemento div que contendrá el anuncio.

  • Parámetros:

    • string unitName: ruta completa del bloque de anuncios con el código de red y el nombre del bloque.

    • string divId: ID especificado por el editor del elemento DIV que contiene el anuncio.

  • Resultado:

    • adSlot: el espacio publicitario creado recientemente.

  • Ejemplo:

    // Ad unit = "/networkCode/unitName"
    googletag.defineOutOfPageSlot("1234567/outofpage", "div-gpt-ad-1");

definePassb

googletag.pubads().definePassback(unitName, size)

Cuando se llama a este método en una etiqueta de anuncio de DFP que se ha proporcionado a un servidor de anuncios de terceros, ofrece como resultado la etiqueta a DFP cuando no se encuentra disponible ningún anuncio coincidente en el servidor de anuncios de terceros.

  • Parámetros:

    • string unitName: ruta completa del bloque de anuncios con el código de red y el nombre del bloque.

    • number size: la anchura y la altura del bloque de anuncios entre corchetes y separados por una coma.

  • Resultado:

    • passbackSlot: el espacio publicitario de transferencia recién creado.

defineSlot

googletag.defineSlot(unitName, size, div

Crea un espacio publicitario con el nombre y el tamaño de un bloque de anuncios determinado y lo asocia con el ID de un elemento DIV en la página que va a contener el anuncio.

  • Parámetros:

    • string unitName: ruta completa del bloque de anuncios con el código de red y el nombre del bloque.

    • number size: la anchura y la altura del bloque de anuncios entre corchetes y separados por una coma.

    • string divId: ID especificado por el editor del elemento DIV que contiene el anuncio.

  • Resultado:

    • adSlot: el espacio publicitario creado recientemente.
  • Ejemplo:

    // Bloque de anuncios = "/networkCode/unitName" (/coste de red/nombre de unidad); tamaño = [anchura, altura]
    googletag.defineSlot("/1234567/leaderboard", [728, 90], "div-1");

disablePublisherConsole

googletag.disablePublisherConsole()

Inhabilita la Consola para editores de Google.

display

googletag.display(divId)

Indica en qué parte de la página se debe mostrar el contenido del espacio publicitario. Cada espacio publicitario solo se debe mostrar una vez por página. Todos los espacios deben definirse y tener un servicio asociado a ellos antes de que se muestren. La llamada de visualización debe aparecer en un bloque de secuencias de comandos en el elemento DIV nombrado en la llamada de función (esta restricción es necesaria para que se admita sin problemas el modo de visualización de anuncios síncrono).

Tenga en cuenta que si se usa una arquitectura de solicitud única (SRA), se llamarán a todos los espacios publicitarios en una sola instancia de googletag.display(). Para obligar a que no se muestre un espacio publicitario, debe suprimirse el elemento div completo.

  • Parámetros:

    • string divId: ID del elemento DIV que contiene el espacio publicitario.

  • Ejemplo:

    <div id="div-gpt-ad-1" style="width: 728px; height: 90px">
    <script type="text/javascript">
      googletag.cmd.push(function() {googletag.display("div-gpt-ad-1")});
    </script>
    </div>

enableServices

googletag.enableServices()

Habilita todos los servicios de la etiqueta de editor de Google que se han definido para los espacios publicitarios en la página. Esto solo es necesario una vez por página, pero no pasa nada si se incluye varias veces.

pubads

googletag.pubads()

Devuelve una referencia al servicio de anuncios del editor.

  • Resultado:

    • pubService: una referencia al servicio de anuncios del editor.

setCategoryExclusion

googletag.pubads().setCategoryExclusion('labelName');

Establece una exclusión de categoría de anuncios para el nombre de etiqueta dado. Puede establecer exclusiones del nivel de página y el nivel de espacio. (Obtenga más información acerca de cómo configurar exclusiones de anuncios).

  • Parámetros:

    • labelName: el nombre de la etiqueta que se asocia a las líneas de pedido que desea excluir.

  • Ejemplos:

    Ejemplo de nivel de página:

    // Etiqueta = AirlineAd
    googletag.pubads().setCategoryExclusion('labelName');

    Ejemplo de nivel de espacio:
    googletag.defineSlot('/networkCode/firstLevelAdUnit/secondLevelAdUnit', [width, height], 'div-gpt-ad-divID')
        .setCategoryExclusion('labelName')
        .addService(googletag.pubads());

setLocation

googletag.pubads().setLocation(latitude, longitude, precision);

Transfiere información de ubicación de sitios web y aplicaciones móviles, de manera que pueda segmentar geográficamente líneas de pedido a ubicaciones específicas. DFP no utilizará los datos de ubicaciones a menos que se habilite esta función para su red. Para habilitar esta función, póngase en contacto con su administrador de cuentas.

  • Parámetros:

    • latitude: la latitud de la ubicación.
    • longitude: la longitud de la ubicación.
    • precision: la precisión de la ubicación, en mm.
    • postal code: el código postal de 5 dígitos (solo EE.UU).
  • Ejemplos:

    • Latitud/longitud:
      googletag.pubads().setLocation(34, -45.12);

    • Latitud, longitud y precisión en mm:
      googletag.pubads().setLocation(34, -45.12, 10000);

    • Código postal:
      googletag.pubads().setLocation("10001,US")

 

Detalles del método para pubService

addEventListener

pubService.addEventListener(eventType, listener)

Registra un detector que le permite establecer una función de JavaScript y llamar a esta función cuando ocurre un evento de GPT específico en la página.

  • Parámetros:

    • string eventType: una cadena que representa el tipo de evento que genera GPT. Actualmente, solo se admite el evento 'slotRenderEnded'. Los tipos de eventos distinguen entre mayúsculas y minúsculas.

    • function listener: función que toma un argumento de objeto de evento único. Los objetos de eventos son distintos según el evento.

  • Resultado:

    • this: el servicio en sí. Las llamadas pueden enlazarse de la siguiente manera:

      service.addEventListener(...).addEventListener(...)

  • Ejemplos:

    • Evento de finalización del procesamiento del espacio

      Este evento se activa cuando ha finalizado el procesamiento del espacio de una página.

      googletag.pubads().addEventListener('slotRenderEnded', function(event) {
       console.log('Creative with id: ' + event.creativeId +
        ' is rendered to slot of size: ' + event.size[0] + 'x' + event.size[1]);
      });

      Estructura del objeto de evento slotRenderEnded :

      event.slot: referencia del objeto del espacio.

      event.isEmpty: es un booleano, la respuesta será true si no se ha obtenido ningún anuncio del espacio o false en el caso contrario.

      event.size: es una matriz, indica el tamaño de la creatividad que se ha procesado. Por ejemplo: [728, 90]. En el caso de que el espacio esté vacío, el valor será null .

      event.creativeId: es un número, corresponde al ID de la creatividad que se ha procesado. El valor será null en el caso de espacios vacíos, anuncios de reabastecimiento o creatividades que haya procesado otro servicio que no sea DFP pubService.

      event.lineItemId: es un número, corresponde al ID de la línea de pedido del anuncio que se ha procesado. El valor será null en el caso de espacios vacíos, anuncios de reabastecimiento o creatividades que haya procesado otro servicio que no sea DFP pubService.

      Los detectores funcionan en el nivel de página, lo que significa que no puede añadir un detector solo para un espacio determinado. Puede aplicar un filtro a un detector para que solo responda a determinados bloques de anuncios mediante este patrón:

      var targetSlot = ...;
      googletag.pubads().addEventListener('slotRenderEnded', function(event) {
       if (event.slot === targetSlot) {
        // Slot specific logic
       }
      });

collapseEmptyDivs

pubService.collapseEmptyDivs()

Contrae los elementos DIV vacíos en una página cuando no hay ningún contenido de anuncio para mostrar. Se debe llamar antes de enableServices() para que tenga efecto.

disableInitialLoad

pubService.disableInitialLoad()

Inhabilita la búsqueda inicial de anuncios desde Google cuando se carga la página por primera vez (solo con el modo asíncrono). Se pueden seguir utilizando las llamadas a refresh() para buscar anuncios.

display

pubService.display(unitName, size, divId)

Crea un espacio publicitario con los parámetros asociados y lo asocia con el servicio del editor. Equivalente a defineSlot() seguido de addService(pubads). Tenga en cuenta que con este método, no podrá utilizar el modo de solicitud única.

  • Parámetros:
    • string unitName: la ruta completa del espacio publicitario con el código de red y el nombre del bloque.

    • string size: la anchura y la altura del bloque de anuncios entre corchetes y separados por una coma.

    • string divId: ID especificado por el editor del elemento DIV que contiene el anuncio.

  • Ejemplo:

    // Bloque de anuncios = "/networkCode/unitName" (/coste de red/nombre de unidad); tamaño = [anchura, altura]

    googletag.defineSlot("/1234567/leaderboard", [728, 90], "div-1");

enableAsyncRendering

pubService.enableAsyncRendering()

Redirecciona al servicio de anuncios del editor para que utilice el modo de visualización asíncrona. En la visualización asíncrona, las solicitudes de anuncios se realizan mediante iframes en el dominio del editor (iframes de uso sencillo) y la respuesta se escribe en otro iframe de uso sencillo. Dado que el servicio utiliza la visualización asíncrona de forma predeterminada, los editores solo necesitarían utilizar este método para anular una configuración anterior. Al igual que con la mayoría de las configuraciones del nivel de servicio, se debería llamar a este antes de habilitar el servicio.

enableSingleRequest

pubService.enableSingleRequest()

Dirige al servicio de anuncios del editor para que haga una solicitud única cuando busque contenido para varios espacios publicitarios. Se debe realizar esta llamada antes de habilitar el servicio.

enableSyncRendering

pubService.enableSyncRendering()

Dirige al servicio de anuncios del editor para que utilice el modo de visualización síncrona. En la visualización sincrónica, tanto las solicitudes de anuncios como la visualización de las respuestas se realizan directamente en la página del editor de un modo de bloqueo. Aunque esto puede aumentar la latencia de la página, hace que estén disponibles algunos tipos de creatividades de anuncios que no admiten bien el uso de iframes. Se debe realizar esta llamada antes de habilitar el servicio. La visualización síncrona también necesita que se busque el JavaScript de la etiqueta de editor de Google de forma síncrona.

enableVideoAds

pubService.enableVideoAds()

Indica a GPT que la página contendrá anuncios de vídeo. Esto posibilita la aplicación de límites de exclusión de competitividad a anuncios de vídeo y de display. Si se conoce el contenido de vídeo, llame al método setVideoContent con el objetivo de utilizar la exclusión de contenido para los anuncios de display.

noFetch

pubService.noFetch()

Procesa el elemento JavaScript pero no hace ninguna llamada de HTTP para el contenido de espacios publicitarios.

refresh

pubService.refresh(slots)

Actualiza la matriz especificada de los espacios de la página con anuncios nuevos (solo con el modo asíncrono).

Para que funcione correctamente en todos los navegadores, la llamada a la función refresh debe ser anterior a las llamadas para mostrar el espacio publicitario. Si la llamada a display se omite, refresh puede tener un comportamiento no esperado. Si lo desea, la función disableInitialLoad puede utilizarse para detener la obtención de anuncios por parte de display.

  • Parámetros:

    • array slots: la matriz de espacios opcional que se actualizará. Si no se indica el valor de este campo, se actualizarán todos los espacios publicitarios.

  • Ejemplo:

    // The calls to construct an ad and display contents
    var slot1 = googletag.pubads().display("/1234567/leaderboard", [728, 90], "div-1");
    var slot2 = googletag.pubads().display("/1234567/skyscraper", [160, 600], "div-2");

    // Esta llamada de actualización obtiene un nuevo anuncio para cada espacio.
    googletag.pubads().refresh([slot1, slot2]);

set

pubService.set(key, value)

Establece valores para los parámetros de AdSense que se aplican a todos los espacios publicitarios del servicio de anuncios del editor. Al llamarlo varias veces para la misma clave, se anularán los valores establecidos previamente para esa clave. Se deben establecer todos los valores antes de la primera invocación de visualización.

  • Parámetros:

    • string key: nombre clave del parámetro para el que se establece un valor.

    • string value: el valor de la clave. Los valores deben ser una cadena o una matriz de cadenas.

  • Ejemplo:

    googletag.pubads().set("adsense_background_color", "#FFFFFF");

  • Claves disponibles:

    Parámetro nuevo Parámetro heredado Ejemplo Valores permitidos
    adsense_channel_ids

    google_ad_channel

    271828183+314159265

    ID de canal de AdSense válidos, separados por el signo más (+)

    adsense_ad_types

    google_ad_type

    text_image

    text, image, text_image

    adsense_ad_format

    google_ad_format

    250x250_as

    468x60_as, 234x60_as, 125x125_as, 120x600_as, 160x600_as, 180x150_as, 120x240_as, 200x200_as, 250x250_as, 300x250_as, 336x280_as, 728x90_as

    adsense_background_color

    google_color_bg

    #000000

    colores hexadecimales

    adsense_border_color

    google_color_border

    #000000

    colores hexadecimales

    adsense_link_color

    google_color_link

    #000000

    colores hexadecimales

    adsense_text_color

    google_color_text

    #000000

    colores hexadecimales

    adsense_url_color

    google_color_url

    #000000

    colores hexadecimales

    adsense_ui_features

    google_ui_features

    rc:10

    rc:10 para esquinas muy redondeadas, rc:6 para esquinas ligeramente redondeadas rc:0 para esquinas cuadradas (predeterminado)

Esta configuración de AdSense se establece normalmente cuando se crean o modifican espacios publicitarios en la aplicación de DFP. Esta API permite al editor anular esta configuración del servidor según se solicite.

setTagForChildDirectedTreatment

pubService.setTagForChildDirectedTreatment(int options)

Establece el valor para indicar si la solicitud de anuncio está dirigida a niños o no.

  • Parámetros:

    • int options:

setTargeting

pubService.setTargeting(key, value)

Establece valores para segmentar claves que se aplican a todos los espacios publicitarios de pubService. Un administrador define estas claves en la aplicación DFP. Al invocar esta función más de una vez para la misma clave, se sobrescribirán los valores establecidos previamente para dicha clave. Se deben establecer todos los valores antes de realizar cualquier invocación de visualización.

  • Parámetros:

    • string key: nombre clave del parámetro para el que se establece un valor.

    • string value: el valor de la clave. Los valores deben ser una cadena o una matriz de cadenas.

  • Ejemplo:

    // Ejemplo con un solo valor para una clave
    googletag.pubads().setTargeting("interests", "sports");

    // Ejemplo con varios valores para una clave entre corchetes
    googletag.pubads().setTargeting("interests", ["sports","music","movies"]);

setVideoContent

pubService.setVideoContent(videoContentId, videoCmsId)

Establece la información de contenido de vídeo que se enviará junto con las solicitudes de vídeo para la segmentación y la exclusión de contenido. Para videoContentId y videoCmsId, utilice los valores que proporciona el servicio de ingestión de contenido de DFP.

 

Detalles del método para companionAdsService

enableSyncLoading

companionAdsService.enableSyncLoading(value)

Permite que la implementación del servicio se cargue de forma síncrona. Al igual que con la mayoría de las configuraciones del nivel de servicio, se debería llamar a este antes de habilitar el servicio.

setRefreshUnfilledSlots

companionAdsService.setRefreshUnfilledSlots(value)

Habilita o inhabilita la actualización automática de los espacios complementarios que no se han rellenado.

La asignación dinámica de complementarios de vídeo no funciona con las etiquetas de GPT utilizadas en el modo síncrono.
  • Parámetros:

    • boolean value: si es verdadero, se habilita la actualización automática de los espacios sin rellenar.

  • Ejemplo:

    googletag.companionAds().setRefreshUnfilledSlots(true);

 

Detalles del método para contentService

setContent

contentService.setContent(slot, content)

Rellena un espacio con el contenido determinado. Si no se ha procesado aún el espacio (o no tiene un elemento DIV asociado), el contenido se almacena y se rellena el espacio cuando se crea el DIV.

  • Parámetros:

    • slot: el espacio que se va a rellenar.

    • string: el contenido HTML para el espacio.

  • Ejemplo:

    var slot = googletag.defineSlot('/1234567/leaderboard', [728, 90], 'div-1');
    var content = '<a href="www.mydestinationsite.com"><img src="www.mysite.com/img.png"></img></a>';
    googletag.content().setContent(slot, content);

 

Detalles del método para adSlot

addService

adSlot.addService(service)

Añade el espacio publicitario al servicio de etiqueta de Google especificado.

  • Parámetros:

    • pubService service: referencia al servicio de etiquetas del editor.

  • Resultado:

    • adSlot: el espacio publicitario en el que se ha llamado a la función.

  • Ejemplo:

    adSlot.addService(googletag.pubads());

clearTargeting

adSlot.clearTargeting()

Borra toda la segmentación del nivel de espacio para un espacio publicitario concreto.

set

adSlot.set(key, value)

Establece valores para los parámetros de AdSense en un espacio publicitario determinado. Se sobrescribirán los valores establecidos en el nivel de servicio para esta clave. Consulte la tabla sobre set para obtener una lista de las claves y valores disponibles. Al invocar esta función más de una vez para la misma clave, se sobrescribirán los valores establecidos previamente para dicha clave. Se deben establecer todos los valores antes de realizar cualquier invocación de visualización.

  • Parámetros:

    • string key: nombre clave del parámetro para el que se establece un valor.

    • string value: el valor de la clave.

  • Ejemplo:

    // Configurar la orientación en un solo espacio publicitario
    var slot = googletag.defineSlot("/1234567/skyscraper", [160, 600]).addService(googletag.pubads());
    slot.set("adsense_background_color", "#FFFFFF");

setClickUrl

adSlot.setClickUrl(url)

Establece la URL de redireccionamiento para un clic en un anuncio en un espacio determinado. Los servidores de DoubleClick registran un clic aunque se sustituya la URL de clic, pero se anula cualquier URL de página de destino asociada con la creatividad publicada.

  • Parámetros:

    • string url: la URL de clic.

  • Ejemplo:

    googletag.defineSlot("/1234567/skyscraper", [160, 600])
      .setClickUrl("http://www.example.com")
      .addService(googletag.pubads());

setTargeting

adSlot.setTargeting(key, value)

Establece valores para segmentar claves y parámetros de espacio en un espacio publicitario determinado. Esta función anulará los valores establecidos en el nivel de servicio para esta clave. Un administrador define estas claves en la aplicación DFP. Al invocar esta función más de una vez para la misma clave, se sobrescribirán los valores establecidos previamente para dicha clave. Se deben establecer todos los valores antes de realizar cualquier invocación de visualización.

  • Parámetros:

    • string key: nombre clave del parámetro para el que se establece un valor.

    • string value: el valor de la clave. Los valores deben ser una cadena o una matriz de cadenas.

  • Ejemplo:

    var slot=googletag.defineSlot("/1234567/skyscraper", [160, 600]).addService(googletag.pubads());

    // Ejemplo con un solo valor para una clave
    slot.setTargeting("allow_expandable", "true");

    // Ejemplo con varios valores para una clave entre corchetes
    slot.setTargeting("interests", ["sports","music","movies"]);

 

setCollapseEmptyDiv

adSlot.setCollapseEmptyDiv(collapse, collapseBeforeAdFetch [optional])

Define una anulación específica del espacio dirigida al comportamiento de contracción del elemento div que afecta a toda la página y que se indicó mediante el método pubService.collapseEmptyDivs().

  • Parámetros:

    • boolean collapse: indica a la GPT que contraiga los elementos div vacíos tras determinar que no hay ningún anuncio apto para el espacio.
    • boolean collapseBeforeAdFetch: al transferir "true" en este parámetro opcional, los espacios publicitarios se contraerán de forma inmediata cuando se cargue la página. El espacio div solo se desplegará cuando se obtengan anuncios para él.
  • Ejemplo:

    googletag.defineSlot("/1234567/skyscraper", [160, 600])
    .setCollapseEmptyDiv(true, true)
    // El método anterior provocará la contracción del elemento div de este espacio
    // cuando se carga la página, antes de que se soliciten los anuncios.

    googletag.defineSlot("/1234567/skyscraper", [160, 600])
    .setCollapseEmptyDiv(true)
    // El método anterior provocará la contracción del elemento div de este espacio
    // Únicamente después de que la GPT detecte que no se encuentra disponible ningún anuncio para el espacio.

 

Detalles del método para googletag.cmd

push

googletag.cmd.push(aFunction)

La variable googletag.cmd se inicializa en un Array como parte de las etiquetas. Este proceso lo lleva a cabo el editor. cmd.push es la función estándar Array.push , que añade un elemento al final de la matriz. Cuando se carga el JavaScript de la etiqueta de editor de Google principal, mira en la matriz y ejecuta todas las funciones en orden. A continuación, la secuencia de comandos sustituye cmd con un objeto interno cuya función está definida para ejecutar inmediatamente el argumento de la función que se le ha transferido. Este mecanismo permite a GPT reducir la latencia percibida mediante la búsqueda del JavaScript inicial de forma asíncrona, mientras permite al navegador continuar con la visualización de la página. Si se busca el archivo de JS inicial de forma síncrona, la invocación a cmd.push con una definición de función es equivalente a la invocación a la función directamente.

  • Ejemplo:

    googletag.cmd.push(function() {
      googletag.defineSlot("/1234567/ca-pub-12345678912/skyscraper", [160, 600]).
           addService(googletag.pubads());
    });