تحميل "إعلان واحد على شاشة فتح التطبيق"

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

لمزيد من المعلومات، يُرجى الاطّلاع على إرشادات "إعلان على شاشة فتح التطبيق".

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

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

إعداد GMA Next-Gen SDK

اختبار الإعلانات دائمًا باستخدام الإعلانات الاختبارية

عند إنشاء تطبيقاتك واختبارها، احرص على استخدام الإعلانات الاختبارية بدلاً من الإعلانات المباشرة. وقد يؤدي عدم إجراء ذلك إلى تعليق حسابك.

لتحميل إعلانات اختبارية، استخدِم رقم تعريف وحدة الإعلانات الاختبارية المخصّص لـ "الإعلانات على شاشة فتح التطبيق" على Android:

/21775744923/example/app-open

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

للحصول على تفاصيل حول GMA Next-Gen SDK الإعلانات التجريبية، اطّلِع على مقالة تفعيل الإعلانات التجريبية.

تحميل إعلان

يوضّح المثال التالي كيفية تحميل إعلان واحد:

Kotlin

// Load ads after you initialize MobileAds.
AppOpenAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<AppOpenAd> {
    override fun onAdLoaded(ad: AppOpenAd) {
      // App open ad loaded.
      appOpenAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // App open ad failed to load.
      Log.e(TAG, "App open ad failed to load: ${adError.message}")
      appOpenAd = null
    }
  },
)

جافا

// Load ads after you initialize MobileAds.
AppOpenAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<AppOpenAd>() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // App open ad loaded.
        appOpenAd = ad;
      }

      @Override
      public void onAdFailedToLoad(LoadAdError adError) {
        // App open ad failed to load.
        Log.e(TAG, "App open ad failed to load: " + adError.getMessage());
        appOpenAd = null;
      }
    });

عند إجراء الاختبار، استخدِم معرّف الوحدة الإعلانية الاختبارية: /21775744923/example/app-open.

عرض الإعلان

لعرض "إعلان على شاشة فتح التطبيق"، استخدِم الطريقة show.

Kotlin

private fun showAd(appOpenAd: AppOpenAd, activity: Activity) {
  // Show the ad.
  appOpenAd.show(activity)
}

جافا

private void showAd(AppOpenAd appOpenAd, Activity activity) {
  // Show the ad.
  appOpenAd.show(activity);
}

الاستماع إلى أحداث الإعلانات

قبل عرض الإعلان، استمع إلى أحداث مراحل نشاط الإعلان:

Kotlin

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = appOpenAd
  if (ad == null) {
    Log.e(TAG, "App open ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // App open ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // App open ad did dismiss.
        appOpenAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // App open ad failed to show.
        Log.e(TAG, "App open ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // App open ad did record an impression.
      }

      override fun onAdClicked() {
        // App open ad did record a click.
      }
    }
}

جافا

private void listenToAdEvents() {
  // Listen for ad events.
  if (appOpenAd == null) {
    Log.e(TAG, "App open ad is not ready yet.");
    return;
  }

  appOpenAd.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // App open ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // App open ad did dismiss.
          appOpenAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // App open ad failed to show.
          Log.e(TAG, "App open ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // App open ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // App open ad did record a click.
        }
      });
}

عمليات التشغيل البارد وشاشات التحميل

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

بسبب التأخير في طلبات عرض الإعلانات، قد يتفاعل المستخدمون مع تطبيقك قبل ظهور "إعلان على شاشة فتح التطبيق". لتجنُّب تقديم تجربة سيئة للمستخدم، اعرض "الإعلانات على شاشة فتح التطبيق" عند بدء التشغيل على البارد من شاشة تحميل فقط أثناء تحميل مواد عرض التطبيق. إذا اكتمل تحميل مواد العرض ووصل المستخدم إلى المحتوى الرئيسي قبل تحميل الإعلان، لا تعرض الإعلان.

حمِّل مواد عرض التطبيق في سلسلة محادثات في الخلفية حتى يستمر التحميل أثناء عرض الإعلان.

أفضل الممارسات

اتّبِع أفضل الممارسات التالية لعرض "الإعلانات على شاشة فتح التطبيق":

  • لا تعرِض "الإعلان على شاشة فتح التطبيق" الأول إلا بعد أن يفتح المستخدم تطبيقك عدة مرات.
  • اعرض "الإعلانات على شاشة فتح التطبيق" فقط أثناء انتظار المستخدمين لتحميل تطبيقك.
  • إذا انتهت شاشة التحميل من التحميل أثناء عرض الإعلان، عليك إغلاق شاشة التحميل في طريقة ردّ النداء الخاصة بإغلاق الإعلان.