Ten przewodnik pokazuje, jak używać pakietu PAL SDK dla systemu tvOS do generowania liczby jednorazowej dla żądania reklam możliwych do pominięcia, wyrenderuj przycisk pominięcia zgodnie z Wymagania Google Ads, i wysyłanie powiązanych zdarzeń śledzenia.
Wymagania wstępne
- tvOS PAL w wersji 2.7.0 lub nowszej.
- Aplikacja implementująca pakiet SDK PAL dla systemu tvOS, aby wysyłać żądanie jednorazowe. Więcej więcej informacji znajdziesz w przewodniku wprowadzającym do systemu PAL tvOS.
- Wykonaj instrukcje w usłudze Google Ad Manager, aby skonfigurować sieć na potrzeby wyświetlania reklam możliwych do pominięcia reklam wideo żądania reklamy.
Wygeneruj jednorazowy kod dla żądania reklam możliwych do pominięcia
Ustaw wartość pola skippablesSupported na true w: NonceRequest. Jeśli
nie jest ustawiona, obsługa reklam możliwych do pominięcia jest domyślnie ustawiona na false. To żądanie
generuje wartości jednorazowe wymagane przez reklamy możliwe do pominięcia. Zobacz poniższe informacje
Jak można ustawić tę wartość w żądaniu jednorazowym:
ViewController.m
/**
* Generates a nonce with sample arguments and logs it to the console.
*/
- (void)requestNonceManager {
PALNonceRequest *request = [[PALNonceRequest alloc] init];
request.skippablesSupported = YES;
...
Wymagania dotyczące przycisku pominięcia
W przypadku reklam możliwych do pominięcia wyrenderuj przycisk pominięcia w taki sposób . Nieprzestrzeganie tych wymagań może skutkować ograniczeniami umieszczane w reklamach Google wyświetlanych w witrynie lub aplikacji.
Samowyzwalacz
Reklamę nie można pominąć przed upływem czasu skipoffset określonego w VAST.
W tym okresie niemożliwym do pominięcia użytkownikowi musi wyświetlić się powiadomienie informujące
że reklamę można pominąć w X s. Powiadomienie musi zostać przetłumaczone na język
na język użytkownika.
Pozycjonowanie przycisku
W przypadku języka pisanego od lewej do prawej umieść przycisk pominięcia w prawym dolnym rogu w odtwarzaczu wideo. W przypadku języka pisanego od prawej do lewej umieść przycisk pominięcia na w lewym dolnym rogu odtwarzacza.
Rozmiar przycisku
Przycisk i tekst muszą być wystarczająco duże, aby były czytelne z myślą o użytkownikach.
Tekst i ikona
Przycisk pomijania musi zawierać zarówno tekst, jak i ikonę. Za pomocą pomiń ikonę następnego materiału jako swoją ikonę.
Ułatwienia dostępu
Użytkownik powinien być w stanie przejść do przycisku pominięcia za pomocą klawiatury lub pilotem. Po zakończeniu odliczania aplikacja powinna skupić się na przycisku pominięcia.
Internacjonalizacja
Tekst pomijania musi być przetłumaczony na język użytkownika.
Bloki reklamowe
Jeśli reklama znajduje się w bloku reklamowym, za pomocą przycisku pominięcia może przejść do następnej reklamy w bloku reklamowym lub pominąć cały blok.
„Pomiń reklamę” tłumaczenia
Użyj tego kodu JSON do przetłumaczenia opcji „Pomiń reklamę” według regionu użytkownika.
„Pomiń reklamę” tłumaczenia
{ "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" } ] }
Teraz Twoja aplikacja może kierować reklamy na zasoby reklamowe możliwe do pominięcia z reklamy w Google serwerów. Aby sprawdzić implementację, przetestuj ją przykładowy tag reklamy przed filmem możliwej do pominięcia.