Questa guida mostra come utilizzare l'SDK PAL per Android per generare un nonce per richiedere annunci ignorabili, eseguire il rendering del pulsante Salta in base ai requisiti degli annunci Google e inviare gli eventi di monitoraggio associati.
Prerequisiti
- PAL per Android versione 20.2.0 o successive.
- Un'app che implementa l'SDK PAL per Android per effettuare una richiesta di nonce. Per saperne di più, consulta la guida introduttiva di PAL per Android.
- Segui i passaggi su Google Ad Manager per configurare la tua rete in modo da pubblicare annunci video ignorabili per le tue richieste di annunci.
Genera un nonce per richiedere annunci ignorabili
Imposta il valore di skippablesSupported su true in NonceRequest. Se non è impostato, il supporto per gli annunci ignorabili viene impostato su false per impostazione predefinita. Questa richiesta genera valori nonce necessari per gli annunci ignorabili. Consulta il seguente codice per un esempio di impostazione di questo valore nella richiesta di nonce:
// Generates a nonce with sample arguments and logs it to the console.
public void generateNonceForAdRequest() {
...
NonceRequest nonceRequest = NonceRequest.builder()
.skippablesSupported(true)
...
Requisiti del pulsante Salta
Per gli annunci ignorabili, esegui il rendering del pulsante Salta con i seguenti requisiti di progettazione. Il mancato rispetto di questi requisiti potrebbe comportare l'applicazione di limitazioni alla pubblicazione di annunci Google sul tuo sito o nella tua app.
Timer conto alla rovescia
L'annuncio non deve essere ignorabile fino al momento skipoffset specificato nel VAST.
Durante questo periodo non ignorabile, all'utente deve essere mostrato un avviso che lo informa che l'annuncio può essere ignorato dopo X secondi. L'avviso deve essere tradotto nella lingua dell'utente.
Posizionamento dei pulsanti
Per una lingua con scrittura da sinistra a destra, posiziona il pulsante Salta nella parte in basso a destra del video player. Per una lingua con scrittura da destra a sinistra, posiziona il pulsante Salta sul lato inferiore sinistro del video player.
Dimensionamento dei pulsanti
Il pulsante e il testo devono essere abbastanza grandi da essere leggibili in un'esperienza di visione rilassata.
Testo e icona
Il pulsante Salta deve contenere sia testo che iconografia. Puoi utilizzare l'icona Material Salta avanti come iconografia.
Accessibilità
L'utente deve essere in grado di accedere al pulsante Salta utilizzando una tastiera o un telecomando. L'app deve attivare il pulsante Salta al termine del conto alla rovescia.
Internazionalizzazione
Il testo per saltare l'annuncio deve essere tradotto nella lingua dell'utente.
Pod di annunci
Se l'annuncio si trova in un pod di annunci, il pulsante Salta può passare all'annuncio successivo nel pod o saltare l'intero pod.
Traduzioni di "Salta annuncio"
Utilizza questo JSON per tradurre il testo "Salta annuncio" in base alle impostazioni internazionali dell'utente.
Traduzioni di "Salta annuncio"
{ "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" } ] }
Invia l'evento di salto dell'annuncio
Chiama la funzione NonceManager.sendAdTouch() per inviare una notifica agli ad server di Google quando l'utente fa clic sul pulsante Salta.
Includi questa chiamata nella funzione che gestisce il salto dell'annuncio e l'invio dei ping IAB VAST necessari quando viene fatto clic sul pulsante Salta. Per maggiori dettagli, consulta il seguente snippet di codice:
// Handles user touch or click events to skip a video ad.
public void OnSkipButtonClicked(MotionEvent skipEvent) {
// Update your app to show either content or the next video ad.
// Also, ping any relevant VAST events.
nonceManager.sendAdTouch(skipEvent);
}
Ora il tuo sito o la tua app possono scegliere come target l'inventario pubblicitario ignorabile dagli ad server di Google. Puoi verificare l'implementazione eseguendo un test con questo tag annuncio pre-roll ignorabile di esempio.