دمج Meta Audience Network مع عروض الأسعار

يوضّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من "شبكة جمهور Facebook" باستخدام توسّط AdMob، التي تشمل عمليات دمج عروض الأسعار. ويتناول هذا الدليل كيفية إضافة Meta Audience Network إلى إعدادات التوسّط لوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوِّل Meta Audience Network في Android تطبيق.

عمليات الدمج وأشكال الإعلانات المتوافقة

تتوفر لبرنامج "محوِّل التوسّط" في Meta Audience Network الإمكانات التالية:

التكامل
عروض الأسعار
العرض بدون انقطاع  1
التنسيقات
بانر
إعلان بيني
تم منح المكافأة
إعلان بيني يضمّ مكافأة
مدمجة مع المحتوى

1 أصبحت منصّة Meta Audience Network تتيح عروض الأسعار فقط في عام 2021.

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

  • إكمال التوسّط دليل البدء

  • المستوى 21 أو إصدار أحدث لواجهة برمجة التطبيقات Android

الخطوة 1: إعداد الإعدادات في واجهة مستخدم "شبكة جمهور Facebook"

سجِّل الدخول إلى صفحة البدء في "مركز إدارة النشاط التجاري".

انقر على البدء ثم على إنشاء حساب جديد.

املأ الحقول المطلوبة بتفاصيل نشاطك التجاري وانقر على التالي.

إنشاء موقع

بعد ملء المعلومات المطلوبة، سيُطلب منك إنشاء موقع لتطبيقك. أدخِل الاسم المطلوب للموقع الخاص بتطبيقك وانقر على التالي.

بعد ذلك، اختَر المنصة التي تريد تحقيق الربح منها.

أضِف تفاصيل تطبيقك وانقر على التالي.

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

اختَر Google AdMob كمنصّة توسّط، ثمّ انقر على إنشاء موضع إعلان.

اختَر تنسيقًا، واملأ النموذج وانقر على إنشاء.

دوِّن رقم تعريف موضع الإعلان.

انقر على تم.

تفعيل وضع الاختبار

اطّلِع على دليل اختبار تنفيذ Audience Network للحصول على تعليمات detallada حول كيفية تفعيل الإعلانات الاختبارية في Meta Audience Network.

الخطوة 2: إعداد طلب شبكة Audience Network من Meta في AdMob واجهة المستخدِم

ضبط إعدادات التوسّط لوحدتك الإعلانية

عليك إضافة Meta Audience Network إلى إعدادات التوسّط لوحدتك الإعلانية.

أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، وانتقِل إلى الخطوة التالية: الإضافة Meta Audience Network كمصدر إعلان.

لإنشاء مجموعة توسّط جديدة، اختَر إنشاء مجموعة توسّط.

أدخِل تنسيق الإعلان والمنصّة، ثم انقر على متابعة.

أدخِل اسمًا لمجموعة التوسّط، واختَر المواقع الجغرافية التي تريد استهدافها. بعد ذلك، اضبط حالة مجموعة التوسّط على مفعّلة، ثمّ انقر على إضافة وحدات إعلانية.

اربط مجموعة التوسّط هذه بواحد أو أكثر من AdMob الوحدات الإعلانية الحالية. بعد ذلك، انقر على تم.

من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:

إضافة Meta Audience Network كمصدر إعلان


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

إضافة Meta إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية

اتّبِع الخطوات الواردة في إعدادات "اللائحة العامّة لحماية البيانات" (GDPR) و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Meta إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية في واجهة مستخدِم AdMob.

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوِّل Meta Audience Network

في ملف build.gradle.kts على مستوى التطبيق، أضِف الإعدادات التالية للتبعيات والإعدادات. استخدِم أحدث إصدارات من حزمة تطوير البرامج (SDK) ومحوِّل Meta Audience Network:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:facebook:6.18.0.0")
}

الدمج اليدوي

الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network

بموجب سياسة موافقة المستخدِم في الاتّحاد الأوروبي المتّبَعة في Google، عليك التأكّد من تقديم بيانات الإفصاح المعيّنة إلى المستخدِمين في المنطقة الاقتصادية الأوروبية والحصول على موافقاتهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR) في الاتّحاد الأوروبي. عند طلب الموافقة، عليك تحديد كل شبكة إعلانية في سلسلة التوسّط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، و تقديم معلومات عن استخدام كل شبكة. لا يمكن لشركة Google حاليًا تمرير اختيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.

