‏‎Meta Audience Network‎‏

بدء الاستخدام في نظام Android

أصبحت Audience Network الآن مخصصة لعروض الأسعار فقط

تستخدم Audience Network الآن عروض الأسعار فقط لتعبئة الإعلانات في تطبيقات iOS وAndroid. وستحتاج إلى نقل تطبيقاتك التي تعمل بنظام "تعاقب العرض" إلى نظام "عروض الأسعار" لتحقيق الأرباح باستخدام Audience Network.

يمكنك قراءة المزيد في منشور مدونة Audience Network.

تتيح لك Meta Audience Network إمكانية تحقيق أرباح من تطبيقات Android باستخدام إعلانات فيسبوك. وسيرشدك هذا الدليل عبر كل الخطوات اللازمة لدمج مجموعة SDK.

المتطلبات الأساسية

تأكد من تثبيت Android Studio.

الرجاء مراجعة الأسئلة المتكررة بشأن أدني إصدار لنظام التشغيل تدعمه Audience Network SDK.

الخطوة الأولى: إنشاء مشروع جديد

الخطوة الثانية: تضمين مجموعة SDK

الخطوة الثالثة: وضع خطأ الدمج (اختياري)

الخطوة الأولى: إنشاء مشروع جديد

يمكنك تخطي هذه الخطوة إذا كان لديك بالفعل مشروع تريد دمج Audience Network فيه.

ابدأ تشغيل Android Studio وحدّد "بدء مشروع Android Studio جديد"



قم بتسمية المشروع وحدّد نطاق شركتك.
سيصبح اسم الحزمة هو المعرف إذا قررت تحميل تطبيقك إلى متجر Google Play.



قم بتعيين الحد الأدنى من إصدار مجموعة Android SDK. تتطلب Audience Network إصدار API 15 أو الأحدث، ولكن لأغراض
هذه العينات، سنستخدم إصدار API 21.



إضافة نشاط فارغ إلى المشروع



قم بتسمية النشاط الأولي وانقر على "إكمال".

الخطوة الثانية: تضمين مجموعة SDK

تشكل مجموعة Audience Network SDK جزءًا من مجموعة Facebook SDK. اتبع الخطوات التالية لتنزيلها وتضمينها في مشروعك:

باستخدام Gradle



أضف عبارة التحويل البرمجي التالية إلى build.gradle (not project!) على مستوى التطبيق، لاستخدام أحدث مجموعة Audience Network SDK:

dependencies {
compile 'com.facebook.android:audience-network-sdk:6.+'
}

إذا كان هناك مشكلات في حل مجموعة Audience Network SDK، فتأكد من مزامنة ملف Gradle وحاول إعادة تشغيل Android Studio.

التثبيت اليدوي (لا يوصى به)

إذا كنت تستخدم Intellij IDEA أو Eclipse، فقم بتنزيل مجموعة Audience Network SDK لنظام Android واستخراجها. ضمن المجلد AudienceNetwork/bin، انسخ الملف AudienceNetwork.aar وضعه في المجلد /libs داخل المشروع، وقد تحتاج إلى إنشاء الدليل إذا لم يكن موجودًا بالفعل. ثم أضف السطور التالية إلى build.gradle في التطبيق:

repositories {
flatDir {
dirs 'libs'
}
}

dependencies {
...
compile(name: 'AudienceNetwork', ext: 'aar')
}

إذا كنت تستخدم AudienceNetwork.jar للمشروع، فضمن المجلد AudienceNetwork/bin، أعد تسمية AudienceNetwork.aar إلى AudienceNetwork.zip واستخرج الملف classes.jar وأعد تسميته إلى AudienceNetwork.jar، ثم ضع الملف AudienceNetwork.jar في المجلد /libs داخل المشروع، وقد تحتاج إلى إنشاء الدليل إذا لم يكن موجودًا بالفعل. تأكد من أن واجهة مستخدم IDE تعرض هذا التغيير. إذا كنت تستخدم Intellij IDEA أو Eclipse، فانقر بالزر الأيمن على الملف libs/AudienceNetwork.jar واختر "إضافة كمكتبة".

على الرغم من أنه غير مطلوب، فإننا نوصي بإعداد مشروعك ليعمل مع خدمات Google Play كما هو مشار إليه هنا. وهذا سيمكّن مجموعة Audience Network SDK من جلب معرف الإعلان بشكل أكثر فعالية.

الخطوة الثالثة: وضع خطأ الدمج (اختياري)

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

  • INTEGRATION_ERROR_CRASH_DEBUG_MODE: ستحدث أعطال في التطبيق إذا كان الإصدار لديه نظام Android بحالة FLAG_DEBUGGABLE، وغير ذلك سيتم استخدام INTEGRATION_ERROR_CALLBACK_MODE (موصى به أثناء الاختبار).
  • INTEGRATION_ERROR_CALLBACK_MODE: سيعمل التطبيق على تنفيذ الاستدعاء AdListener.onError(Ad, AdError) إذا تم اكتشاف خطأ في الدمج.
// Example for setting the SDK to crash when in debug mode
AdSettings.setIntegrationErrorMode(INTEGRATION_ERROR_CRASH_DEBUG_MODE);

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