إعداد الإعلانات البينية

الإعلانات البينية هي إعلانات بملء الشاشة تغطي واجهة التطبيق. يتم عرض هذه الإعلانات في نقاط انتقال طبيعية في تطبيقك، مثل بين الأنشطة أو أثناء فترات التوقف المؤقت في مستويات اللعبة.

عندما يعرض تطبيقك إعلانًا بينيًا، يمكن للمستخدمين النقر على الإعلان والمتابعة أو إغلاق الإعلان والعودة إلى التطبيق. اطّلِع على دراسة الحالة هذه.

يوضّح هذا الدليل كيفية دمج الإعلانات البينية في تطبيق Android.

قبل البدء

قبل المتابعة، يُرجى اتّباع الخطوات التالية:

• إعداد GMA Next-Gen SDK
• استخدِم رقم تعريف الوحدة الإعلانية البينية الاختبارية ca-app-pub-3940256099942544/1033173712.
  • عند إنشاء تطبيقك واختباره، احرص على استخدام إعلانات اختبارية بدلاً من الإعلانات النهائية المباشرة. إذا لم تستخدِم معرّف الوحدة الإعلانية الاختبارية، يمكن أن تعلّق Google حسابك.
  • قبل نشر تطبيقك، استبدِل هذا المعرّف بمعرّف الوحدة الإعلانية.
  • للحصول على تفاصيل حول GMA Next-Gen SDK الإعلانات التجريبية، اطّلِع على مقالة تفعيل الإعلانات التجريبية.

فهم التحميل المُسبَق للإعلان (إصدار تجريبي)

تتيح ميزة "التحميل المُسبَق للإعلانات" (إصدار تجريبي) في GMA Next-Gen SDK إمكانية أتمتة تحميل الإعلانات وتخزينها مؤقتًا.

توفّر ميزة "التحميل المُسبَق للإعلانات" المزايا التالية:

• إدارة المراجع: تحتفظ بالمراجع إلى أن يتم عرض الإعلانات.
• إعادة التحميل التلقائي: يتم تحميل إعلان جديد عند استرداد إعلان من ذاكرة التخزين المؤقت.
• عمليات إعادة المحاولة المُدارة: يتم تحميل إعلان جديد عندما يتعذّر تحميل إعلان آخر.
• التعامل مع انتهاء الصلاحية: إعادة تحميل الإعلانات قبل انتهاء صلاحيتها
• تحسين ذاكرة التخزين المؤقت: تعمل هذه الميزة على تحسين ترتيب ذاكرة التخزين المؤقت لعرض الإعلان ذي الأولوية الأعلى.

بدء التحميل المُسبَق للإعلان

لبدء التحميل المُسبَق للإعلانات، استدعِ طريقة startPreload() مرة واحدة عند بدء تشغيل التطبيق. بعد استدعاء الطريقة startPreload()، GMA Next-Gen SDKيتم تلقائيًا التحميل المُسبَق للإعلانات وإعادة محاولة الطلبات التي تعذّر تنفيذها لعمليات الإعداد التي تم تحميلها مُسبقًا.

يوضّح المثال التالي كيفية بدء التحميل المُسبَق للإعلانات:

private fun startPreloading(adUnitId: String) {
  // Call start() once after SDK initialization.
  // Preload only one ad unit per format to optimize performance.
  val adRequest = AdRequest.Builder(adUnitId).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  InterstitialAdPreloader.start(adUnitId, preloadConfig)
}

private void startPreloading(String adUnitId) {
  // Call start() once after SDK initialization.
  // Preload only one ad unit per format to optimize performance.
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  InterstitialAdPreloader.start(adUnitId, preloadConfig);
}

استبدِل AD_UNIT_ID برقم تعريف وحدتك الإعلانية.

يوضّح المثال السابق كيفية استخدام رقم تعريف الوحدة الإعلانية كمعرّف التحميل المُسبَق. معرّف التحميل المُسبَق هو معرّف سلسلة تنشئه لتحديد إعدادات التحميل المُسبَق للإعلان. إذا كان تطبيقك يتطلّب إعدادات استهداف متعدّدة لرقم تعريف الوحدة الإعلانية نفسه، مرِّر معرّف سلسلة مخصّصًا.

الحصول على الإعلان المحمَّل مسبقًا وعرضه

عندما تريد عرض إعلان، استدعِ الطريقة pollAd(). يستردّ GMA Next-Gen SDK إعلانًا متاحًا ويحمّل تلقائيًا الإعلان التالي مسبقًا في الخلفية. في حال عدم توفّر أي إعلان، لا تعرض الدالة GMA Next-Gen SDK أي إعلانات.