إعلانات البنرات

البنرات الإعلانية هي إعلانات صغيرة تظهر عادةً في الجزء العلوي أو السفلي من شاشة التطبيق

المتطلبات

قبل دمج البنرات الإعلانية في تطبيق، عليك إجراء الخطوات الواردة في دليل بدء الاستخدام لدمج الحزمة البرمجية YaftaMobile SDK في مشروعك، إذا لم يسبق لك إجراؤها.

تحميل إعلانات البنر

يتم طلب وعرض إعلان بنر عن طريق استخدام كائن من نوع YaftaMobileBannerView و الذي يمكن إنشاؤه إما من خلال التعليمات البرمجية أو ملف التصميم Layout XML. لطلب إعلان جديد، قم باستدعاء الدالة ()requestAd التي تقوم بتنفيذ Background Thread لجلب إعلان من شبكة YaftaMobile. يمكن تحميل وعرض إعلان واحد فقط بواسطة كائن YaftaMobileBannerView معين في وقت معين.

الطريقة الأولى: باستخدام ملف التصميم Layout XML

أولاً، أضف العنصر التالي إلى ملف التصميم Layout XML للنشاط Activity ذي الصلة، لوضع البنر الإعلاني في الموقع الذي اخترته:

<com.mustamara.yaftamobile.sdk.ads.banner.YaftaMobileBannerView
 android:id="@+id/bannerView" 
 android:layout_width="320dp" 
 android:layout_height="50dp" 
 yaftamobile:adSize="S320X50"
/>

ثم أضف الكود التالي للنشاط Activity ذي الصلة:

YaftaMobileBannerView bannerView;
bannerView= (YaftaMobileBannerView)findViewById(R.id.BannerView);
bannerView.requestAd(new AdRequest());

الطريقة الثانية: باستخدام الكود البرمجي فقط

بدلاً من ذلك ، يمكنك استخدام الكود الخالص فقط:

@Override
public void onCreate(Bundle savedInstanceState) {
 super.onCreate(savedInstanceState);
 setContentView(R.layout.main);

/* Programmatically create the YaftaMobileBannerView */
 YaftaMobileBannerView bannerView;
 bannerView = new YaftaMobileBannerView(this,AdSize.S320X50);

 RelativeLayout layout;
 layout = (RelativeLayout) findViewById(R.id.bannerLayout); 

/* Set the correct width and height of the ad */
 RelativeLayout.LayoutParams lp;
 lp = new RelativeLayout.LayoutParams(
  LayoutParams.MATCH_PARENT,
  LayoutParams.WRAP_CONTENT);
 
/* Add view to layout */
 layout.addView(this.bannerView, lp);

 
 bannerView.requestAd(new AdRequest());
}

مقاسات البنر الإعلاني

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

لتحديد حجم البنر الإعلاني قم بتمرير الحجم إلى الدالة ()setAdSize أو من خلال ملف التصميم Layout XML عند إنشاء YaftaMobileBannerView في Java أو XML.

أحجام الإعلانات التالية مدعومة:

مثال على كيفية ضبط الحجم المرن باستخدام كود Java:

bannerView.setAdSize(AdSize.FLEXIBLE);

أو داخل ملف التصميم Layout XML:

<com.mustamara.yaftamobile.sdk.ads.banner.YaftaMobileBannerView
 ...
 yaftamobile:adSize="FLEXIBLE"
 ...
/>

لتحديد حجم الإعلان يدويًا استخدم ما يلي:

bannerView.setAdSize(AdSize.S320X50);

بدلاً من ذلك ، يمكنك أيضًا تحديد الحجم داخل ملف التصميم Layout XML:

<com.mustamara.yaftamobile.sdk.ads.banner.YaftaMobileBannerView
 ...
 yaftamobile:adSize="S320X50"
 ...
/>

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

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

تتضمن واجهة المستمع AdListener Interface الأحداث التالية:

public void onAdLoaded()

ويتم تنشيطه عندما يتم تحميل الإعلان بنجاح.

public void onError(AdError adError)

ويتم تنشيطه عند حدوث فشل أثناء تحميل الإعلان.

public void onAdClicked()

ويتم تنشيطه عند النقر على الإعلان.

استخدم ما يلي للاستماع إلى حدث onAdLoaded:

public class MainActivity extends Activity implements AdListener {
 @Override
 public void onAdLoaded(){
 Toast.makeText(getApplicationContext(),
 "Banner successfully loaded.", Toast.LENGTH_SHORT).show();
 }
 
 // ... other AdListener methods ...
}

وتمرير نشاطك إلى YaftaMobileBannerView

bannerView.setAdListener(this);

إعدادات متقدمة

معدل التحديث

معدل التحديث هو الفاصل الزمني (بالثواني) حتى يتم تحديث كائن YaftaMobileBannerView المستخدم في طلب وعرض الإعلانات. يجب أن يتراوح معدل التحديث بين 30 و 120 ثانية، وسيتم تعيين معدل التحديث الإفتراضي إلى 60 ثانية إذا لم يتم تعيينه. يمكن تغيير معدل التحديث الافتراضي باستخدام الدالة ()setRefreshRate، والتي تستقبل عدد الثوانٍ كوسيط.

مثال على كيفية تعيين معدل التحديث ل 45 ثانية باستخدام كود Java:

bannerView.setRefreshRate(45); // 45 ثانية

أو بدلاً من ذلك عن طريق ملف التصميم Layout XML:

<com.mustamara.yaftamobile.sdk.ads.banner.YaftaMobileBannerView
 ...
 yaftamobile:refreshRate="45"
 ...
/>