En esta guía, se muestra cómo usar el SDK de PAL para HTML5 a fin de generar un nonce para solicitas anuncios que se pueden omitir, renderiza el botón Omitir según Requisitos de Google Ads, y envíe los eventos de seguimiento asociados.
Requisitos previos
- Una app que implementa el SDK de PAL para HTML5 para realizar una solicitud de nonce. Para ver más consulta la Guía de introducción de PAL HTML5.
- Un reproductor de video compatible VAST 3 o superior.
- Sigue los pasos que se indican en Google Ad Manager para configurar tu red para publicar anuncios. anuncios de video que se pueden omitir para su solicitudes de anuncios.
Cómo generar un nonce para solicitar anuncios que se pueden omitir
Establece el valor de skippablesSupported en true en NonceRequest. Si
no está establecida, la compatibilidad predeterminada con anuncios que se pueden omitir es false. Esta solicitud
Genera valores de nonce que son obligatorios para los anuncios que se pueden omitir. Consulta lo siguiente
código para ver un ejemplo de cómo configurar este valor en la solicitud del nonce:
/**
* Generates a nonce with sample arguments and logs it to the console.
*/
function generateNonce() {
const request = new goog.pal.NonceRequest();
request.skippablesSupported = true;
...
Requisitos del botón Omitir
Para los anuncios que se pueden omitir, renderiza el botón Omitir con el siguiente diseño y los requisitos de cumplimiento. El incumplimiento de estos requisitos puede generar restricciones colocarse en los anuncios de Google que se publican en su sitio o aplicación.
Temporiz. de cuenta regresiva
El anuncio no debe poder omitirse hasta el tiempo skipoffset especificado en la VAST.
Durante este período que no se puede omitir, se debe mostrar al usuario un aviso en el que se le informe
que el anuncio se puede omitir en X segundos. El aviso debe traducirse a
el idioma del usuario.
Posicionamiento de los botones
Para un idioma que se escribe de izquierda a derecha, coloca el botón Omitir en la parte inferior derecha de el reproductor de video. Si se trata de un idioma que se escribe de derecha a izquierda, coloca el botón Omitir en el en la parte inferior izquierda del reproductor de video.
Tamaño de los botones
El botón y el texto deben ser lo suficientemente grandes para poder leerlos en un espacio de visualización pasiva una experiencia fluida a los desarrolladores.
Ícono y texto
El botón Omitir debe tener tanto texto como iconografía. Puedes usar la omitir el siguiente ícono de material como tu iconografía.
Accesibilidad
El usuario debe poder navegar al botón Omitir con un teclado con un control remoto. Una vez finalizada la cuenta regresiva, la app debería enfocar el botón de omisión.
Internacionalización
El texto de omisión debe estar traducido al idioma del usuario.
Grupos de anuncios
Si el anuncio está en un grupo de anuncios, el puede omitir todo el grupo o pasar al siguiente anuncio del grupo.
"Omitir anuncio" traducciones
Use este JSON para traducir su anuncio "Omitir anuncio" texto basado en la configuración regional del usuario.
"Omitir anuncio" traducciones
{ "skipAdTranslations": [ { "languageCode": "am", "language": "Amharic", "translatedText": "ማስታወቂያ ዝለል" }, { "languageCode": "ar", "language": "Arabic", "translatedText": "تخطي الإعلان" }, { "languageCode": "ar-EG", "language": "Arabic (Egypt)", "translatedText": "تخطي الإعلان" }, { "languageCode": "ar-JO", "language": "Arabic (Jordan)", "translatedText": "تخطي الإعلان" }, { "languageCode": "ar-MA", "language": "Arabic (Morocco)", "translatedText": "تخطي الإعلان" }, { "languageCode": "bg", "language": "Bulgarian", "translatedText": "Пропускане на рекламата" }, { "languageCode": "bs", "language": "Bosnian", "translatedText": "Preskoči oglas" }, { "languageCode": "ca", "language": "Catalan", "translatedText": "Omet l'anunci" }, { "languageCode": "cs", "language": "Czech", "translatedText": "Přeskočit reklamu" }, { "languageCode": "da", "language": "Danish", "translatedText": "Spring annoncen over" }, { "languageCode": "de", "language": "German", "translatedText": "Überspringen" }, { "languageCode": "de-AT", "language": "German (Austria)", "translatedText": "Überspringen" }, { "languageCode": "de-CH", "language": "German (Switzerland)", "translatedText": "Überspringen" }, { "languageCode": "el", "language": "Greek", "translatedText": "Παράλειψη διαφήμισης" }, { "languageCode": "en", "language": "English", "translatedText": "Skip Ad" }, { "languageCode": "en-AU", "language": "English (Australia)", "translatedText": "Skip Ad" }, { "languageCode": "en-CA", "language": "English (Canada)", "translatedText": "Skip Ad" }, { "languageCode": "en-GB", "language": "English (United Kingdom)", "translatedText": "Skip Ad" }, { "languageCode": "en-IE", "language": "English (Ireland)", "translatedText": "Skip Ad" }, { "languageCode": "en-IN", "language": "English (India)", "translatedText": "Skip Ad" }, { "languageCode": "en-NZ", "language": "English (New Zealand)", "translatedText": "Skip Ad" }, { "languageCode": "en-SG", "language": "English (Singapore)", "translatedText": "Skip Ad" }, { "languageCode": "en-ZA", "language": "English (South Africa)", "translatedText": "Skip Ad" }, { "languageCode": "es", "language": "Spanish", "translatedText": "Saltar anuncio" }, { "languageCode": "es-419", "language": "Spanish (Latin America)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-AR", "language": "Spanish (Argentina)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-BO", "language": "Spanish (Bolivia)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-CL", "language": "Spanish (Chile)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-CO", "language": "Spanish (Colombia)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-CR", "language": "Spanish (Costa Rica)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-DO", "language": "Spanish (Dominican Republic)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-EC", "language": "Spanish (Ecuador)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-GT", "language": "Spanish (Guatemala)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-HN", "language": "Spanish (Honduras)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-MX", "language": "Spanish (Mexico)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-NI", "language": "Spanish (Nicaragua)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-PA", "language": "Spanish (Panama)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-PE", "language": "Spanish (Peru)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-PR", "language": "Spanish (Puerto Rico)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-PY", "language": "Spanish (Paraguay)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-SV", "language": "Spanish (El Salvador)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-US", "language": "Spanish (United States)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-UY", "language": "Spanish (Uruguay)", "translatedText": "Omitir anuncio" }, { "languageCode": "es-VE", "language": "Spanish (Venezuela)", "translatedText": "Omitir anuncio" }, { "languageCode": "et", "language": "Estonian", "translatedText": "Jäta reklaam vahele" }, { "languageCode": "eu", "language": "Basque", "translatedText": "Saltatu iragarkia" }, { "languageCode": "fa", "language": "Farsi", "translatedText": "رد شدن از آگهی" }, { "languageCode": "fi", "language": "Finnish", "translatedText": "Ohita mainos" }, { "languageCode": "fil", "language": "Filipino", "translatedText": "Laktawan ang Ad" }, { "languageCode": "fr", "language": "French", "translatedText": "Ignorer l'annonce" }, { "languageCode": "fr-CA", "language": "French (Canada)", "translatedText": "Ignorer l'annonce" }, { "languageCode": "fr-CH", "language": "French (Switzerland)", "translatedText": "Ignorer l'annonce" }, { "languageCode": "gl", "language": "Galician", "translatedText": "Saltar anuncio" }, { "languageCode": "gu", "language": "Gujarati", "translatedText": "જાહેરાત છોડો" }, { "languageCode": "he", "language": "Hebrew", "translatedText": "דילוג על המודעה" }, { "languageCode": "hr", "language": "Croatian", "translatedText": "Preskoči oglas" }, { "languageCode": "hu", "language": "Hungarian", "translatedText": "A hirdetés kihagyása" }, { "languageCode": "id", "language": "Indonesian", "translatedText": "Lewati Iklan" }, { "languageCode": "is", "language": "Icelandic", "translatedText": "Sleppa auglýsingu" }, { "languageCode": "it", "language": "Italian", "translatedText": "Salta annuncio" }, { "languageCode": "iw", "language": "Hebrew", "translatedText": "דילוג על המודעה" }, { "languageCode": "jp", "language": "Japanese", "translatedText": "広告をスキップ" }, { "languageCode": "ko", "language": "Korean", "translatedText": "광고 건너뛰기" }, { "languageCode": "ln", "language": "Lingala", "translatedText": "Ignorer l'annonce" }, { "languageCode": "lo", "language": "Lao", "translatedText": "ຂ້າມໂຄສະນາ" }, { "languageCode": "lt", "language": "Lithuanian", "translatedText": "Praleisti skelbimą" }, { "languageCode": "lv", "language": "Latvian", "translatedText": "Izlaist reklāmu" }, { "languageCode": "ml", "language": "Malayalam", "translatedText": "പരസ്യം ഒഴിവാക്കുക" }, { "languageCode": "mo", "language": "Romanian", "translatedText": "Închide anunțul" }, { "languageCode": "mr", "language": "Marathi", "translatedText": "जाहिरात वगळा" }, { "languageCode": "ms", "language": "Malay", "translatedText": "Langkau Iklan" }, { "languageCode": "nb", "language": "Norwegian", "translatedText": "Hopp over annonsen" }, { "languageCode": "nl", "language": "Dutch", "translatedText": "Advertentie overslaan" }, { "languageCode": "no", "language": "Norwegian", "translatedText": "Hopp over annonsen" }, { "languageCode": "pa", "language": "Punjabi", "translatedText": "ਵਿਗਿਆਪਨ ਛੱਡੋ" }, { "languageCode": "pl", "language": "Polish", "translatedText": "Pomiń reklamę" }, { "languageCode": "pt", "language": "Portuguese", "translatedText": "Pular anúncio" }, { "languageCode": "pt-BR", "language": "Portuguese (Brazil)", "translatedText": "Pular anúncio" }, { "languageCode": "pt-PT", "language": "Portuguese (Portugal)", "translatedText": "Pular anúncio" }, { "languageCode": "ro", "language": "Romanian", "translatedText": "Închide anunțul" }, { "languageCode": "ru", "language": "Russian", "translatedText": "Пропустить рекламу" }, { "languageCode": "sk", "language": "Slovak", "translatedText": "Preskočiť reklamu" }, { "languageCode": "sl", "language": "Slovenian", "translatedText": "Preskoči oglas" }, { "languageCode": "sr", "language": "Serbian", "translatedText": "Прескочи оглас" }, { "languageCode": "sv", "language": "Swedish", "translatedText": "Hoppa över annons" }, { "languageCode": "sw", "language": "Swahili", "translatedText": "Ruka Tangazo" }, { "languageCode": "ta", "language": "Tamil", "translatedText": "விளம்பரத்தைத் தவிர்" }, { "languageCode": "te", "language": "Telugu", "translatedText": "ప్రకటనను దాటవేయి" }, { "languageCode": "th", "language": "Thai", "translatedText": "ข้ามโฆษณา" }, { "languageCode": "tl", "language": "Tagalog", "translatedText": "Laktawan ang Ad" }, { "languageCode": "tr", "language": "Turkish", "translatedText": "Reklamı atla" }, { "languageCode": "uk", "language": "Ukrainian", "translatedText": "Пропустити оголошення" }, { "languageCode": "ur", "language": "Urdu", "translatedText": "اشتہار نظر انداز کریں" }, { "languageCode": "vi", "language": "Vietnamese", "translatedText": "Bỏ qua quảng cáo" }, { "languageCode": "zh", "language": "Chinese", "translatedText": "跳过广告" }, { "languageCode": "zh-CN", "language": "Chinese (China mainland)", "translatedText": "跳过广告" }, { "languageCode": "zh-HK", "language": "Chinese (Hong Kong)", "translatedText": "略過廣告" }, { "languageCode": "zh-TW", "language": "Chinese (Taiwan)", "translatedText": "略過廣告" }, { "languageCode": "zu", "language": "Zulu", "translatedText": "Yeqa Isikhangiso" } ] }
Envía el evento de omisión de anuncio
Llama al
NonceManager.sendAdTouch()
para notificar a los servidores de anuncios de Google cuando el usuario hace clic en el botón Omitir.
Incluye esta llamada en la función que controla la omisión del anuncio y el envío del
los pings de VAST de IAB necesarios cuando se hace clic en el botón Omitir. Consulta el siguiente código
para obtener más información:
/**
* Handles user touch or click events to skip a video ad.
* @param {!TouchEvent|!MouseEvent} skipEvent
*/
function onSkipButtonClicked(skipEvent) {
// Update your app to show either content or the next video ad.
// Also, ping any relevant VAST events.
nonceManager?.sendAdTouch(skipEvent);
}
Ahora tu sitio o app pueden segmentarse para el inventario de anuncios que se pueden omitir de los anuncios de Google servidores. Para verificar tu implementación, prueba muestra de la etiqueta de anuncio previo al video que se puede omitir.