In diesem Leitfaden wird gezeigt, wie Sie mit dem PAL SDK für Android eine Nonce für die Anfrage von überspringbaren Anzeigen generieren, die Schaltfläche zum Überspringen gemäß den Anforderungen von Google Ads rendern und die zugehörigen Tracking-Ereignisse senden.
Vorbereitung
- Android PAL-Version 20.2.0 oder höher.
- Eine App, die das PAL SDK for Android implementiert, um eine Nonce-Anfrage zu stellen. Weitere Informationen finden Sie im Startleitfaden für die PAL Android SDK.
- Folgen Sie der Anleitung in Google Ad Manager, um Ihr Netzwerk so einzurichten, dass überspringbare Videoanzeigen für Ihre Anzeigenanfragen ausgeliefert werden.
Nonce für die Anfrage von überspringbaren Anzeigen generieren
Legen Sie den Wert für skippablesSupported auf true auf dem NonceRequest fest. Wenn sie nicht festgelegt ist, wird die Unterstützung für überspringbare Anzeigen standardmäßig auf false gesetzt. Bei dieser Anfrage werden Nonce-Werte generiert, die für überspringbare Anzeigen erforderlich sind. Im folgenden Code sehen Sie ein Beispiel dafür, wie dieser Wert in der Nonce-Anfrage festgelegt wird:
// Generates a nonce with sample arguments and logs it to the console.
public void generateNonceForAdRequest() {
...
NonceRequest nonceRequest = NonceRequest.builder()
.skippablesSupported(true)
...
Anforderungen an die Schaltfläche „Überspringen“
Rendern Sie bei überspringbaren Anzeigen die Schaltfläche zum Überspringen mit den folgenden Designanforderungen. Wenn Sie diese Anforderungen nicht erfüllen, kann die Auslieferung von Google-Anzeigen auf Ihrer Website oder in Ihrer App eingeschränkt werden.
Countdown-Timer
Die Anzeige darf erst nach der in der VAST-Antwort angegebenen Zeit (skipoffset) übersprungen werden können.
Während dieses nicht überspringbaren Zeitraums muss dem Nutzer ein Hinweis angezeigt werden, dass die Anzeige in X Sekunden übersprungen werden kann. Der Hinweis muss in die Sprache des Nutzers übersetzt werden.
Position des Buttons
Bei einer Sprache, die von links nach rechts gelesen wird, platziere die Schaltfläche zum Überspringen unten rechts im Videoplayer. Bei einer Sprache, die von rechts nach links geschrieben wird, platzieren Sie die Schaltfläche zum Überspringen unten links im Videoplayer.
Größe der Schaltfläche
Die Schaltfläche und der Text müssen groß genug sein, um auch aus der Ferne lesbar zu sein.
Text und Symbol
Die Schaltfläche zum Überspringen muss sowohl Text als auch Symbole enthalten. Sie können das Material Design-Symbol „Nächsten Titel überspringen“ als Symbol verwenden.
Bedienungshilfen
Der Nutzer sollte die Schaltfläche zum Überspringen über eine Tastatur oder Fernbedienung aufrufen können. Die App sollte die Schaltfläche zum Überspringen fokussieren, sobald der Countdown abgelaufen ist.
Internationalisierung
Der Text zum Überspringen muss in die Sprache des Nutzers übersetzt werden.
Anzeigen-Pods
Wenn sich die Anzeige in einem Anzeigen-Pod befindet, kann die Schaltfläche „Überspringen“ entweder zur nächsten Anzeige im Pod oder zum Ende des Pods führen.
Übersetzungen für „Anzeige überspringen“
Verwenden Sie dieses JSON, um den Text „Anzeige überspringen“ basierend auf dem Standort des Nutzers zu übersetzen.
Übersetzungen für „Anzeige überspringen“
{ "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" } ] }
Ereignis zum Überspringen der Anzeige senden
Rufen Sie die Funktion NonceManager.sendAdTouch() auf, um die Google-Ad-Server zu benachrichtigen, wenn der Nutzer auf die Schaltfläche zum Überspringen klickt.
Fügen Sie diesen Aufruf in die Funktion ein, die das Überspringen der Anzeige und das Senden der erforderlichen IAB-VAST-Pings verarbeitet, wenn auf die Schaltfläche zum Überspringen geklickt wird. Weitere Informationen finden Sie im folgenden Code-Snippet:
// 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);
}
Jetzt kann auf Ihrer Website oder in Ihrer App überspringbares Anzeigeninventar von Google-Ad-Servern ausgerichtet werden. Sie können Ihre Implementierung mit diesem Beispiel-Anzeigen-Tag für überspringbare Pre-Roll-Anzeigen testen.