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

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

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

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

Always test with test ads

The sample code below contains an ad unit ID which you can use to request test ads. It's been specially configured to return test ads rather than production ads for every request, making it safe to use.

However, after you've registered an app in the AdMob web interface and created your own ad unit IDs for use in your app, explicitly configure your device as a test device during development.

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

Initialize the Mobile Ads SDK

Before loading ads, have your app initialize the Mobile Ads SDK by calling MobileAds.Initialize(). This needs to be done only once, ideally at app launch.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

If you're using mediation, wait until the callback occurs before loading ads as this will ensure that all mediation adapters are initialized.

التنفيذ

الخطوات الأساسية لدمج الإعلانات البينية هي:

  1. تحميل الإعلان البيني
  2. عرض الإعلان البيني
  3. الاستماع إلى أحداث الإعلانات البينية
  4. تنظيف الإعلان البيني
  5. تحميل الإعلان البيني التالي مسبقًا

تحميل الإعلان البيني

يمكن تحميل إعلان بيني باستخدام طريقة Load() الثابتة للفئة InterstitialAd. تتطلب طريقة التحميل رقم تعريف وحدة إعلانية وعنصر AdRequest ومعالج إكمال يتم استدعاؤه عند نجاح تحميل الإعلان أو تعذُّر تحميله. ويتم توفير الكائن InterstitialAd الذي تم تحميله كمعلَمة في معالج الإكمال. يوضح المثال أدناه كيفية تحميل InterstitialAd.


  // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
  private string _adUnitId = "ca-app-pub-3940256099942544/1033173712";
#elif UNITY_IPHONE
  private string _adUnitId = "ca-app-pub-3940256099942544/4411468910";
#else
  private string _adUnitId = "unused";
#endif

  private _interstitialAd;

  /// <summary>
  /// Loads the interstitial ad.
  /// </summary>
  public void LoadInterstitialAd()
  {
      // Clean up the old ad before loading a new one.
      if (_interstitialAd != null)
      {
            _interstitialAd.Destroy();
            _interstitialAd = null;
      }

      Debug.Log("Loading the interstitial ad.");

      // create our request used to load the ad.
      var adRequest = new AdRequest();

      // send the request to load the ad.
      InterstitialAd.Load(_adUnitId, adRequest,
          (InterstitialAd ad, LoadAdError error) =>
          {
              // if error is not null, the load request failed.
              if (error != null || ad == null)
              {
                  Debug.LogError("interstitial ad failed to load an ad " +
                                 "with error : " + error);
                  return;
              }

              Debug.Log("Interstitial ad loaded with response : "
                        + ad.GetResponseInfo());

              _interstitialAd = ad;
          });
  }

عرض الإعلان البيني

لعرض إعلان بيني تم تحميله، عليك استدعاء الإجراء Show() في المثيل InterstitialAd. قد تظهر الإعلانات مرة واحدة لكل تحميل. استخدِم طريقة CanShowAd() للتأكّد من أنّ الإعلان جاهز للعرض.

/// <summary>
/// Shows the interstitial ad.
/// </summary>
public void ShowInterstitialAd()
{
    if (_interstitialAd != null && _interstitialAd.CanShowAd())
    {
        Debug.Log("Showing interstitial ad.");
        _interstitialAd.Show();
    }
    else
    {
        Debug.LogError("Interstitial ad is not ready yet.");
    }
}

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

لتخصيص سلوك إعلانك بصورةٍ أكبر، يمكنك جذب عدد من الأحداث خلال دورة حياة الإعلان. استمع إلى هذه الأحداث من خلال تسجيل مندوب كما هو موضح أدناه.

private void RegisterEventHandlers(InterstitialAd interstitialAd)
{
    // Raised when the ad is estimated to have earned money.
    interstitialAd.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("Interstitial ad paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    interstitialAd.OnAdImpressionRecorded += () =>
    {
        Debug.Log("Interstitial ad recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    interstitialAd.OnAdClicked += () =>
    {
        Debug.Log("Interstitial ad was clicked.");
    };
    // Raised when an ad opened full screen content.
    interstitialAd.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("Interstitial ad full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    interstitialAd.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("Interstitial ad full screen content closed.");
    };
    // Raised when the ad failed to open full screen content.
    interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Interstitial ad failed to open full screen content " +
                       "with error : " + error);
    };
}

تنظيف الإعلان البيني

عند الانتهاء من استخدام InterstitialAd، تأكد من استدعاء الطريقة Destroy() قبل إسقاط المرجع إليها:

_interstitialAd.Destroy();

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

تحميل الإعلان البيني التالي مسبقًا

الإعلانات البينية هي عناصر يتم استخدامها لمرة واحدة. وهذا يعني أنه بعد عرض الإعلان البيني، لا يمكن استخدام الكائن مرة أخرى. لطلب إعلان بيني آخر، يمكنك إنشاء عنصر InterstitialAd جديد.

لإعداد إعلان بيني لفرصة الظهور التالية، يمكنك تحميل الإعلان البيني مسبقًا عند ظهور حدث الإعلان OnAdFullScreenContentClosed أو OnAdFullScreenContentFailed.

private void RegisterReloadHandler(InterstitialAd interstitialAd)
{
    // Raised when the ad closed full screen content.
    interstitialAd.OnAdFullScreenContentClosed += ()
    {
        Debug.Log("Interstitial Ad full screen content closed.");

        // Reload the ad so that we can show another as soon as possible.
        LoadInterstitialAd();
    };
    // Raised when the ad failed to open full screen content.
    interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Interstitial ad failed to open full screen content " +
                       "with error : " + error);

        // Reload the ad so that we can show another as soon as possible.
        LoadInterstitialAd();
    };
}

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

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

مراجع إضافية

* مثال على حالة استخدام