بدء الاستخدام

تتيح الإضافة YaftaMobile Cordova Plugin للمطورين إمكانية دمج إعلانات YaftaMobile بسرعة في تطبيقات Cordova. تدعم الإضافة الإصدار 2.3 لنظام Android أو أحدث

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

  • Cordova الإصدار 5.0.0 أو أحدث
  • أحدث إصدار ل Google Play Services

الخطوة 1: أضافة YaftaMobile Cordova Plugin إلى مشروعك.

  1. افتح سطر الأوامر
  2. انتقل إلى مجلد مشروع cordova الخاص بك.
  3. قم بتثبيت YaftaMobile من github باستخدام واجهة سطر أوامر cordova.

قم بتنفيذ الأمر التالي لتثبيت YaftaMobile Cordova Plugin

$  cordova plugin add https://github.com/MustamaraLabs/yaftamobile-cordova-plugin.git --variable APP_ID="your-app-id"

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

لعرض البانرات الإعلانية في تطبيقك، قم باستدعاء الدالة showBanner(adSize, bannerPosition, refreshRate) حيث:

  • adSize: أحد أحجام الإعلانات المدعومة التالية : FLEXIBLE, S300X50, S320X50, S468X60, S728X90
  • bannerPosition: هو أحد الثوابت التالية التي تحدد موضع ظهور الإعلان: TOP_CENTER, TOP_LEFT, TOP_RIGHT, BOTTOM_CENTER, BOTTOM_LEFT, BOTTOM_RIGHT
  • refreshRate: معدل التحديث وهو فاصل زمني تترواح مدته بين 30 و 120 ثانية

أضف الكود التالي لإظهار إعلان بنر بحجم مرن أسفل منتصف شاشة التطبيق ومعدل تحديثه 60 ثانية:

YaftaMobile.showBanner(AdSize.FLEXIBLE, BannerPosition.BOTTOM_CENTER, 60);

أضف الكود التالي لإخفاء/ إعادة إظهار إعلان البانر:

YaftaMobile.pauseBanner();  // إخفاء البنر إذا كان مرئيا
YaftaMobile.resumeBanner();  // عرض البنر إذا لم يكن مرئيا

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

لعرض إعلان بيني يجب تحميله أولاً عن طريق استدعاء الدالة ()loadInterstitial ، وفي حالة تحميله بنجاح يجب استدعاء الدالة ()showInterstitial لعرض الإعلان على الشاشة.

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

في ما يلي مثال للتعليمات البرمجية التي تبين عملية من خطوتين لعرض الإعلان الخلالي.

...
// onInterstitialLoaded تسجيل مستمع لحدث  
document.addEventListener(YaftaMobile.Event.onInterstitialLoaded, 
app.onInterstitialLoaded, false);
...
// طلب إعلان بيني
YaftaMobile.loadInterstitial();
.....
// عرض الإعلان البيني 
onInterstitialLoaded: function ()
{
  YaftaMobile.showInterstitial();
}

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

ترسل الإضافة YaftaMobile Cordova Plugin إشعارات بالأحداث التي تقع خلال دورة حياة الإعلان. للاستماع إلى الأحداث الإعلانية، تحتاج إلى تسجيل مستمع عن طريق الدالة ()document.addEventListener

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

Event :{
  // يتم تنشيطه عند تحميل الإعلان بنجاح
  onAdLoaded: "onAdLoaded",

  // يتم تنشيطه عند النقر على الإعلان
  onAdClicked: "onAdClicked",

  // تم تنشيطه عند فشل تحميل الإعلان
  onAdError: "onAdError",

  // يتم تنشيطه عند تحميل إعلان بيني
  onInterstitialLoaded: "onInterstitialLoaded",

  // يتم تنشيطه عند النقر على إعلان بيني
  onInterstitialClicked: "onInterstitialClicked",

  // يتم تنشيطه عند حدوث فشل أثناء تحميل إعلان بيني
  onInterstitialError: "onInterstitialError",

  // يتم تنشيطه عند إغلاق إعلان بيني
  onInterstitialDismissed: "onInterstitialDismissed"
 }

يوضح الكود التالي كيفية التسجيل للاستماع إلى حدث onInterstitialError


onDeviceReady: function() {
   document.addEventListener(YaftaMobile.Event.onInterstitialError,
 app.onInterstitialError, false);
},
onInterstitialError: function (result){
  console.log('code: ' + result.errorCode + ' ,msg: '+ result.errorMessage);  // print error code and message
}

اختبار الدمج

لاختبار الدمج والتحقق من أن دمج الإضافة YaftaMobile Cordova Plugin مع التطبيق قد تم بشكل صحيح. يمكنك تمكين وضع الاختبار عن طريق استدعاء الدالة setTestMode(boolean testMode)

أضف ما يلي لتمكين وضع الاختبار:

YaftaMobile.setTestMode(true);