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

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

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

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

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

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

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

/21775744923/example/interstitial

إعداد حزمة تطوير البرامج (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). تتطلب طريقة التحميل رقم تعريف وحدة إعلانية، كائن AdManagerAdRequest ومعالج الإكمال الذي عند نجاح تحميل الإعلانات أو تعذُّر عرضها يتوفّر عنصر AdManagerInterstitialAd كمَعلمة في معالِج الإكمال. يوضّح المثال أدناه كيفية تحميل AdManagerInterstitialAd.


  // This ad unit is configured to always serve test ads.
  private string _adUnitId = "/21775744923/example/interstitial";

  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 AdManagerAdRequest();

      // send the request to load the ad.
      AdManagerInterstitialAd.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() على مثيل AdManagerInterstitialAd يمكن عرض الإعلانات مرة واحدة في التحميل. استخدِم طريقة 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);
    };
}

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

عند الانتهاء من استخدام AdManagerInterstitialAd، احرص على استدعاء الطريقة Destroy() قبل إزالة الإشارة إليها:

_interstitialAd.Destroy();

يتم بذلك إعلام المكون الإضافي بأن الكائن لم يعد قيد الاستخدام والذاكرة ويمكن استردادها. يؤدي عدم استدعاء هذه الطريقة إلى تسرب الذاكرة.

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

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

لإعداد إعلان بيني من أجل فرصة الظهور التالية، حمِّل الإعلان البيني مرة واحدة في 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();
    };
}

أحداث التطبيقات

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

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

namespace GoogleMobileAds.Api.AdManager;

/// The App event message sent from the ad.
public class AppEvent
{
    // Name of the app event.
    string Name;
    // Argument passed from the app event.
    string Value;
}

يتم رفع OnAppEventReceived عند وقوع حدث تطبيق في أحد الإعلانات. في ما يلي مثال على كيفية معالجة هذا الحدث في الرمز البرمجي:

_interstitialAd.OnAppEventReceived += (AppEvent args) =>
{
    Debug.Log($"Received app event from the ad: {args.Name}, {args.Value}.");
};

في ما يلي مثال يوضّح كيفية تغيير لون خلفية تطبيقك بناءً على حدث تطبيق يحمل اسم لون:

_interstitialAd.OnAppEventReceived += (AppEvent args) =>
{
  if (args.Name == "color")
  {
    Color color;
    if (ColorUtility.TryParseColor(arg.Value, out color))
    {
      gameObject.GetComponent<Renderer>().material.color = color;
    }
  }
};

في ما يلي تصميم الإعلان المقابل الذي يُرسِل حدث تطبيق التلوين:

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0px;
      left: 0px;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>

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

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

مراجع إضافية