اتّبِع الإرشادات الواردة في مستندات Meta لتطبيق "اللائحة العامّة لحماية البيانات" (GDPR) والإعلانات على Meta.

قوانين الخصوصية في الولايات الأمريكية

قوانين الخصوصية في الولايات الأمريكية تتطلّب منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن لا يمكن لشركة Google تطبيق هذا الإعداد على كل شبكة إعلانية في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة مواقع إعلانية في سلسلة التوسّط التي قد تشارك في بيع المَعلومات الشخصية واتباع الإرشادات الواردة من كلّ من هذه الشبكات لضمان الامتثال.

اتّبِع الإرشادات الواردة في مستندات Meta لمعرفة خيارات معالجة البيانات للمستخدمين في كاليفورنيا.

الخطوة 5: إضافة الرمز المطلوب

لا يلزم استخدام رمز إضافي لدمج Meta Audience Network.

الخطوة 6: اختبار عملية التنفيذ

تفعيل الإعلانات الاختبارية

تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم "شبكة جمهور Facebook".

إثبات صحة الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من Meta Audience Network، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات في Meta Audience Network (عروض الأسعار).

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

إعلانات مدمجة مع المحتوى

لا تتمّ ربط بعض مواد عرض الإعلانات المدمجة مع المحتوى في Meta Audience Network بمواد عرض الإعلانات المدمجة مع المحتوى في Google بشكلٍ مباشر. ويتم تمرير مواد العرض هذه إلى الناشر في حِزمة من خلال طريقة getExtras() في NativeAd. يتيح المحوِّل تمرير مواد العرض التالية:

مَعلمات الطلب وقيمه
FacebookMediationAdapter.KEY_ID سلسلة: معرّف فريد للإعلان المدمج مع المحتوى
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET سلسلة: السياق الاجتماعي للإعلان

في ما يلي مثال على رمز برمجي يوضّح كيفية استخراج مواد العرض هذه:

مثال:

Java 

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

Kotlin 

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
   var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
   // ...
}

استخدام الإعلانات المدمجة مع المحتوى في Meta Audience Network بدون MediaView

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

لاستخدام إعلانات البانر المدمجة مع المحتوى في Meta Audience Network بدلاً من ذلك، عليك اختيار شكل Native Banner عند إعداد Meta Audience Network وسيحمِّل ملف المحوِّل تلقائيًا شكل الإعلان المدمج المقابل.

عرض الإعلانات

يعرض محوِّل "شبكة الجمهور" إعلاناته المدمجة مع المحتوى كعناصر NativeAd . تملأ هذه السمة ما يلي أوصاف حقول الإعلانات المدمجة مع المحتوى لملف NativeAd.

الحقل تتم تعبئة هذه السمة بواسطة محوّل Meta Audience Network.
العنوان
صورة 1
الجسم
رمز التطبيق
الحث على اتخاذ إجراء
اسم المعلن
التقييم النجمي
المتجر
السعر

1 لا يقدّم محوِّل Meta Audience Network إمكانية الوصول مباشرةً إلى مادة عرض الصورة الرئيسية لإعلاناته المدمجة مع المحتوى. بدلاً من ذلك، يملؤه المحوِّل بالرمز MediaView فيديو أو صورة.

تتبُّع مرّات الظهور والنقرات

يوضّح الجدول التالي الحالات التي تسجِّل فيها "حزمة SDK لإعلانات Google على الأجهزة الجوّالة" مرّات ظهور الإعلانات المدمجة مع المحتوى والنقرات عليها.

تسجيل مرّات الظهور انقر على التسجيل.
‫1 بكسل من مادة عرض الإعلانات المدمجة مع المحتوى في Meta Audience Network على الشاشة + متطلبات عرض مادة العرض طلب إعادة الاتصال لحزمة تطوير البرامج (SDK) في Meta Audience Network

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

