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

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

المتطلبات

• Adobe Flash Builder الإصدار 4.7
• Adobe AIR SDK الإصدار 22 أو أحدث
• SWF الإصدار 33

الخطوة 1: استيراد الإضافة YaftaMobile AIR Native إلى مشروعك.

أولاً ، قم باستيراد الإضافة YaftaMobile AIR Native إلى تطبيقك. نوصي بإنشاء مجلد في مشروعك للإضافات، ونسخ YaftaMobile.ane إلى هذا المجلد. ثم أضف هذا المجلد كمجلد إضافات في إعدادات المشروع

إذا كنت تستخدم Flash Builder ، فاتبع الخطوات التالية:

1. انقر بزر الماوس الأيمن على مشروعك من علامة التبويب مستكشف الحزم Package Explorer.
2. اختر خصائص Properties.
3. اختر Flex Build Path.
4. اختر تبويب Native Extensions من الشاشة الرئيسة .
5. انقر Add ANE (أو Add Folder)
6. استعرض للوصول إلى المجلد الذي قمت بتنزيل الإضافة به. تأكد من تحديد خيار Update AIR Application Descriptor.
7. اختر Flex Build Packaging.
8. اختر Android platform ، ثم حدد علامة التبويب Native Extensions وحدد مربع الحزمة **Package **بجوار اسم الإضافة
9. انتقل إلى Flex Compiler من منطقة التنقل اليسرى ، ثم أضف -swf-version = 33 إلى Additional compiler arguments

الخطوة 2: تحديث ملف App Descriptor

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

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

يجب أن يحتوي App Descriptor على ما يلي:

<manifestAdditions><![CDATA[
   <manifest android:installLocation="auto">
      <!-- These permissions are required for YaftaMobile. -->
      <uses-permission android:name="android.permission.INTERNET"/>
      <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
   
   
      
      <application>
         <!-- The app ID must be placed here. -->
         <meta-data android:name="com.yaftamobile.sdk.app.id" 
            android:value="YOUR-APPID" /> 

         
         <!-- Only required for interstitials -->
         <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" />
            </application>
         </manifest>
]]></manifestAdditions>

<extensions>
    <extensionID>com.yaftamobile.plugins.air</extensionID>
</extensions>

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

لعرض البنرات الإعلانية في تطبيقك استخدم الدالة 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 Native Extension داخل تطبيقك

 import com.yaftamobile.plugin.air.*;

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

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

استخدم ما يلي لإخفاء / إعادة إظهار البانر الإعلاني:

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

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

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

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

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

...
// INTERSTITIAL_LOADED تسجيل مستمع لحدث  
YaftaMobile.addEventListener(AdEvent.INTERSTITIAL_LOADED,onInterstitialLoaded);
...
// طلب إعلان بيني
YaftaMobile.loadInterstitial();
.....
// عرض الإعلان البيني 
protected function onInterstitialLoaded(ev:AdEvent):void{
    YaftaMobile.showInterstitial();
}

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

ترسل الإضافة YaftaMobile Native Extension إشعارات بالأحداث التي تقع خلال دورة حياة الإعلان. للاستماع إلى الأحداث الإعلانية، تحتاج إلى تسجيل مستمع عن طريق الدالة addEventListener(type:String, listener:Function) حيث

• type: هو اسم الحدث المراد الاستماع إليه
• listener: هي وظيفة يتم تنفيذها استجابة لوقوع الحدث

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

// يتم تنشيطه عند تحميل الإعلان بنجاح
public static const AD_LOADED:String = "onAdLoaded";

// يتم تنشيطه عند النقر على الإعلان
public static const AD_CLICKED:String = "onAdClicked";

// تم تنشيطه عند فشل تحميل الإعلان
public static const AD_ERROR:String = "onAdError";

// يتم تنشيطه عند تحميل إعلان بيني
public static const INTERSTITIAL_LOADED:String = "onInterstitialLoaded";

// يتم تنشيطه عند النقر على إعلان بيني
public static const INTERSTITIAL_CLICKED:String ="onInterstitialClicked";

// يتم تنشيطه عند حدوث فشل أثناء تحميل إعلان بيني
public static const INTERSTITIAL_ERROR:String ="onInterstitialError";

// يتم تنشيطه عند إغلاق إعلان بيني
public static const INTERSTITIAL_DISMISSED:String ="onInterstitialDismissed";

اختبار الدمج

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

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

YaftaMobile.setTestMode(true);