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

تتيح حزمة التطوير البرمجي YaftaMobile Unity SDK للمطورين سرعة دمج إعلانات YaftaMobile في تطبيقات منصة Unity. تدعم الحزمة الإصدار 2.3 لنظام Android أو أحدث

الخطوة 1: استيراد حزمة YaftaMobile Unity إلى مشروعك.

داخل محرر Unity

• اختر من القائمة Custom Package < Import Package < Assets
• انتقل إلى المجلد حيث قمت بتنزيل YaftaMobile Unity SDK ، حدد YaftaMobile.unitypackage ، ثم انقر فوق فتح Open
• قم باستيراد جميع عناصر الحزمة عن طريق الضغط على الكل “All” ثم استيراد “Import”.

إذا كنت تستخدم ملف AndroidManifest.xml مخصصًا ولا تريد تجاوزه بالملف الموجود بحزمة التطوير، فما عليك سوى إلغاء تحديد “AndroidManifest.xml”. في هذه الحالة ، يجب عليك تحديث الملف يدويًا كما هو موضح في الخطوة التالية

• قم بسحب وإفلات ملف YaftaMobileManager.prefab الموجود في /Assets/Plugins/YaftaMobile/ إلى المشهد Unity scene بمشروعك.

الخطوة 2: تحديث ملف AndroidManifest.xml.

يجب إجراء التغييرات التالية في ملف AndroidManifest.xml حتى تتمكن من طلب وعرض إعلانات YaftaMobile.

• أضف الأذونات الإلزامية INTERNET, ACCESS_NETWORK_STATE
• أضف عنصر meta-data يسمى com.yaftamobile.sdk.appid، وقم بتعيين قيمته إلى معرف تطبيقك الذي يظهر على موقع YaftaMobile.
• (إلزامي لعرض الإعلانات البينية) أضف النشاط InterstitialActivity
• أضف أيضًا عنصر meta-data وقم بتعيين قيمته إلى إصدار Google Play services للعمل بشكل صحيح

يجب أن يحتوي ملف AndroidManifest.xml على ما يلي:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<meta-data android:name="com.yaftamobile.sdk.app.id"
android:value="<YOUR-APPID>" />

<activity android:configChanges="keyboard|keyboardHidden|orientation"
android:name="com.yaftamobile.sdk.ads.interstitial.InterstitialActivity" />

<!-- For Google Play Services (required by YaftaMobile) -->
<meta-data android:name="com.google.android.gms.version" 
android:value="@integer/google_play_services_version" />

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

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

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

قبل أن تتمكن من استخدام YaftaMobile SDK في التعليمات البرمجية الخاصة بك ، تحتاج إلى إضافة namespace declaration التالي:

using YaftaMobileUnity;

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

#if UNITY_ANDROID
YaftaMobile.showBanner(AdSize.FLEXIBLE, BannerPosition.BOTTOM_CENTER , 60);
#endif

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

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

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

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

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

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

...
void Start () {
   #if UNITY_ANDROID
   // onInterstitialLoadedEvent تسجيل مستمع لحدث  
   YaftaMobileManager.onInterstitialLoadedEvent += onInterstitialLoadedEvent;
   #endif
}

...
// طلب إعلان بيني
#if UNITY_ANDROID
YaftaMobile.loadInterstitial();
#endif
.....
// عرض الإعلان البيني 
void onInterstitialLoadedEvent(){
  YaftaMobile.showInterstitial ();
}

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

ترسل حزمة التطوير البرمجي YaftaMobile Unity SDK إشعارات بالأحداث التي تقع خلال دورة حياة الإعلان. للاستماع إلى الأحداث الإعلانية، تحتاج إلى تسجيل مستمع عن طريق += operator

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

// يتم تنشيطه عند تحميل الإعلان بنجاح
public static event Action onAdLoadedEvent;

// يتم تنشيطه عند النقر على الإعلان
public static event Action onAdClickedEvent;

// تم تنشيطه عند فشل تحميل الإعلان
public static event Action< int , string> onAdErrorEvent;

// يتم تنشيطه عند تحميل إعلان بيني
public static event Action onInterstitialLoadedEvent;

// يتم تنشيطه عند النقر على إعلان بيني
public static event Action onInterstitialClickedEvent;

// يتم تنشيطه عند حدوث فشل أثناء تحميل إعلان بيني
public static event Action< int , string> onInterstitialErrorEvent;

// يتم تنشيطه عند إغلاق إعلان بيني
public static event Action onInterstitialDismissedEvent;

The following code shows how to subscribe to onInterstitialErrorEvent event

void Start () {
....
#if UNITY_ANDROID
YaftaMobileManager.onInterstitialErrorEvent += onInterstitialErrorEvent;
#endif
.....
}

void onInterstitialErrorEvent(int code,string message){
    Debug.Log ("onInterstitialErrorEvent fired with code: " + code+ " ,and message: "+ message); // print error code and message
}

اختبار الدمج

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

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

#if UNITY_ANDROID
YaftaMobile.setTestMode(true);
#endif