التنسيق المدمج مع المحتوى في Meta Audience Network مادة العرض المطلوبة فئة العرض المطلوبة
مدمجة مع المحتوى عرض الوسائط MediaView
إعلان بانر مضمّن رمز التطبيق ImageView

التخزين المؤقت على Android 9

بدءًا من Android 9 (المستوى 28 من واجهة برمجة التطبيقات)، يكون خيار استخدام النص الواضح غير مفعّل تلقائيًا، ما سيؤثّر في وظيفة تخزين الوسائط المؤقت لحزمة تطوير البرامج (SDK) لشبكة قياس الجمهور في Meta، وقد يؤثّر ذلك في تجربة المستخدم وأرباح الإعلانات. اتّبِع مستندات Meta لتعديل إعدادات أمان الشبكة في تطبيقك.

رموز الخطأ

إذا تعذّر على المُحوِّل تلقّي إعلان من Audience Network، يمكنك التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo.getAdapterResponses() ضمن الفئات التالية:

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل "شبكة الجمهور" عند تعذُّر تحميل إعلان:

رمز الخطأ السبب
101 مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف موضع الإعلان)
102 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع Meta Audience Network.
103 على الناشر طلب الإعلانات التي تتضمّن سياق Activity.
104 تعذّر إعداد حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network.
105 لم يطلب الناشر الإعلانات المدمجة الموحّدة مع المحتوى.
106 الإعلان المدمَج الذي تم تحميله هو عنصر مختلف عن العنصر المتوقّع.
107 عنصر Context المستخدَم غير صالح.
108 لا يتضمّن الإعلان المحمَّل مواد عرض الإعلانات المدمجة مع المحتوى المطلوبة.
109 تعذّر إنشاء إعلان مضمّن من الحمولة البرمجية لعرض السعر.
110 تعذّر على حزمة تطوير البرامج (SDK) في Meta Audience Network عرض الإعلان البيني/الإعلان ذي المكافأة.
111 تم طرح استثناء عند إنشاء عنصر AdView في Meta Audience Network.
1000-9999 عرَضَ Meta Audience Network خطأً خاصًا بحزمة تطوير البرامج (SDK). اطّلِع على مستندات Meta Audience Network لمزيد من التفاصيل.

سجلّ التغييرات في "محوِّل التوسّط لنظام التشغيل Android" في Meta Audience Network

الإصدار 6.18.0.0

  • تم التحقّق من التوافق مع الإصدار 6.18.0 من حزمة تطوير البرامج (SDK) في Meta Audience Network.

تم تصميمها واختبارها باستخدام:

  • الإصدار 23.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.18.0 من حزمة تطوير البرامج (SDK) في Meta Audience Network

الإصدار 6.17.0.0

  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 23.0.0.
  • تم التحقّق من التوافق مع الإصدار 6.17.0 من حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network.

تم تصميمها واختبارها باستخدام:

  • الإصدار 23.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.17.0 من حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network

الإصدار 6.16.0.0

  • تم تعديل المُحوِّل للاتصال بـ MediationInterstitialAdCallback#onAdFailedToShow() عندما تُبلغ حزمة Meta SDK عن تعذُّر عرض الإعلان البيني.
  • تم التحقّق من التوافق مع الإصدار 6.16.0 من حزمة تطوير البرامج (SDK) في Meta Audience Network.

تم تصميمها واختبارها باستخدام:

  • الإصدار 22.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.16.0 من حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network

الإصدار 6.15.0.0

  • تم التحقّق من التوافق مع الإصدار 6.15.0 من حزمة تطوير البرامج (SDK) في Meta Audience Network.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.2.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 22.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.15.0 من حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network

الإصدار 6.14.0.0

  • تم التحقّق من التوافق مع الإصدار 6.14.0 من حزمة تطوير البرامج (SDK) في Meta Audience Network.

تم تصميمها واختبارها باستخدام:

  • الإصدار 22.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.14.0 من حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network

الإصدار 6.13.7.1

  • تم تعديل المُحوِّل لاستخدام فئة VersionInfo الجديدة.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.0.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 22.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.13.7 من حزمة تطوير البرامج (SDK) في Meta Audience Network

