إعداد إعلانات البانر

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

يوضّح لك هذا الدليل كيفية دمج مشاهدات إعلانات البانر في تطبيق Unity. بالإضافة إلى مقتطفات الرموز والتعليمات، يتضمّن أيضًا معلومات عن تحديد حجم إعلانات البانر بشكلٍ صحيح وروابط تؤدي إلى مراجع إضافية.

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

قبل المتابعة، عليك إعداد Google Mobile Ads Unity Plugin.

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

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

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

/21775744923/example/interstitial

إعداد Google Mobile Ads Unity Plugin

قبل تحميل الإعلانات، يجب أن يبدأ تطبيقك Google Mobile Ads Unity Plugin من خلال طلب MobileAds.Initialize(). يجب تنفيذ هذا الإجراء مرة واحدة فقط، ويُفضَّل أن يكون ذلك عند تشغيل التطبيق.

using GoogleMobileAds;
using GoogleMobileAds.Api;

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

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

مثال على BannerView

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

إنشاء عرض بانر

الخطوة الأولى في استخدام عرض إعلان بانر هي إنشاء مثيل لعرض إعلان بانر.

// Create a 320x50 banner at top of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);
AdManagerBannerViewSnippets.cs

استبدِل AD_UNIT_ID برقم تعريف وحدتك الإعلانية.

تتضمّن دالة الإنشاء لـ AdManagerBannerView المَعلمات التالية:

• ‫adUnitId: معرّف الوحدة الإعلانية لإعلان البانر المطلوب تحميله
• ‫AdSize: حجم البانر الذي تريد استخدامه
• ‫AdPosition: الموضع الذي يجب أن تظهر فيه مشاهدات إعلانات البانر

ملاحظة: تعتمد معرّفات الوحدات الإعلانية على المنصة. استخدِم وحدة إعلانية لنظام التشغيل iOS لتقديم طلبات الإعلانات على أجهزة iOS ومعرّف وحدة إعلانية لنظام التشغيل Android لتقديم الطلبات على أجهزة Android.

(اختياري) إنشاء طريقة عرض بانر بموضع مخصّص

للتحكّم بشكل أكبر في مكان وضع عرض البانر على الشاشة مقارنةً بما تقدّمه قيم AdPosition، استخدِم الدالة الإنشائية التي تحتوي على إحداثيات x وy كمَعلمات:

// Create a 320x50 banner views at coordinate (0,50) on screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
AdManagerBannerViewSnippets.cs

يتم وضع الزاوية العلوية اليمنى من عرض البانر عند قيم x وy التي تم تمريرها إلى الدالة الإنشائية، حيث يكون الأصل هو أعلى يمين الشاشة.

(اختياري) إنشاء عرض بانر بحجم مخصّص

بالإضافة إلى استخدام ثابت AdSize، يمكنك أيضًا تحديد حجم مخصّص لإعلانك:

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
AdManagerBannerViewSnippets.cs

(اختياري) أحجام إعلانات متعددة

تتيح لك "إدارة الإعلانات" تحديد أحجام إعلانات متعددة يمكن أن تكون مؤهّلة للعرض في AdManagerBannerView. قبل تنفيذ هذه الميزة في حزمة تطوير البرامج (SDK)، أنشئ استهداف بند إعلاني يستهدف الوحدات الإعلانية نفسها المرتبطة بتصاميم إعلانات بأحجام مختلفة.

في تطبيقك، مرِّر مَعلمات AdSize متعدّدة إلى ValidAdSizes:

// Create a 250x250 banner at the bottom of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);

// Add multiple ad sizes.
adManagerBannerView.ValidAdSizes = new List<AdSize>
{
    AdSize.Banner,
    new AdSize(120, 20),
    new AdSize(250, 250),
};
AdManagerBannerViewSnippets.cs

إذا تغيّر حجم "AdManagerAdView" في وقت إعادة التحميل، من المفترض أن يتمكّن التنسيق من التكيّف تلقائيًا مع الحجم الجديد. يتم ضبط AdManagerAdView تلقائيًا على الحجم الذي تم تمريره في المَعلمة الأولى إلى أن يتم عرض الإعلان التالي.

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

بعد وضع AdManagerBannerView، انتقِل إلى تحميل إعلان باستخدام طريقة LoadAd() في فئة AdManagerBannerView. وتتطلّب هذه الطريقة مَعلمة التي تحتوي على معلومات وقت التشغيل، مثل معلومات الاستهداف وتصنيفات الاستبعاد والمعرّف المقدَّم من الناشر.

