Reklamy możliwe do pominięcia

Ten przewodnik pokazuje, jak używać pakietu SDK PAL na Androida do generowania liczby jednorazowej. żądania reklam możliwych do pominięcia, renderuj przycisk pominięcia zgodnie z Wymagania Google Ads, i wysyłanie powiązanych zdarzeń śledzenia.

Wymagania wstępne

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:

// Generates a nonce with sample arguments and logs it to the console.
public void generateNonceForAdRequest() {

  ...

  NonceRequest nonceRequest = NonceRequest.builder()
  .skippablesSupported(true)
  ...

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 i uzyskiwanie dodatkowych informacji.

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"
    }
  ]
}

Wysyłaj zdarzenie pominięcia reklamy

Wywołaj funkcję NonceManager.sendAdTouch() , która powiadamia serwery reklam Google, gdy użytkownik kliknie przycisk pominięcia. Uwzględnij to wywołanie w swojej funkcji, która służy do pomijania reklamy i wysyłania konieczne są pingi IAB VAST po kliknięciu przycisku pominięcia. Zobacz ten kod fragment, aby uzyskać więcej informacji:

// 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);
}

Teraz Twoja witryna lub aplikacja może kierować reklamy na zasoby reklamowe możliwe do pominięcia z reklamy Google serwerów. Aby sprawdzić implementację, przetestuj ją przykładowy tag reklamy przed filmem możliwej do pominięcia.