الإصدار 6.13.7.0

  • تم التحقّق من التوافق مع الإصدار 6.13.7 من حزمة تطوير البرامج (SDK) في Meta Audience Network.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.5.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 21.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.13.7 من حزمة تطوير البرامج (SDK) في Meta Audience Network

الإصدار 6.12.0.0

  • تم التحقّق من التوافق مع الإصدار 6.12.0 من حزمة تطوير البرامج (SDK) في Meta Audience Network.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.2.0.
  • تمت إعادة تسمية اسم المحوِّل إلى "شبكة جمهور Meta".
  • تمت إزالة عملية دمج العرض الإعلاني بدون انقطاع.

تم تصميمها واختبارها باستخدام:

  • الإصدار 21.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.12.0 من حزمة تطوير البرامج (SDK) في Meta Audience Network

الإصدار 6.11.0.1

  • تم تعديل compileSdkVersion وtargetSdkVersion إلى واجهة برمجة التطبيقات 31.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.0.0.
  • تم تعديل الحد الأدنى المطلوب لمستوى واجهة برمجة تطبيقات Android إلى 19.

تم تصميمها واختبارها باستخدام:

  • الإصدار 21.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.11.0 من حزمة Facebook SDK

الإصدار 6.11.0.0

  • تم التحقّق من التوافق مع الإصدار 6.11.0 من حزمة تطوير البرامج (SDK) من Facebook.
  • تمت إضافة رسائل تحذير بشأن الإيقاف النهائي لميزة التوسّط للعرض بدون انقطاع. يُرجى الاطّلاع على مدوّنة Meta للحصول على مزيد من المعلومات.

تم تصميمها واختبارها باستخدام:

  • الإصدار 20.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.11.0 من حزمة Facebook SDK

الإصدار 6.10.0.0

  • تم التحقّق من التوافق مع الإصدار 6.10.0 من حزمة Facebook SDK.

تم تصميمها واختبارها باستخدام:

  • الإصدار 20.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.10.0 من حزمة Facebook SDK

الإصدار 6.8.0.1

  • تمت إتاحة إعادة توجيه عمليات استدعاء النقرات ومرّات الظهور في الإعلانات المستندة إلى عروض الأسعار.
  • تمت إتاحة إمكانية إعادة توجيه طلب onAdFailedToShow() للردّ عندما يتعذّر عرض الإعلانات البينية المستندة إلى عروض الأسعار.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.6.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 20.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.8.0 من حزمة Facebook SDK

الإصدار 6.8.0.0

  • تم التحقّق من التوافق مع الإصدار 6.8.0 من حزمة تطوير البرامج (SDK) من Facebook.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.4.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 20.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.8.0 من حزمة Facebook SDK

الإصدار 6.7.0.0

  • تم التحقّق من التوافق مع الإصدار 6.7.0 من حزمة تطوير البرامج (SDK) من Facebook.

تم تصميمها واختبارها باستخدام:

  • الإصدار 20.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.7.0 من حزمة Facebook SDK

الإصدار 6.6.0.0

  • تم التحقّق من التوافق مع الإصدار 6.6.0 من حزمة Facebook SDK.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.3.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 20.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.6.0 من حزمة Facebook SDK

الإصدار 6.5.1.1

  • تم إصلاح خطأ ظهر في الإصدار 6.5.1.0، حيث يتم عرض الإعلانات الاختبارية بدلاً من الإعلانات النشطة.
  • تم تعديل المحوِّل لاستخدام واجهة برمجة التطبيقات الجديدة AdError API.

تم تصميمها واختبارها باستخدام:

  • الإصدار 20.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.5.1 من حزمة تطوير البرامج (SDK) من Facebook

الإصدار 6.5.1.0 (تم إيقافه نهائيًا)

  • تم رصد مشكلة في الإصدار 6.5.1.0 وتأكّد منها. ننصح بالترقية إلى الإصدار 6.5.1.1.
  • تم التحقّق من التوافق مع الإصدار 6.5.1 من حزمة تطوير البرامج (SDK) من Facebook.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.2.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 20.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.5.1 من حزمة تطوير البرامج (SDK) من Facebook

