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

حزمة تطوير البرامج (SDK) مع واجهة برمجة تطبيقات التحميل الفردي

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

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

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

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

إعداد GMA Next-Gen SDK.

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

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

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

ca-app-pub-3940256099942544/9257395921

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

للاطّلاع على تفاصيل الإعلانات الاختبارية 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;
      }
    });

عند الاختبار، استخدِم رقم تعريف الوحدة الإعلانية الاختبارية: ca-app-pub-3940256099942544/9257395921.

عرض الإعلان

لعرض إعلان على شاشة فتح التطبيق، استخدِم طريقة 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.
        }
      });
}

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

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

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

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

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

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

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