لتحميل إعلان، أنشئ AdManagerAdRequest ومرِّره إلى طريقة LoadAd().

// Send a request to load an ad into the banner view.
adManagerBannerView.LoadAd(new AdManagerAdRequest());
AdManagerBannerViewSnippets.cs

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

الاستماع إلى أحداث عرض البانر

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

adManagerBannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
adManagerBannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
adManagerBannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
adManagerBannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
adManagerBannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
adManagerBannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
adManagerBannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};
AdManagerBannerViewSnippets.cs

إلغاء عرض البانر

لإزالة البانر، استخدِم طريقة Destroy() لإخلاء الموارد:

if (adManagerBannerView != null)
{
    // Always destroy the banner view when no longer needed.
    adManagerBannerView.Destroy();
    adManagerBannerView = null;
}
AdManagerBannerViewSnippets.cs

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

إعادة تحميل إعلان

إذا ضبطت وحدتك الإعلانية لإعادة التحميل، لن تحتاج إلى طلب إعلان آخر عند تعذُّر تحميل الإعلان. تلتزم Google Mobile Ads Unity Plugin بأي معدّل إعادة تحميل تحدّده في واجهة مستخدم "إدارة إعلانات Google". إذا لم تكن قد فعّلت إعادة التحميل، أرسِل طلبًا جديدًا. لمزيد من التفاصيل حول إعادة تحميل الوحدات الإعلانية، مثل ضبط معدّل إعادة التحميل، يُرجى الاطّلاع على معدّل إعادة تحميل الإعلانات في التطبيقات المتوافقة مع الأجهزة الجوّالة.

ملاحظة: عند ضبط معدّل إعادة تحميل في واجهة مستخدم "مدير إعلانات Google"، لا تتم إعادة التحميل التلقائي إلا إذا كان إعلان البانر مرئيًا على الشاشة.

أحجام البانر

توفّر "إعلانات البانر التكيُّفية" الكبيرة شكل إعلان أكبر مصمّمًا للتنسيقات التي لا تتضمّن إمكانية التمرير. مقارنةً بـ "إعلانات البانر التكيُّفية الثابتة" العادية، تتيح هذه الإعلانات حدًا أقصى أكبر للارتفاع (يصل إلى% 20 من ارتفاع الشاشة، بين 50 و150 بكسل مستقل الكثافة). تم تحسين هذه المساحة الإضافية لمحتوى الفيديو.

يسرد الجدول التالي الأحجام العادية لإعلانات البانر:

الحجم بالبكسل المستقل الكثافة (العرض × الارتفاع)	الوصف	مدى التوفّر	ثابت AdSize
320×50	إعلان بانر عادي	الهواتف والأجهزة اللوحية	BANNER
100x320	بانر كبير	الهواتف والأجهزة اللوحية	LARGE_BANNER
300×250	مستطيل متوسط وفقًا لمعايير IAB	الهواتف والأجهزة اللوحية	MEDIUM_RECTANGLE
468×60	بانر IAB بالحجم الكامل	الأجهزة اللوحية	FULL_BANNER
728×90	ليدربورد IAB	الأجهزة اللوحية	LEADERBOARD
العرض المقدَّم × الارتفاع التكيُّفي	إعلان بانر تكيُّفي	الهواتف والأجهزة اللوحية	لا ينطبق
عرض الشاشة x‏ 32|50|90	بانر ذكي	الهواتف والأجهزة اللوحية	SMART_BANNER
يمكنك الاطّلاع على مزيد من المعلومات عن إعلانات البانر التكيُّفية التي تهدف إلى استبدال إعلانات البانر الذكية.

ملاحظة: إذا حاول تطبيق Android تحميل بانر كبير جدًا بالنسبة إلى تنسيقه، لن تعرضه حزمة تطوير البرامج (SDK)، بل ستسجّل رسالة خطأ بدلاً من ذلك.

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

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

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

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

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

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

adManagerBannerView.OnAppEventReceived += (AppEvent args) =>
{
    if (args.Name == "color")
    {
        Color color;
        if (ColorUtility.TryParseHtmlString(args.Data, out color))
        {
            renderer.material.color = color;
        }
    }
};
AdManagerBannerViewSnippets.cs

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

<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: 0;
      left: 0;
      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>
AppEventSnippets.html

مراجع إضافية

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