الإصدار 6.5.0.0

  • تم التحقّق من التوافق مع الإصدار 6.5.0 من حزمة تطوير البرامج (SDK) من Facebook.
  • تم إصلاح مشكلة عدم تضمين الإعلانات المدمجة مع المحتوى صورة غلاف Facebook.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.1.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 20.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.5.0 من حزمة Facebook SDK

الإصدار 6.4.0.0

  • تم التحقّق من التوافق مع الإصدار 6.4.0 من حزمة Facebook SDK.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.0.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 20.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.4.0 من حزمة Facebook SDK

الإصدار 6.3.0.1

  • تم إصلاح مشكلة تؤدي إلى ظهور خطأ ClassCastException عند عرض الإعلانات المدمجة مع المحتوى على التطبيقات التي لا تستخدم ImageView لعرض مواد عرض الصور.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.7.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.3.0 من حزمة Facebook SDK

الإصدار 6.3.0.0

  • تم التحقّق من التوافق مع الإصدار 6.3.0 من حزمة Facebook SDK.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.7.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.3.0 من حزمة Facebook SDK

الإصدار 6.2.1.0

  • تم التحقّق من التوافق مع الإصدار 6.2.1 من حزمة تطوير البرامج (SDK) من Facebook.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.7.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.7.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.2.1 من حزمة تطوير البرامج (SDK) من Facebook

الإصدار 6.2.0.1

  • تمت إزالة إمكانية استخدام تنسيق NativeAppInstallAd الذي تم إيقافه نهائيًا. يجب أن تطلب التطبيقات الإعلانات المدمجة مع المحتوى الموحّدة.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.6.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.2.0 من حزمة Facebook SDK

الإصدار 6.2.0.0

  • تم التحقّق من التوافق مع الإصدار 6.2.0 من حزمة Facebook SDK.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.5.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.2.0 من حزمة Facebook SDK

الإصدار 6.1.0.0

  • تم التحقّق من التوافق مع الإصدار 6.1.0 من حزمة Facebook SDK.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.4.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.1.0 من حزمة Facebook SDK

الإصدار 6.0.0.0

  • تم التحقّق من التوافق مع الإصدار 6.0.0 من حزمة Facebook SDK.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.3.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 6.0.0 من حزمة Facebook SDK

الإصدار 5.11.0.0

  • تم التحقّق من التوافق مع الإصدار 5.11.0 من حزمة تطوير البرامج (SDK) من Facebook.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.11.0 من حزمة Facebook SDK

الإصدار 5.10.1.0

  • تم التحقّق من التوافق مع الإصدار 5.10.1 من حزمة Facebook SDK.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.10.1 من حزمة تطوير البرامج (SDK) من Facebook

الإصدار 5.10.0.0

  • تم التحقّق من التوافق مع الإصدار 5.10.0 من حزمة تطوير البرامج (SDK) من Facebook.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.10.0 من حزمة Facebook SDK

الإصدار 5.9.1.0

  • تم التحقّق من التوافق مع الإصدار 5.9.1 من حزمة تطوير البرامج (SDK) من Facebook.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.9.1 من حزمة Facebook SDK

الإصدار 5.9.0.2

  • تمت إضافة إمكانية عرض الإعلانات البينية التي تضمّ مكافأة.
  • تم تعديل المُحوِّل لتلبية طلبات إعلانات البانر التكيُّفية المضمّنة.
  • تم حلّ مشكلة كانت تؤدي إلى عرض إعلانات البانر المستندة إلى عروض الأسعار على مستوى العرض الكامل دائمًا.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.2.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.9.0 من حزمة Facebook SDK

الإصدار 5.9.0.1

  • يعيد المحوِّل الآن توجيه خطأ إذا واجهت حزمة FAN SDK خطأً أثناء عرض إعلان بيني/إعلان مكافأة.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.9.0 من حزمة Facebook SDK

الإصدار 5.9.0.0

  • تم التحقّق من التوافق مع الإصدار 5.9.0 من حزمة Facebook SDK.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.9.0 من حزمة Facebook SDK

الإصدار 5.8.0.2

  • تم إصلاح مرجع المتغيّر غير الصحيح الذي تسبّب في حدوث عطل في سيناريوهات معيّنة عند تحميل الإعلانات المدمَجة مع المحتوى.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.8.0 من حزمة Facebook SDK

