Atlanabilir reklamları destekleyin

Bu kılavuzda, atlanabilir reklamlar istemek üzere tek seferlik rastgele sayı oluşturmak, atla düğmesini Google Ads reklam koşullarına göre oluşturmak ve ilişkili izleme etkinliklerini göndermek için Android için PAL SDK'nın nasıl kullanılacağı gösterilmektedir.

Ön koşullar

  • Android PAL 20.2.0 veya sonraki sürümler.
  • Tek seferlik rastgele sayı isteği göndermek için Android için PAL SDK'yı uygulayan bir uygulama. Daha fazla bilgi için PAL Android başlangıç kılavuzunu inceleyin.
  • Ağınızı reklam istekleriniz için atlanabilir video reklamlar yayınlayacak şekilde ayarlamak üzere Google Ad Manager'daki adımları uygulayın.

Atlanabilir reklamlar istemek için tek seferlik rastgele sayı oluşturma

NonceRequest için skippablesSupported değerini true olarak ayarlayın. Ayarlanmazsa atlanabilir reklamlar için destek varsayılan olarak false olur. Bu istek, atlanabilir reklamlar için gereken tek seferlik rastgele sayı değerlerini oluşturur. Bu değerin tek seferlik rastgele sayı isteğinde nasıl ayarlandığına dair bir örnek için aşağıdaki koda bakın:

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

  ...

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

Atla düğmesiyle ilgili koşullar

Atlanabilir reklamlar için atla düğmesini aşağıdaki tasarım şartlarına göre oluşturun. Bu şartlara uyulmaması, sitenizde veya uygulamanızda yayınlanan Google reklamlarına kısıtlamalar getirilmesine neden olabilir.

Geri sayım saati

Reklam, VAST'ta belirtilen skipoffset süresine kadar atlanabilir olmamalıdır. Bu atlanamayan süre boyunca kullanıcıya reklamın X saniye içinde atlanabileceğini bildiren bir uyarı gösterilmelidir. Bildirim, kullanıcının diline çevrilmelidir.

Düğme konumlandırma

Soldan sağa yazılan dillerde, atla düğmesini video oynatıcının sağ alt tarafına yerleştirin. Sağdan sola yazılan dillerde, atla düğmesini video oynatıcının sol alt tarafına yerleştirin.

Düğme boyutlandırma

Düğme ve metin, uzaktan izleme deneyiminde okunabilecek kadar büyük olmalıdır.

Metin ve simge

Atla düğmesinde hem metin hem de simge bulunmalıdır. Simge olarak sonraki materyal simgesini atla simgesini kullanabilirsiniz.

Erişilebilirlik

Kullanıcı, klavye veya uzaktan kumanda kullanarak atla düğmesine gidebilmelidir. Geri sayım tamamlandığında uygulama, atla düğmesine odaklanmalıdır.

Uluslararası hale getirme

Atlama metni, kullanıcının diline çevrilmelidir.

Reklam kapsülleri

Reklam bir reklam kapsülündeyse atla düğmesi, kapsüldeki bir sonraki reklama atlayabilir veya kapsülün tamamını atlayabilir.

"Reklamı atla" çevirileri

"Reklamı atla" metninizi kullanıcının yerel ayarına göre çevirmek için bu JSON'u kullanın.

"Reklamı atla" çevirileri

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

Reklam atlama etkinliğini gönderme

Kullanıcı atla düğmesini tıkladığında Google reklam sunucularını bilgilendirmek için NonceManager.sendAdTouch() işlevini çağırın. Bu çağrıyı, atla düğmesi tıklandığında reklamı atlamayı ve gerekli IAB VAST ping'lerini göndermeyi işleyen işlevinize ekleyin. Daha fazla bilgi için aşağıdaki kod snippet'ine bakın:

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

Artık siteniz veya uygulamanız, Google reklam sunucularından atlanabilir reklam envanterini hedefleyebilir. Bu örnek atlanabilir videodan önce gösterilen reklam etiketiyle test ederek uygulamanızı doğrulayabilirsiniz.