In dieser Anleitung wird gezeigt, wie du mit dem PAL SDK für Cast eine Nonce für überspringbare Anzeigen anfordern, rendern Sie die Schaltfläche zum Überspringen Anforderungen für Google Ads und die zugehörigen Tracking-Ereignisse senden.
Vorbereitung
- Eine App, in der das PAL SDK für Cast implementiert wird, um eine Nonce-Anfrage zu senden Weitere Informationen Informationen dazu findest du im Startleitfaden für PAL Cast.
- Ein Videoplayer, der den VAST 3 oder höher.
- Folgen Sie der Anleitung in Google Ad Manager, um Ihr Netzwerk für die Auslieferung einzurichten überspringbare Videoanzeigen für Ihr Anzeigenanfragen.
Nonce zum Anfordern von überspringbaren Anzeigen generieren
Legen Sie den Wert für skippablesSupported auf true für NonceRequest fest. Wenn es
nicht festgelegt ist, wird standardmäßig false unterstützt. Diese Anfrage
generiert Nonce-Werte, die für überspringbare Anzeigen erforderlich sind. Weitere Informationen:
Code für ein Beispiel zum Festlegen dieses Werts in der Nonce-Anfrage:
/**
* Generates a nonce with sample arguments and logs it to the console.
*/
function generateNonce() {
const nonceRequest = new goog.cast.pal.NonceRequest();
request.skippablesSupported = true;
...
Anforderungen an die Schaltfläche „Überspringen“
Bei überspringbaren Anzeigen die Schaltfläche „Überspringen“ mit folgendem Design rendern Anforderungen. Die Nichteinhaltung dieser Anforderungen kann Einschränkungen zur Folge haben die in Google Anzeigen platziert werden, die auf Ihrer Website oder in Ihrer App ausgeliefert werden.
Countdown-Timer
Die Anzeige darf erst überspringbar sein, wenn der skipoffset-Wert in der VAST-Datei angegeben ist.
Während des Zeitraums, in dem die Anzeigen nicht übersprungen werden können, muss dem Nutzer ein entsprechender Hinweis angezeigt werden.
dass die Anzeige in X Sekunden übersprungen werden kann. Die Mitteilung muss in folgende Sprache übersetzt werden:
Sprache der Nutzenden.
Positionierung von Schaltflächen
Wenn Sie rechtsläufige Sprachen verwenden möchten, platzieren Sie die Schaltfläche „Überspringen“ auf der rechten unteren Videoplayer. Bei Sprachen mit Textrichtung von rechts nach links platzieren Sie die Schaltfläche "Überspringen" auf der untere linke Seite des Videoplayers.
Größe der Schaltflächen
Die Schaltfläche und der Text müssen groß genug sein, um auch in weiter gedämpfter Position gut lesbar zu sein. Nutzererfahrung.
Text und Symbol
Die Schaltfläche „Überspringen“ muss sowohl Text als auch Symbole enthalten. Sie können die Symbol zum Überspringen des nächsten Materials als Symbol verwenden.
Bedienungshilfen
Die Nutzenden sollten in der Lage sein, über eine Tastatur oder Fernbedienung verwenden. Sobald der Countdown abgeschlossen ist, sollte die App die Schaltfläche „Überspringen“ in den Fokus rücken.
Internationalisierung
Der Überspringungstext muss in die Sprache des Nutzers übersetzt werden.
Anzeigen-Pods
Befindet sich die Anzeige in einem Anzeigen-Pod, Mit der Schaltfläche "Überspringen" können Sie entweder zur nächsten Anzeige im Pod springen oder den gesamten Pod überspringen.
„Werbung überspringen“ Übersetzungen
Verwenden Sie diese JSON-Datei zum Übersetzen von „Anzeige überspringen“ Text basierend auf der Sprache des Nutzers.
„Werbung überspringen“ Übersetzungen
{ "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 vom Typ „Anzeigenüberspringung“ senden
Rufen Sie die Methode
NonceManager.sendAdTouch()
, 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 Senden der
erforderliche IAB-VAST-Pings, wenn auf die Schaltfläche „Überspringen“ geklickt wird. Siehe folgenden Code
-Snippet für weitere Informationen:
/**
* Handles user touch or click events to skip a video ad.
* @param {!TouchEvent|!MouseEvent} skipEvent
*/
function OnSkipButtonClicked(event) {
// Update your app to show either content or the next video ad.
// Also, ping any relevant VAST events.
nonceManager?.sendAdTouch(skipEvent);
}
Ihre Website oder App kann jetzt auf überspringbares Anzeigeninventar von Google-Anzeigen ausgerichtet werden Server. Sie können Ihre Implementierung überprüfen, indem Sie mit diesem Beispiel für ein überspringbares Pre-Roll-Anzeigen-Tag