الإصدار 5.8.0.1

  • تمت إضافة رموز خطأ وصفية إضافية وأسباب تعذُّر تحميل المحوِّل أو عرضه.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.1.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.8.0 من حزمة Facebook SDK

الإصدار 5.8.0.0

  • تم التحقّق من التوافق مع الإصدار 5.8.0 من حزمة تطوير البرامج (SDK) من Facebook.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.0.1.

تم تصميمها واختبارها باستخدام:

  • الإصدار 19.0.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.8.0 من حزمة Facebook SDK

الإصدار 5.7.1.1

  • تمت إتاحة دعم لأخطاء محوِّل Facebook Audience Network.
  • تمت إضافة رموز خطأ وصفية وأسباب تعذُّر تحميل المحوِّل أو عرضه.

تم تصميمها واختبارها باستخدام:

  • الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.7.1 من حزمة Facebook SDK

الإصدار 5.7.1.0

  • تم التحقّق من التوافق مع الإصدار 5.7.1 من حزمة تطوير البرامج (SDK) من Facebook.
  • تمت إضافة ميزة الإعلانات المدمجة مع المحتوى في البانر على Facebook عند استخدام عروض الأسعار.
  • تستخدِم الإعلانات المدمجة مع المحتوى الآن عنصر "Drawable" لملفّ أصول الرمز.

تم تصميمها واختبارها باستخدام:

  • الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.7.1 من حزمة Facebook SDK

الإصدار 5.7.0.0

  • تم التحقّق من التوافق مع الإصدار 5.7.0 من حزمة Facebook SDK.

تم تصميمها واختبارها باستخدام:

  • الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.7.0 من حزمة Facebook SDK

الإصدار 5.6.1.0

  • تم التحقّق من التوافق مع الإصدار 5.6.1 من حزمة تطوير البرامج (SDK) من Facebook.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.3.0.

تم تصميمها واختبارها باستخدام:

  • الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.6.1 من حزمة Facebook SDK

الإصدار 5.6.0.0

  • تم التحقّق من التوافق مع الإصدار 5.6.0 من حزمة Facebook SDK.
  • تم تعديل "محوِّل Facebook" لاستخدام AdChoicesView.

تم تصميمها واختبارها باستخدام:

  • الإصدار 18.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.6.0 من حزمة تطوير البرامج (SDK) من Facebook

الإصدار 5.5.0.0

  • تم التحقّق من التوافق مع الإصدار 5.5.0 من حزمة تطوير البرامج (SDK) من Facebook.

الإصدار 5.4.1.1

  • تم إصلاح مشكلة كانت تؤدي إلى تعطُّل التطبيق عند إزالة "الإعلانات المدمجة".

الإصدار 5.4.1.0

  • تم التحقّق من التوافق مع الإصدار 5.4.1 من حزمة تطوير البرامج (SDK) من Facebook.
  • تمت إضافة إمكانية استخدام إعلانات البانر المدمجة مع المحتوى في Facebook لتوسّط العرض بدون انقطاع.
    • استخدِم setNativeBanner() من فئة FacebookExtras لطلب إعلانات البانر المدمجة مع المحتوى.
  • تم إصلاح مشكلة أدّت إلى تعذُّر إرسال طلبات إعلانات البانر الذكية.
  • تم إصلاح مشكلة عدم إعادة توجيه حدث onAdClosed() من خلال "الإعلانات المتضمّنة مكافآت" في بعض الحالات التي كان فيها التطبيق في الخلفية أثناء عرض الفيديو.
  • نقلت المحوِّل إلى AndroidX.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.1.1.

الإصدار 5.4.0.0

  • تم التحقّق من التوافق مع الإصدار 5.4.0 من حزمة Facebook SDK.

الإصدار 5.3.1.2

  • تم إصلاح خلل في عروض أسعار Facebook تعذّر بدء تشغيله بسبب "عدم العثور على أرقام تعريف مواضع الإعلانات".

الإصدار 5.3.1.1

  • تم تعديل تتبُّع مرّات ظهور الإعلانات الأصلية المستندة إلى عروض الأسعار في الوقت الفعلي.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 17.2.1.

