تتيح لك 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 // Please refer to Monetization Manager or Reporting API for final impression numbers } }; // Request an ad adView.loadAd(adView.buildLoadAdConfig().withAdListener(adListener).build()); }
تدعم Audience Network ثلاثة أحجام للإعلان يمكن استخدامها في AdView
. ويمتاز عرض وحدة البانر بالمرونة ويكون 320 بيكسل بحد أدنى، ويتم تحديد الارتفاع فقط.
تنسيق الإعلان | مرجع AdSize | الحجم | التوصية |
---|---|---|---|
بانر قياسي |
| 320x50 | يناسب هذا البانر الهواتف بشكل أفضل |
بانر كبير |
| 320x90 | يناسب هذا البانر الأجهزة اللوحية والأجهزة الأكبر بشكل أفضل |
مستطيل متوسط |
| 300x250 | يناسب هذا التنسيق المواجز التي يمكن التمرير خلالها أو شاشات نهاية المستوى |
اكتشف نماذج الرموز البرمجية لمجموعة Audience Network Android على Github. قم باستيراد المشروعات إلى IDE، ثم تشغيله على أي جهاز أو على المحاكي.
بمجرد أن تكون مستعدًا لتفعيل ونشر تطبيقك وتحقيق الأرباح، يجب تقديم تطبيقك للمراجعة بعد التأكد من التزامه بسياسات Audience Network ومعايير مجتمع فيسبوك.