الإعلانات القابلة للتخطي

يوضح هذا الدليل كيفية استخدام PAL SDK لنظام التشغيل Android لإنشاء رقم غير أساسي لطلب الإعلانات القابلة للتخطي، اعرض زر التخطي وفقًا متطلبات "إعلانات Google" وإرسال أحداث التتبُّع المرتبطة بها

المتطلبات الأساسية

• الإصدار 20.2.0 من نظام التشغيل Android PAL أو إصدار أحدث
• تطبيق ينفِّذ حزمة PAL SDK لنظام التشغيل Android لتقديم طلب غير متكرر. لمزيد من المعلومات، المعلومات، فراجع دليل البدء على PAL Android
• اتّباع الخطوات الواردة في "مدير إعلانات Google" لإعداد شبكتك لعرض الإعلانات إعلانات الفيديو القابلة للتخطي لطلبات الإعلان.

إنشاء رقم واحد لطلب الإعلانات القابلة للتخطّي

اضبط قيمة skippablesSupported على true في NonceRequest. إذا كان لم يتم ضبطه، الإعداد التلقائي للإعلانات القابلة للتخطّي هو false. هذا الطلب تنشئ قيمًا غير نسبية مطلوبة للإعلانات القابلة للتخطي. يمكنك الاطّلاع على ما يلي: للحصول على مثال على ضبط هذه القيمة في طلب 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 ثانية. يجب ترجمة الإشعار إلى اللغة لغة المستخدم.

تحديد موضع الأزرار

بالنسبة إلى لغة من اليسار إلى اليمين، ضع زر التخطي في الجانب السفلي الأيمن من مشغّل الفيديو. بالنسبة إلى اللغة التي تبدأ من اليمين إلى اليسار، ضع زر التخطي على الجانب السفلي الأيمن من مشغّل الفيديو.

حجم الأزرار

يجب أن يكون الزر والنص كبيرَين بما يكفي ليكونا مقروءَين بشكل مريح المستخدم.

النص والرمز

يجب أن يحتوي زر التخطي على كل من النص والأيقنة. يمكنك استخدام صفحة تخطي رمز المادة التالية كالأيقنة.

تسهيل الاستخدام

يجب أن يكون المستخدم قادرًا على الانتقال إلى زر التخطي باستخدام لوحة مفاتيح أو جهاز التحكم عن بُعد. من المفترض أن يركّز التطبيق على زر التخطّي بعد انتهاء العد التنازلي.

التدويل

يجب ترجمة نص التخطّي إلى لغة المستخدم.

مجموعات الإعلانات المتسلسلة

إذا كان الإعلان في مجموعة إعلانات متسلسلة، يمكنك تخطّي الإعلان التالي في المجموعة أو تخطّي المجموعة بأكملها.

"تخطّي الإعلان" الترجمات

استخدام ملف 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 عندما ينقر المستخدم على زر التخطي. قم بتضمين هذا الاستدعاء في دالتك التي تتعامل مع تخطي الإعلان وإرسال إشعارات 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". الخوادم. يمكنك التحقّق من صحة عملية التنفيذ من خلال إجراء الاختبار باستخدام ما يلي: نموذج علامة إعلان ما قبل التشغيل القابلة للتخطي.