الإصدار 5.3.1.0

  • تمت إضافة ميزة عروض الأسعار إلى المحوِّل لإعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات المدمجة مع المحتوى.
  • تم التحقّق من التوافق مع الإصدار 5.3.1 من حزمة تطوير البرامج (SDK) من Facebook.

الإصدار 5.3.0.0

  • تم تعديل اسم خدمة التوسّط في "إعلانات Google على الأجهزة الجوّالة".
  • تمت إضافة إصدار المحوِّل إلى طلب الإعداد.
  • تم التحقّق من التوافق مع الإصدار 5.3.0 من حزمة تطوير البرامج (SDK) من Facebook.

الإصدار 5.2.0.2

  • تمت إضافة إمكانية استخدام أحجام إعلانات البانر المرنة.

الإصدار 5.2.0.1

  • تم تعديل المحوِّل لتتوافق مع واجهة برمجة التطبيقات الجديدة والتجريبية المفتوحَين لعرض الإعلانات التي تضم مكافآت.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 17.2.0.

الإصدار 5.2.0.0

  • تم التحقّق من التوافق مع الإصدار 5.2.0 من حزمة Facebook SDK.

الإصدار 5.1.1.1

  • تم تعديل المُحوِّل لتعبئة "اسم المعلِن" للإعلانات المدمجة في المحتوى.

الإصدار 5.1.1.0

  • تم استبدال "عرض خيارات الإعلان" بـ "عرض خيارات الإعلانات".
  • التوافق مع الإصدار 5.1.1 من حزمة Facebook SDK تم التحقّق منه

الإصدار 5.1.0.1

  • تم إصلاح مشكلة ANR بسبب "getGMSVersionCode()".

الإصدار 5.1.0.0

  • إعداد حزمة تطوير البرامج (SDK) من Facebook لكل تنسيق إعلان

الإصدار 5.0.1.0

  • تم التحقّق من التوافق مع الإصدار 5.0.1 من حزمة Facebook SDK.

الإصدار 5.0.0.1

  • تم تعديل المُحوِّل لإنشاء عنصر الإعلان الذي يضم مكافأة في وقت طلب الإعلان.

الإصدار 5.0.0.0

  • تم التحقّق من التوافق مع الإصدار 5.0.0 من حزمة تطوير البرامج (SDK) من Facebook.

الإصدار 4.99.3.0

  • تم التحقّق من التوافق مع الإصدار 4.99.3 من حزمة تطوير البرامج (SDK) من Facebook.

الإصدار 4.99.1.1

  • تم إصلاح خلل كان يؤدي إلى عدم ظهور رمز AdChoices للإعلانات المدمجة مع المحتوى الموحّدة.
  • تم إصلاح خطأ كان يؤدي إلى ظهور استثناء في المُحوِّل عند محاولة تنزيل الصور.

الإصدار 4.99.1.0

  • تم التحقّق من التوافق مع الإصدار 4.99.1 من حزمة تطوير البرامج (SDK) من Facebook.

الإصدار 4.28.2.1

  • تم تعديل المحوِّل لتشغيل حدث الإعلان onRewardedVideoComplete().

الإصدار 4.28.2.0

  • تم التحقّق من التوافق مع الإصدار 4.28.2 من حزمة Facebook SDK.

الإصدار 4.28.1.1

  • تم إصلاح مشكلة عدم تسجيل النقرات على "الإعلانات المدمجة في المحتوى".

الإصدار 4.28.1.0

  • تم التحقّق من التوافق مع الإصدار 4.28.1 من حزمة تطوير البرامج (SDK) من Facebook.

الإصدار 4.28.0.0

  • تم التحقّق من التوافق مع الإصدار 4.28.0 من حزمة Facebook SDK.

الإصدار 4.27.1.0

  • تم التحقّق من التوافق مع الإصدار 4.27.1 من حزمة Facebook SDK.

الإصدار 4.27.0.0

  • تم التحقّق من التوافق مع الإصدار 4.27.0 من حزمة Facebook SDK.

