إضافة إعلانات البانر وإعلانات المستطيل المتوسط إلى تطبيق Android

تتيح لك Audience Network إمكانية تحقيق أرباح من تطبيقات Android من خلال إعلانات فيسبوك. يوضح هذا الدليل كيفية إضافة إعلانات البانر وإعلانات المستطيل المتوسط إلى تطبيقك.

You can change placements in Monetization Manager to the Medium Rectangle format if these were previously configured as Banner for bidding. Similarly, for any new medium rectangle placements, navigate to the placement settings page in Monetization Manager and select Medium Rectangle (not Banner).

Placements will deliver as normal even if they are not changed to the medium rectangle format. However, to avoid confusion, we recommend that you change these placements to medium rectangle.

وإذا كنت مهتمًا بالأنواع الأخرى للوحدات الإعلانية، فاطلع على قائمة الأنواع المتوفرة.

احرص على إكمال دلائل إعداد Android قبل المتابعة.

خطوات إعلان البانر وإعلان المستطيل المتوسط

الخطوة الأولى: إضافة حاوية تخطيط لإعلان البانر

الخطوة الثانية: تنفيذ البانر في "نشاطك"

الخطوة الثالثة: إضافة أداة تتبع أداء الإعلان

الخطوة الأولى: إضافة حاوية تخطيط لإعلان البانر

في ملف التخطيط (على سبيل المثال: /res/layout/activity_main.xml)، أضف تخطيطًا يعمل كحاوية للإعلان.
تذكر المعرف الذي قمت بتعيينه هنا حيث إنك ستضعه لاحقًا في الرمز.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
...
>
...
<LinearLayout
android:id="@+id/banner_container"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_alignParentBottom="true"
android:orientation="vertical"
app:layout_constraintBottom_toBottomOf="parent"
/>
...
</RelativeLayout>

الخطوة الثانية: تنفيذ البانر في "نشاطك"

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

import com.facebook.ads.*;

بعد ذلك، أنشئ مثيلاً لكائن AdView وقدم طلبًا لتحميل إعلان. نظرًا لأن AdView هو فئة فرعية من View، فيمكنك إضافتها إلى نطاق بنية العرض تمامًا مثل أي عرض آخر:

private AdView adView;

@Override
public void onCreate(Bundle savedInstanceState) {
...
// Instantiate an AdView object. 
// NOTE: The placement ID from the Facebook Monetization Manager identifies your App.
// To get test ads, add IMG_16_9_APP_INSTALL# to your placement id. Remove this when your app is ready to serve real ads.

adView = new AdView(this, "IMG_16_9_APP_INSTALL#YOUR_PLACEMENT_ID", AdSize.BANNER_HEIGHT_50);

// Find the Ad Container
LinearLayout adContainer = (LinearLayout) findViewById(R.id.banner_container);

// Add the ad view to your activity layout
adContainer.addView(adView);

// Request an ad
adView.loadAd();
}

إذا كنت تحاول تطوير تطبيقك لجهاز لوحي، فجرّب استخدام الحجم AdSize.BANNER_HEIGHT_90 كبديل. وفي كل الحالات، يكون عرض البانر مرنًا بحد أدنى 320 بيكسل.

أخيرًا، أضف الرمز التالي في وظيفة onDestroy() لدى نشاطك لتوفير المصادر التي يستخدمها AdView:

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

بمجرد تشغيل الرمز أعلاه، ستظهر استجابة على النحو التالي:



إذا كنت تستخدم محاكي Google Android الافتراضي، فستتم إضافة سطر الرمز البرمجي التالي قبل تحميل أي إعلان اختباري:
AdSettings.addTestDevice("HASHED ID");.

استخدم معرف التجزئة المطبوع في سجل رسائل النظام "log cat" عندما تقدم طلبًا لأول مرة لتحميل إعلان على أحد الأجهزة.

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

الخطوة الثالثة: إضافة أداة تتبع أداء الإعلان

والآن، بعد تشغيل الرمز الأساسي، يمكنك تعيين AdListener في AdView لتتبع أحداث معينة:

import android.widget.Toast;
...

protected void onCreate(Bundle savedInstanceState) {
...
AdListener adListener = new AdListener() {
@Override
public void onError(Ad ad, AdError adError) {
// Ad error callback
Toast.makeText(
MainActivity.this,
"Error: " + adError.getErrorMessage(),
Toast.LENGTH_LONG)
.show();
}

@Override
public void onAdLoaded(Ad ad) {
// Ad loaded callback
}

@Override
public void onAdClicked(Ad ad) {
// Ad clicked callback
}

@Override
public void onLoggingImpression(Ad ad) {
// Ad impression logged callback
}
};

// Request an ad
adView.loadAd(adView.buildLoadAdConfig().withAdListener(adListener).build());
}

أحجام بانر الإعلان

تدعم Audience Network ثلاثة أحجام للإعلان يمكن استخدامها في AdView. ويمتاز عرض وحدة البانر بالمرونة ويكون 320 بيكسل بحد أدنى، ويتم تحديد الارتفاع فقط.

تنسيق الإعلان مرجع AdSize الحجم التوصية

بانر قياسي

BANNER_50

320x50

يناسب هذا البانر الهواتف بشكل أفضل

بانر كبير

BANNER_90

320x90

يناسب هذا البانر الأجهزة اللوحية والأجهزة الأكبر بشكل أفضل

مستطيل متوسط

RECTANGLE_HEIGHT_250

300x250

يناسب هذا التنسيق المواجز التي يمكن التمرير خلالها أو شاشات نهاية المستوى

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