إضافة إعلانات البانر والمستطيل المتوسط إلى تطبيق Unity

تتيح لك Audience Network إمكانية تحقيق أرباح من تطبيقاتك على أنظمة Android وiOS من خلال إعلانات فيسبوك. يوضح هذا الدليل كيفية إضافة إعلانات بانر إلى تطبيقك.

خطوات إعلان البانر والمستطيل المتوسط

الخطوة الأولى: إنشاء كائن البانر

الخطوة الثانية: إضافة أحداث الاستدعاء

الخطوة الثالثة: تحميل الإعلان

الخطوة الرابعة: عرض الإعلان

الخطوة الأولى: إنشاء كائن البانر

تتمثل الخطوة الأولى لعرض إعلان البانر في إنشاء كائن AdView في برنامج C#‎ النصي المرفق في GameObject.

...
using AudienceNetwork;
...

public class AdViewTest : MonoBehaviour
{
    ...
    private AdView adView;
    ...

    public void LoadBanner()
    {
        if (this.adView) {
            this.adView.Dispose();
        }

        this.adView = new AdView("YOUR_PLACEMENT_ID", AdSize.BANNER_HEIGHT_50);
        this.adView.Register(this.gameObject);

        // Set delegates to get notified on changes or when the user interacts with the ad.
        this.adView.AdViewDidLoad = (delegate() {
            Debug.Log("Banner loaded.");
            this.adView.Show(100);
        });
        adView.AdViewDidFailWithError = (delegate(string error) {
            Debug.Log("Banner failed to load with error: " + error);
        });
        adView.AdViewWillLogImpression = (delegate() {
            Debug.Log("Banner logged impression.");
        });
        adView.AdViewDidClick = (delegate() {
            Debug.Log("Banner clicked.");
        });

        // Initiate a request to load an ad.
        adView.LoadAd();
    }
    ...
}

تتضمن جهة إنشاء AdView المعلمات التالية:

• placementId - معرف موضع Audience Network لوحدة إعلان البانر هذا.
• size - حجم إعلان البانر المحدد بواسطة قيم enum (التعداد) AdSize.

الخطوة الثانية: إضافة أحداث الاستدعاء

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

...
// Set delegates to get notified on changes or when the user interacts with the ad.
this.adView.AdViewDidLoad = (delegate() {
    Debug.Log("Banner loaded.");
    this.adView.Show(100);
});
adView.AdViewDidFailWithError = (delegate(string error) {
    Debug.Log("Banner failed to load with error: " + error);
});
adView.AdViewWillLogImpression = (delegate() {
    Debug.Log("Banner logged impression.");
});
adView.AdViewDidClick = (delegate() {
    Debug.Log("Banner clicked.");
});
...

الخطوة الثالثة: تحميل الإعلان

بمجرد تقديم مثال على AdView، تكون الخطوة التالية هي تحميل إعلان. ويمكن إجراء ذلك باستخدام الأسلوب loadAd()‎ في الفئة AdView.

في المثال الموضح أعلاه، إليك كيفية تحميل الإعلان:

...
adView.LoadAd();
...

الخطوة الرابعة: عرض الإعلان

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

this.adView.AdViewDidLoad = (delegate() {
    Debug.Log("Banner loaded.");
    this.adView.Show(100);
});

تتوفر 3 أنواع مختلفة من الطريقة Show في الفئة AdView والتي يمكنك استخدامها لعرض وحدة إعلان البانر:

• public bool Show(AdPosition position) - عرض وحدة إعلان البانر في المواقع المحددة مسبقًا، الخيارات المتوفرة هي: AdPosition.TOP يتم العرض أعلى الشاشة وAdPosition.BOTTOM يتم العرض أسفل الشاشة.
• public bool Show(double y) - يتم عرض وحدة إعلان البانر في إحداثيات الشاشة (0, y).
• public bool Show(double x, double y) - يتم عرض وحدة إعلان البانر في إحداثيات الشاشة (x, y).

أحجام بانر الإعلان

تدعم Audience Network ثلاثة أحجام للإعلان يمكن استخدامها في AdView. ويمتاز عرض وحدة البانر بالمرونة ويكون 320 بيكسل بحد أدنى، ويتم تحديد الارتفاع فقط.