الإصدار 4.26.1.0

  • تم التحقّق من التوافق مع الإصدار 4.26.1 من حزمة تطوير البرامج (SDK) من Facebook.
  • تعديل مشروع Adapter لإصدار "استوديو Android" 3.0

الإصدار 4.26.0.0

  • تمت إضافة ميزة إعلانات الفيديو التي تضم مكافآت.
  • تمت إضافة ميزة إعلانات الفيديو المدمجة مع المحتوى.
  • تم التحقّق من التوافق مع الإصدار 4.26.0 من حزمة Facebook SDK.

الإصدار 4.25.0.0

  • تم حلّ مشكلة عرض إعلانات بانر ذات مقاس غير صحيح.
  • تم تعديل ميزة تتبُّع المشاهدات في المُحوِّل للإعلانات المدمجة مع المحتوى لتسجيل مشاهدات مواد العرض الفردية باستخدام حزمة تطوير البرامج (SDK) من Facebook بدلاً من مشاهدة الإعلان بالكامل. وهذا يعني أنّ النقرات على الخلفية (أو "المساحة الفارغة") في الإعلان المدمج مع المحتوى لن تؤدّي مجددًا إلى النقر للوصول إلى الموقع الإلكتروني.
  • تم التحقّق من التوافق مع الإصدار 4.25.0 من حزمة Facebook SDK.

الإصدار 4.24.0.0

  • تم التحقّق من التوافق مع الإصدار 4.24.0 من حزمة Facebook SDK.

الإصدار 4.23.0.0

  • تم التحقّق من التوافق مع الإصدار 4.23.0 من حزمة Facebook SDK.

الإصدار 4.22.1.0

  • تم التحقّق من التوافق مع الإصدار 4.22.1 من حزمة تطوير البرامج (SDK) من Facebook.

الإصدار 4.22.0.0

  • تم تعديل المحوِّل ليصبح متوافقًا مع الإصدار 4.22.0 من حزمة Facebook SDK.

الإصدار 4.21.1.0

  • تم التحقّق من التوافق مع الإصدار 4.21.1 من حزمة تطوير البرامج (SDK) من Facebook.

الإصدار 4.21.0.0

  • تم التحقّق من التوافق مع الإصدار 4.21.0 من حزمة تطوير البرامج (SDK) من Facebook.

الإصدار 4.20.0.0

  • تم تعديل الحد الأدنى لمستوى واجهة برمجة تطبيقات Android المتوافق إلى 14 أو إصدار أحدث.
  • تم التحقّق من التوافق مع الإصدار 4.20.0 من حزمة تطوير البرامج (SDK) من Facebook.

الإصدار 4.19.0.0

  • تم إثبات التوافق مع الإصدار 4.19.0 من حزمة Facebook SDK.

الإصدار 4.18.0.0

  • تم التحقّق من التوافق مع الإصدار 4.18.0 من حزمة Facebook SDK.

الإصدار 4.17.0.0

  • تمت إضافة ميزة الإعلانات المدمجة مع المحتوى.

الإصدار 4.15.0.0

  • تم تغيير نظام تسمية الإصدارات إلى [إصدار حزمة FAN SDK].[إصدار تصحيح المكوّن الإضافي].
  • تم تعديل الحد الأدنى المطلوب من حزمة تطوير البرامج (SDK) لبرنامج FAN إلى الإصدار 4.15.0.
  • تم تعديل الحدّ الأدنى المطلوب من الإصدار 9.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • تم إصلاح خلل في Facebook يمنع توجيه طلبات إعادة الاتصال بالنقرات للإعلانات البينية بشكلٍ صحيح.
  • يعيد المُحوِّل الآن توجيه onAdLeftApplication عند النقر على إعلان.

الإصدار 1.2.0

  • تم إصلاح خلل في AdSize.SMART_BANNER ليصبح الآن حجمًا صالحًا.

الإصدار 1.1.0

  • تمت إضافة إمكانية استخدام التنسيق بالعرض الكامل × 250 عندما يكون الطلب هو AdSize.MEDIUM_RECTANGLE

الإصدار 1.0.1

  • تمت إضافة إمكانية استخدام AdSize.SMART_BANNER

الإصدار 1.0.0

  • الإصدار الأولي