Preguntas frecuentes sobre el SDK de anuncios multimedia interactivos de Google


¿Por qué no recibo anuncios para todos los formatos?
Las etiquetas de anuncios de prueba se configuran para que siempre muestren anuncios de solicitudes válidas. Esto tiene como objetivo facilitar la integración y facilitar la prueba de cómo el reproductor solicita y dibuja anuncios. Sin embargo, no siempre están disponibles en todos los formatos para el sitio, la cuenta o el bloque de anuncios. Si tu integración funciona correctamente para la etiqueta de prueba, pero no para tu propia etiqueta, la causa puede ser una de las siguientes:
  • Estás publicando videos en un formato no admitido en tu entorno. Por ejemplo, solo publicas anuncios HTML5 en iOS o Android.
  • Si usa Ad Manager, es posible que su ID de publicador no tenga anuncios orientados en este momento. Además, asegúrese de haber aprobado los anuncios y las creatividades relevantes en Ad Manager.
  • Si usa AdSense, es posible que los criterios de segmentación de su sitio o página de prueba no incluyan ningún anuncio activo. La causa más común es el uso de sitios web privados que no se rastrean.
  • Si usa la Administración de socios de red de Ad Exchange y descriptionURL no está establecido o no está en la lista de administración de dominios administrados o de su propiedad, no se publicarán anuncios en esto.
  • Verifique los límites de minCPM definidos en video de Ad Exchange. Un CPM bastante alto puede generar tasas de relleno muy bajas. Para corregirlo, pruebe quitar el CPM mínimo o quitar el parámetro del bloque de anuncios de la solicitud de anuncio (es decir, el nombre del espacio publicitario) a fin de verificar si esto afecta la tasa de relleno.
¿Cómo se ve un buen descriptionUrl?
Para ser más efectivo, el contenido de la página al que descriptionUrl apunta no debe ser una colección de palabras o frases, sino de 1 a 3 párrafos que en realidad describan el contenido y tu función en este proceso. Un método que resultó ser exitoso es unir el contenido de la página descriptionUrl de forma dinámica a partir de bloques predefinidos. Por ejemplo, algunas oraciones sobre el contenido, algunas sobre la oferta de tu sitio y, luego, algunos fragmentos predefinidos asociados con cada canal de AdSense (como "Entretenimiento" o "Deportes"). Como resultado, cada elemento de contenido tiene un descriptionUrl razonablemente distinto asociado que proporciona información general (como descriptores de género) y información específica (contenido sobre el contenido directamente).

Este HTML de metadatos debe ser simple, por ejemplo:

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
  
¿Por qué recibo el error "La respuesta del anuncio no contiene un tipo de anuncio válido"?
Por lo general, este error aparece porque no se orientó ningún anuncio a la publisherId específica (durante el período determinado). Esta condición puede variar a lo largo del día o durante varios días, a medida que las campañas comienzan y terminan. Debe comprobar que el anuncio al que desea orientar su anuncio no haya vencido y que los criterios de orientación del anuncio sean correctos. Siempre que los anuncios se soliciten, reciban y rendericen de forma correcta mediante el publisherId de prueba, puedes asegurarte de que estos anuncios se administren correctamente mediante el publisherId publicado cuando estén disponibles.
¿Tiene una etiqueta de anuncio de video de Ad Manager que pueda usar para pruebas?
Las etiquetas de muestra están disponibles en la página Etiquetas de muestra.
¿Debería configurar adSlotWidth y adSlotHeight con los mismos valores que sz en mi etiqueta de anuncio de Ad Manager?
No necesariamente. adSlotWidth y adSlotHeight deben configurarse en el ancho o el alto del reproductor o área en la que quieres que se completen los anuncios. AdSense los utiliza para determinar qué anuncios están disponibles para adaptarse a ese espacio. El par clave-valor sz en su etiqueta de anuncio de Ad Manager es un parámetro de orientación y no afecta necesariamente a la creatividad publicada (obtenga más información a continuación).
La etiqueta de anuncio de demostración se ve bien, pero cuando la cambio con la etiqueta de anuncio, no aparece ningún anuncio.
Asegúrese de que algo se dirija a la etiqueta de anuncio que solicita. La manera más fácil de averiguarlo es observar el tráfico HTTP. Si se muestra una imagen 1x1 pixel grey.gif dentro de un bloque de anclaje HTML, debes verificar tu orientación en Ad Manager.
Quiero solicitar anuncios con la misma etiqueta más de una vez, pero solo recibo anuncios en mi primera solicitud. ¿Cómo puedo solucionarlo?
Si solicitas anuncios más de una vez, debes indicarle al servidor de anuncios que se trata de solicitudes legítimas y no de duplicados accidentales. El SDK lo hace por ti con dos llamadas a la API rápidas:
  1. Llama a destroy() en tu instancia de AdsManager. De esta manera, se evita que los anuncios al final del video se reproduzcan cuando realices la siguiente llamada a contentComplete(). Recibirás una AdsManager nueva cuando realices tu próxima solicitud.
  2. Llama a contentComplete() en tu instancia de AdsLoader. Esto restablece el SDK, de modo que la nueva solicitud de anuncio no parezca un duplicado de la anterior.
