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

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

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

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

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

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

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

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة

قبل تحميل الإعلانات، عليك أن تطلب من تطبيقك إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة من خلال طلب الرقم MobileAds.Initialize(). يجب إجراء ذلك مرة واحدة فقط، ويُفضّل إجراءه عند تشغيل التطبيق.

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.
        });
    }
}

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

التنفيذ

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

  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 _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()، الذي يمكن تشغيله عندما ينتهي المستخدم من التفاعل مع الإعلان. بالإضافة إلى ذلك، ننصحك بالتوقف مؤقتًا عن أي مهام حسابية مكثفة، مثل حلقة ألعاب، أثناء عرض الإعلان. ويضمن ذلك عدم ظهور رسومات بطيئة أو لا تستجيب أو فيديو متقطّع للمستخدم.
لا تملأ المستخدم بالإعلانات.
على الرغم من أنّ زيادة معدّل تكرار الإعلانات البينية في تطبيقك قد تبدو كطريقة رائعة لزيادة الأرباح، إلا أنّها يمكن أن تؤدي أيضًا إلى خفض تجربة المستخدم وانخفاض معدّلات النقر إلى الظهور. تأكَّد من عدم انقطاع عملية استخدام المستخدمين لتطبيقك بشكل متكرر إلى درجة عدم تمكّنهم من الاستفادة منه.

مراجع إضافية

* نموذج حالة استخدام