إضافة إعلانات الفيديو بمكافأة إلى تطبيق Unity

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

خطوات إعلانات فيديو بمكافأة

الخطوة الأولى: تهيئة إعلانات الفيديو بمكافأة

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

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

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

الخطوة الأولى: تهيئة إعلانات الفيديو بمكافأة

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

...
using AudienceNetwork;
...

public class RewardedVideoAdTest : MonoBehaviour
{
    public void LoadRewardedVideo()
    {
        // Create the rewarded video unit with a placement ID (generate your own on the Facebook app settings).
        // Use different ID for each ad placement in your app.
        this.rewardedVideoAd = new RewardedVideoAd("YOUR_PLACEMENT_ID");

        this.rewardedVideoAd.Register(this.gameObject);

        // Set delegates to get notified on changes or when the user interacts with the ad.
        this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
            Debug.Log("RewardedVideo ad loaded.");
            this.isLoaded = true;
        });
        this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
            Debug.Log("RewardedVideo ad failed to load with error: " + error);
        });
        this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
            Debug.Log("RewardedVideo ad logged impression.");
        });
        this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
            Debug.Log("RewardedVideo ad clicked.");
        });

        this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
            Debug.Log("Rewarded video ad did close.");
            if (this.rewardedVideoAd != null) {
                this.rewardedVideoAd.Dispose();
            }
        });

        // Initiate the request to load the ad.
        this.rewardedVideoAd.LoadAd();
    }
}

تتوفر لدى جهة إنشاء RewardedVideoAd المعلمات التالية:

• placementId - معرف موضع Audience Network للوحدة الإعلانية للفيديو بمكافأة.

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

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

...
// Set delegates to get notified on changes or when the user interacts with the ad.
this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
    Debug.Log("RewardedVideo ad loaded.");
    this.isLoaded = true;
});
this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
    Debug.Log("RewardedVideo ad failed to load with error: " + error);
});
this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
    Debug.Log("RewardedVideo ad logged impression.");
});
this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
    Debug.Log("RewardedVideo ad clicked.");
});

this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
    Debug.Log("Rewarded video ad did close.");
    if (this.rewardedVideoAd != null) {
        this.rewardedVideoAd.Dispose();
    }
});
...

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

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

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

...
this.rewardedVideoAd.LoadAd();
...

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

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

public void ShowRewardedVideo()
{
    if (this.isLoaded) {
        this.rewardedVideoAd.Show();
        this.isLoaded = false;
    } else {
        Debug.Log("Ad not loaded. Click load to request an ad.");
    }
}

التحقق من المكافأة جهة الخادم

نظرة عامة

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

1. تطلب مجموعة SDK لـ Audience Network إعلان فيديو بمكافأة باستخدام المعلمات التالية:
   • placementId: معرف موضع Audience Network
   • RewardData - كائن RewardData يتكون من UserId يمثل معرف المستخدم وCurrency يمثل المكافأة الفعلية في اللعبة.
2. بعد اكتمال عرض الفيديو، يقوم خادم فيسبوك بترحيل هذه القيم إلى نقطة النهاية المحددة التي تستخدمها، بالإضافة إلى المفتاح السري للتطبيق ومعرف المعاملة الفريد.
3. وبمجرد الاستلام، يتحقق الخادم من الطلب ويقوم بالاستجابة كما يلي:
   • 200 response: الطلب صالح ويجب تسليم المكافأة
   • Non 200 response: الطلب غير صالح ويجب ألا يتم تسليم المكافأة.
4. وفور اكتمال عرض الفيديو، يتم عرض بطاقة النهاية ويتم تشغيل أحد الأحداث التالية.
   • RewardedVideoAdDidSucceed - يتم تشغيله فقط إذا تم استلام استجابة 200 أثناء الخطوة الثالثة.
   • RewardedVideoAdDidFail - يتم تشغيله فقط إذا تم استلام استجابة أخرى بخلاف 200 أثناء الخطوة الثالثة.

سيبدو سير العمل كما يلي:

التنفيذ

بعد تهيئة كائن الفيديو بمكافأة، يجب عليك تمرير معرف مستخدم ومبلغ المكافأة إلى بيانات الإعلان بمكافأة قبل تحميل الإعلان. يمكن القيام بذلك من خلال الفئة RewardData. يتوفر معرف المستخدم ومبلغ المكافأة في شكل سلاسل. على سبيل المثال:

public class RewardedVideoAdTest : MonoBehaviour
{
  ...
  private bool isLoaded;
  private RewardedVideoAd rewardedVideoAd;

  public void LoadRewardedVideo()

    //Set the rewarded ad data
    RewardData rewardData = new RewardData();
    rewardData.UserId = "USER_ID";
    rewardData.Currency = "REWARD_ID";

    // Instantiate RewardedVideoAd with reward data
    this.rewardedVideoAd = new RewardedVideoAd("YOUR_PLACEMENT_ID", rewardData);
    this.rewardedVideoAd.Register(this.gameObject);

    // Set delegates to get notified on changes or when the user interacts with the ad.
    this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
        Debug.Log("RewardedVideo ad loaded.");
        this.isLoaded = true;
    });
    this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
        Debug.Log("RewardedVideo ad failed to load with error: " + error);
    });
    this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
        Debug.Log("RewardedVideo ad logged impression.");
    });
    this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
        Debug.Log("RewardedVideo ad clicked.");
    });
    this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
        Debug.Log("Rewarded video ad did close.");
        if (this.rewardedVideoAd != null) {
            this.rewardedVideoAd.Dispose();
        }
    });

    // For S2S validation you need to register the following two callback
    this.rewardedVideoAd.RewardedVideoAdDidSucceed = (delegate() {
        Debug.Log("Rewarded video ad validated by server");
    });
    this.rewardedVideoAd.RewardedVideoAdDidFail = (delegate() {
        Debug.Log("Rewarded video ad not validated, or no response from server");
    });       

    this.rewardedVideoAd.loadAd();
  }
  ...
}

لكي يتم إعلام تطبيقك بما إذا كان قد تم التحقق من المكافأة أم لا، ستحتاج إلى تنفيذ الاستدعاءات RewardedVideoAdDidSucceed وRewardedVideoAdDidFail، بالإضافة إلى استدعاءات أخرى لـ RewardedVideoAd.

بعد تحميل الإعلان، يمكنك عرض الإعلان بالأسلوب Show مثل RewardedVideoAd العادي.