Después de realizar las dos llamadas anteriores, puedes llamar a requestAds() en tu instancia de AdsLoader a fin de obtener otro conjunto de anuncios para que se reproduzca en tu nuevo video.
¿Cómo solicito anuncios de superposición de AdSense y espacios publicitarios completos mediante el SDK de IMA?

Para solicitar anuncios de AdSense con el SDK, primero debes obtener una etiqueta de anuncio de AdSense. Puedes obtener más información en la página de AdSense para video. Una vez que tenga la etiqueta, deberá seguir estos pasos para crear una superposición o una solicitud de anuncio que ocupe todo el espacio publicitario:

Anuncios superpuestos
  1. En tu AdsRequest, establece ViewViews en NORMAL.
  2. En su etiqueta de anuncio, agregue el parámetro overlay=1.
Anuncios que ocupan todo el espacio publicitario
  1. En tu AdsRequest, establece ViewViews en FULLSCREEN.
  2. En su etiqueta de anuncio, agregue el parámetro overlay=0.
Recibo un error que indica que la URL de clic no es válida cuando hago clic en mi anuncio. ¿Cuál podría ser la causa?
La causa más común para este error es que la URL de clic no tenga un formato de escape. Si ve este error, asegúrese de que la URL de clic tenga el formato de escape correcto en su respuesta de VAST.
¿Por qué veo el error "Documento vacío de VAST"?
Este error se produce cuando la etiqueta de anuncio muestra un documento de VAST vacío, lo que indica que el anuncio no se publicó correctamente. Comuníquese con su administrador de cuentas o representante del servidor de anuncios para averiguar por qué no funciona la etiqueta de su anuncio.
¿Puedo cambiar el tamaño o el texto del cuadro Omitir anuncio o de otros elementos de la IU?
Los SDK de IMA no permiten cambiar el diseño, el tamaño ni el contenido de los elementos de la IU. Para obtener más detalles sobre los elementos de la IU, consulta AdsManager.uiElements.
¿Los controles de video nativos son compatibles con el SDK de HTML5?
No, el SDK de HTML5 no admite controles nativos.
Veo "No se pudo ejecutar 'play' en 'HTMLMediaElement': la API solo puede ser iniciada por un gesto del usuario" en mi implementación de HTML5. ¿Cómo puedo solucionarlo?
En los dispositivos móviles, debes llamar a adDisplayContainer.initialize() como resultado de una acción del usuario (como presionar una vez). Si ves este error, lo más probable es que lo llames en un contexto que no haya iniciado el usuario. Ten en cuenta que debe ser el resultado directo de una acción del usuario. Por ejemplo, si respondes a un evento de "presionar" reproduciendo un video y, luego, usas el evento de reproducción del reproductor de video para llamar a initialize(), el SDK mostrará este error. Debes llamar a initialize() como resultado del evento de toque en sí.
¿Cómo gestiono el enfoque del teclado en los clics en los anuncios?
Si usas controles del teclado para el reproductor, es posible que notes que ya no funcionarán después de hacer clic en adDisplayContainer. Esto se debe a que, una vez que se hace clic en un anuncio, el enfoque del teclado cambia al iframe de IMA. Para mantener el enfoque del teclado en el reproductor de contenido, usa el evento CLICK para volver a transferir el enfoque del teclado al contenedor deseado. Consulta el siguiente fragmento de código para obtener más información:
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });