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

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

يوضّح هذا الدليل كيفية دمج الإعلانات البينية في تطبيق 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();
    };
}

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

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

يمكنك الاستماع إلى أحداث التطبيقات المتعلّقة بخدمة "مدير إعلانات Google" باستخدام 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}.");
};

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

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

لا تغمر المستخدم بالإعلانات.

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

.

مراجع إضافية

• مثال HelloWorld: يعرض الحد الأدنى من تنفيذ جميع أشكال الإعلانات.