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

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

الخطوات التفصيلية

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

الخطوة الثانية: عرض إعلانات الفيديو بمكافأة في نشاطك

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

أضف الرمز البرمجي التالي أعلى نشاطك لاستيراد مجموعة SDK لإعلانات فيسبوك:

import com.facebook.ads.*;

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

private final String TAG = RewardedVideoAdActivity.class.getSimpleName();
private RewardedVideoAd rewardedVideoAd;

@Override
public void onCreate(Bundle savedInstanceState) {
    ...
    // Instantiate a RewardedVideoAd object. 
    // NOTE: the placement ID will eventually identify this as your App, you can ignore it for
    // now, while you are testing and replace it later when you have signed up.
    // While you are using this temporary code you will only get test ads and if you release
    // your code like this to the Google Play your users will not receive ads (you will get
    // a no fill error).
    rewardedVideoAd = new RewardedVideoAd(this, "YOUR_PLACEMENT_ID");
    RewardedVideoAdListener rewardedVideoAdListener = new RewardedVideoAdListener() {
        @Override
        public void onError(Ad ad, AdError error) {
            // Rewarded video ad failed to load
            Log.e(TAG, "Rewarded video ad failed to load: " + error.getErrorMessage());
        }

        @Override
        public void onAdLoaded(Ad ad) {
            // Rewarded video ad is loaded and ready to be displayed  
            Log.d(TAG, "Rewarded video ad is loaded and ready to be displayed!");
        }

        @Override
        public void onAdClicked(Ad ad) {
            // Rewarded video ad clicked
            Log.d(TAG, "Rewarded video ad clicked!");
        }

        @Override
        public void onLoggingImpression(Ad ad) {
            // Rewarded Video ad impression - the event will fire when the 
            // video starts playing
            Log.d(TAG, "Rewarded video ad impression logged!");
        }

        @Override
        public void onRewardedVideoCompleted() {
            // Rewarded Video View Complete - the video has been played to the end.
            // You can use this event to initialize your reward
            Log.d(TAG, "Rewarded video completed!");

            // Call method to give reward
            // giveReward();
        }

        @Override
        public void onRewardedVideoClosed() {
            // The Rewarded Video ad was closed - this can occur during the video
            // by closing the app, or closing the end card.
            Log.d(TAG, "Rewarded video ad closed!");
        }
    };
    rewardedVideoAd.loadAd(
            rewardedVideoAd.buildLoadAdConfig()
                    .withAdListener(rewardedVideoAdListener)
                    .build());
    ...
}

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

السيناريو الأول: اعرض الإعلان فورًا بمجرد تحميله بنجاح. يمكن تعديل الأسلوب onAdLoaded() المذكور أعلاه لعرضه كما يلي:

private RewardedVideoAd rewardedVideoAd;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    // Instantiate a RewardedVideoAd object. 
    // NOTE: the placement ID will eventually identify this as your App, you can ignore it for
    // now, while you are testing and replace it later when you have signed up.
    // While you are using this temporary code you will only get test ads and if you release
    // your code like this to the Google Play your users will not receive ads (you will get
    // a no fill error).
    rewardedVideoAd = new RewardedVideoAd(this, "YOUR_PLACEMENT_ID");
    RewardedVideoAdListener rewardedVideoAdListener = new RewardedVideoAdListener() {
        ...
        @Override
        public void onAdLoaded(Ad ad) {
            // Rewarded video ad is loaded and ready to be displayed  
            rewardedVideoAd.show();
        }
        ...
    };
    rewardedVideoAd.loadAd(
            rewardedVideoAd.buildLoadAdConfig()
                    .withAdListener(rewardedVideoAdListener)
                    .build());
    ...
}

السيناريو الثاني: اعرض الإعلان خلال بضع ثوان أو دقائق بعد تحميله بنجاح. ويجب التحقق مما إذا كان الإعلان قد تم إبطاله قبل عرضه أم لا.

يجب عليك متابعة الفكرة أدناه، ولكن يرجى عدم نسخ الرمز البرمجي في مشروعك لأنه مجرد مثال:

private RewardedVideoAd rewardedVideoAd;

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    // Instantiate a RewardedVideoAd object. 
    // NOTE: the placement ID will eventually identify this as your App, you can ignore it for
    // now, while you are testing and replace it later when you have signed up.
    // While you are using this temporary code you will only get test ads and if you release
    // your code like this to the Google Play your users will not receive ads (you will get
    // a no fill error).
    rewardedVideoAd = new RewardedVideoAd(this, "YOUR_PLACEMENT_ID");
    RewardedVideoAdListener rewardedVideoAdListener = new RewardedVideoAdListener() {
        ...
    };
    // load the ad
    rewardedVideoAd.loadAd(
            rewardedVideoAd.buildLoadAdConfig()
                    .withAdListener(rewardedVideoAdListener)
                    .build());

    // Here is just an example for displaying the ad with delay
    // Please call this method at appropriate timing in your project
    showAdWithDelay();
}

private void showAdWithDelay() {
    /**
     * Here is an example for displaying the ad with delay;
     * Please do not copy the Handler into your project
     */
    // Handler handler = new Handler();
    handler.postDelayed(new Runnable() {
        public void run() {
            // Check if rewardedVideoAd has been loaded successfully
            if (rewardedVideoAd == null || !rewardedVideoAd.isAdLoaded()) {
                return;
            }
            // Check if ad is already expired or invalidated, and do not show ad if that is the case. You will not get paid to show an invalidated ad.
            if (rewardedVideoAd.isAdInvalidated()) {
                return;
            }
            rewardedVideoAd.show();
        }
    }, 1000 * 60 * 15); // Show the ad after 15 minutes
}

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

@Override
protected void onDestroy() {
    if (rewardedVideoAd != null) {
        rewardedVideoAd.destroy();
        rewardedVideoAd = null;
    }
    super.onDestroy();
}

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

نظرة عامة

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

1. تقوم مجموعة Audience Network SDK بطلب إعلان فيديو بمكافأة باستخدام المعلمات التالية:
   • معرف موضع Audience Network
   • معرف مستخدم فريد - سمة تستخدمها لتعريف مستخدم فريد. على سبيل المثال، معرّف رقمي
   • قيمة المكافأة - قيمة المكافأة التي تريد منحها للمستخدم. على سبيل المثال، 100 قطعة نقدية
2. بعد اكتمال عرض الفيديو، يقوم خادم فيسبوك بترحيل هذه القيم إلى نقطة النهاية المحددة التي تستخدمها، بالإضافة إلى المفتاح السري للتطبيق ومعرّف المعاملة الفريد.
3. وبمجرد الاستلام، يقوم الخادم بالتحقق من الطلب ويقوم بالاستجابة بالطريقة التالية:
   • استجابة 200: تعني أن الطلب صالح ويجب منح المكافأة
   • استجابة ليس 200: تعني أن الطلب غير صالح ويجب عدم منح المكافأة.
4. وبمجرد اكتمال عرض الفيديو، يتم عرض بطاقة الإنهاء وسيتم تشغيل أحد الأحداث التالية.
   • onRewardServerSuccess - يتم تشغيله فقط إذا تم تلقي استجابة 200 أثناء الخطوة الثالثة.
   • onRewardServerFailed - يتم تشغيله فقط إذا تم تلقي استجابة بخلاف 200 أثناء الخطوة الثالثة.

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

التنفيذ

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

private RewardedVideoAd rewardedVideoAd;

private void loadRewardedVideoAd { 
    // Instantiate a RewardedVideoAd object. 
    // NOTE: the placement ID will eventually identify this as your App, you can ignore it for
    // now, while you are testing and replace it later when you have signed up.
    // While you are using this temporary code you will only get test ads and if you release
    // your code like this to the Google Play your users will not receive ads (you will get
    // a no fill error).
    rewardedVideoAd = new RewardedVideoAd(this, "YOUR_PLACEMENT_ID");
    RewardedVideoAdListener rewardedVideoAdListener = new RewardedVideoAdListener() {
        ...
    };

    // Create the rewarded ad data
    RewardData rewardData = new RewardData("YOUR_USER_ID", "YOUR_REWARD");

    rewardedVideoAd.loadAd(
            rewardedVideoAd.buildLoadAdConfig()
                    .withAdListener(rewardedVideoAdListener)
                    .withRewardData(rewardData)
                    .build());
}

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

@Override
public void onRewardServerSuccess() {
    // Rewarded video ad validated
}

@Override
public void onRewardServerFailed() {
    // Rewarded video ad not validated or no response from server  
}