รองรับโฆษณาแบบข้ามได้

คู่มือนี้แสดงวิธีใช้ PAL SDK สำหรับ Android เพื่อสร้าง Nonce สำหรับขอโฆษณาแบบข้ามได้ แสดงผลปุ่มข้ามตามข้อกำหนดของ Google Ads และส่งเหตุการณ์การติดตามที่เกี่ยวข้อง

ข้อกำหนดเบื้องต้น

สร้าง Nonce สำหรับการขอโฆษณาแบบข้ามได้

ตั้งค่า skippablesSupported เป็น true ใน NonceRequest หากไม่ได้ตั้งค่าไว้ การรองรับโฆษณาแบบข้ามได้จะมีค่าเริ่มต้นเป็น false คำขอนี้จะสร้างค่า Nonce ที่จำเป็นสำหรับโฆษณาที่ข้ามได้ ดูโค้ดต่อไปนี้เพื่อดูตัวอย่างการตั้งค่านี้ในคำขอ Nonce

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

  ...

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

ข้อกำหนดของปุ่มข้าม

สำหรับโฆษณาแบบข้ามได้ ให้แสดงปุ่มข้ามตามข้อกำหนดด้านการออกแบบต่อไปนี้ การไม่ปฏิบัติตามข้อกำหนดเหล่านี้อาจทำให้มีการจำกัดการแสดงโฆษณา Google ในเว็บไซต์หรือแอปของคุณ

ตัวจับเวลาถอยหลัง

โฆษณาต้องไม่สามารถข้ามได้จนกว่าจะถึงเวลา skipoffset ที่ระบุไว้ใน VAST ในระหว่างช่วงเวลาที่ข้ามไม่ได้นี้ คุณต้องแสดงการแจ้งเตือนให้ผู้ใช้ทราบว่าสามารถข้ามโฆษณาได้ในอีก X วินาที ประกาศต้องแปลเป็นภาษาของผู้ใช้

การจัดตำแหน่งปุ่ม

สำหรับภาษาที่อ่านจากซ้ายไปขวา ให้วางปุ่มข้ามไว้ที่ด้านขวาล่างของวิดีโอเพลเยอร์ สำหรับภาษาที่อ่านจากขวาไปซ้าย ให้วางปุ่มข้ามไว้ที่ด้านซ้ายล่างของวิดีโอเพลเยอร์

การปรับขนาดปุ่ม

ปุ่มและข้อความต้องใหญ่พอที่จะอ่านได้ในประสบการณ์การรับชมแบบเอนหลัง

ข้อความและไอคอน

ปุ่มข้ามต้องมีทั้งข้อความและไอคอน คุณสามารถใช้ไอคอนจากดีไซน์ Material สำหรับข้ามไปยังรายการถัดไปเป็นภาพสัญลักษณ์ได้

การช่วยเหลือพิเศษ

ผู้ใช้ควรไปยังปุ่มข้ามได้โดยใช้แป้นพิมพ์หรือรีโมตคอนโทรล แอปควรโฟกัสที่ปุ่มข้ามเมื่อการนับถอยหลังเสร็จสมบูรณ์

การทำให้เป็นสากล

ข้อความข้ามต้องแปลเป็นภาษาของผู้ใช้

พ็อดโฆษณา

หากโฆษณาอยู่ในพ็อดโฆษณา ปุ่มข้ามจะข้ามไปยังโฆษณาถัดไปในพ็อดหรือข้ามทั้งพ็อดก็ได้

คำแปลของ "ข้ามโฆษณา"

ใช้ JSON นี้เพื่อแปลข้อความ "ข้ามโฆษณา" ตามภาษาของผู้ใช้

คำแปลของ "ข้ามโฆษณา"

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

ส่งเหตุการณ์การข้ามโฆษณา

เรียกใช้ฟังก์ชัน NonceManager.sendAdTouch() เพื่อแจ้งเซิร์ฟเวอร์โฆษณา Google เมื่อผู้ใช้คลิกปุ่มข้าม รวมการเรียกนี้ไว้ในฟังก์ชันที่จัดการการข้ามโฆษณาและส่งคําสั่ง ping ของ IAB VAST ที่จําเป็นเมื่อมีการคลิกปุ่มข้าม ดูรายละเอียดเพิ่มเติมได้ที่ข้อมูลโค้ดต่อไปนี้

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

ตอนนี้เว็บไซต์หรือแอปของคุณสามารถกำหนดเป้าหมายพื้นที่โฆษณาแบบข้ามได้จากเซิร์ฟเวอร์โฆษณา Google ได้แล้ว คุณยืนยันการติดตั้งใช้งานได้โดยทดสอบด้วยแท็กโฆษณาตอนต้นแบบข้ามได้ตัวอย่างนี้