يوضّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من "شبكة جمهور Facebook" باستخدام التوسّط، التي تشمل عمليات دمج عروض الأسعار. ويتناول هذا الدليل كيفية إضافة Meta Audience Network إلى إعدادات التوسّط لوحدة الإعلان، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل Meta Audience Network في Android أحد التطبيقات.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمّن محوِّل التوسّط في Meta Audience Network الإمكانات التالية:
التكامل | |
---|---|
عروض الأسعار | |
العرض بدون انقطاع 1 | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
إعلان بيني يضمّ مكافأة | |
مدمجة مع المحتوى |
1 أصبحت منصّة Meta Audience Network تتيح عروض الأسعار فقط في عام 2021.
المتطلبات
أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
إكمال التوسّط دليل البدء
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- الإصدار 5.10.0.0 من Meta Audience Network أو إصدار أحدث (يُنصح باستخدام أحدث إصدار)
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم Meta Audience Network
سجِّل الدخول إلى صفحة البدء في "مركز إدارة النشاط التجاري" .
انقر على البدء ثم على إنشاء حساب جديد.
املأ الحقول المطلوبة بتفاصيل نشاطك التجاري وانقر على التالي.
إنشاء موقع
بعد ملء المعلومات المطلوبة، سيُطلب منك إنشاء موقع لتطبيقك. أدخِل الاسم الذي تريده للسمة الخاصة بتطبيقك، وانقر على التالي.
بعد ذلك، اختَر المنصة التي تريد تحقيق الربح منها.
أضِف تفاصيل تطبيقك وانقر على التالي.
يمكنك إعداد حساب الدفع بالنقر على إضافة حساب دفع جديد. ستتم إعادة توجيهك إلى صفحة جديدة لإدخال معلومات الدفع. أدخِل التفاصيل اللازمة، ثم انقر على التالي.
اختَر Google AdMob كمنصّة توسّط، ثمّ انقر على إنشاء موضع إعلان.
اختَر تنسيقًا، واملأ النموذج وانقر على إنشاء.
دوِّن معرّف موضع الإعلان.
انقر على تم.
تفعيل وضع الاختبار
اطّلِع على دليل اختبار تنفيذ Audience Network للحصول على تعليمات detallada حول كيفية تفعيل الإعلانات الاختبارية في Meta Audience Network.
الخطوة 2: إعداد طلب شبكة Audience Network من Meta في Ad Manager واجهة المستخدِم
سجِّل الدخول إلى حسابك على "مدير إعلانات Google".
تفعيل مشاركة الإشارات الآمنة
انتقِل إلى المشرف > الإعدادات العامة. انتقِل إلى علامة التبويب إعدادات حساب Ad Exchange راجِع مشاركة الإشارات الآمنة وفعِّلها. انقر على حفظ.
ضبط عروض الأسعار الوصفية
مدير إعلانات Google 360
انتقِل إلى العرض > مقدّمو عروض الأسعار، وانقر على مقدّم عروض أسعار جديد ضمن علامة التبويب عروض الأسعار باستخدام حِزم تطوير البرامج (SDK).
اختَر Meta كمقدِّم عروض الأسعار.
فعِّل الخيار إضافة مكتبة إشارات مقدِّم عرض السعر هذا إلى قائمة الإشارات المسموح بها والسماح بمشاركة الإشارات مع مقدِّم عرض السعر هذا. بعد ذلك، انقر على متابعة.
انقر على متابعة.
انقر على تم.
مدير الإعلانات
انتقِل إلى العرض > مقدّمو عروض الأسعار، وانقر على مقدّم عروض أسعار جديد ضمن علامة التبويب عروض الأسعار باستخدام حِزم تطوير البرامج (SDK).
اختَر Meta كمقدّم عروض الأسعار.
انقر على إعداد الجهاز على الإنترنت الآن. بعد ذلك، انقر على نعم، أوافق في مربّع الحوار ليتم توجيهك مجددًا إلى موقع Facebook الإلكتروني لبدء عملية الإعداد.
سجِّل الدخول باستخدام حسابك على "مركز إدارة النشاط التجاري".
اختَر نشاطك التجاري.
بعد اختيار نشاطك التجاري، يظهر لك مربّع الحوار التالي. انقر على الرجوع إلى "إعلانات Google".
فعِّل الخيار إضافة مكتبة إشارات مقدِّم عرض السعر هذا إلى قائمة الإشارات المسموح بها والسماح بمشاركة الإشارات مع مقدِّم عرض السعر هذا. بعد ذلك، انقر على متابعة.
انقر على متابعة.
انقر على تم.
ضبط ربط الوحدات الإعلانية
انتقِل إلى العرض > مقدّمو عروض الأسعار، واختَر شركة Meta ضمن علامة التبويب عروض الأسعار باستخدام حِزم تطوير البرامج (SDK).
انتقِل إلى علامة التبويب ربط الوحدات الإعلانية وانقر على تعيين وحدة إعلانية جديد.
اختَر وحدة إعلانية معيّنة. اختَر وحدة إعلانية وشكلًا للإعلان، وتطبيق متوافق مع الأجهزة الجوّالة كنوع المستودع، وتطبيقك المتوافق مع الأجهزة الجوّالة. بعد ذلك، أدخِل المعلومات التي تم الحصول عليها في القسم السابق. وأخيرًا، انقر على حفظ.
إضافة Meta إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات "اللائحة العامّة لحماية البيانات" (GDPR) و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Meta إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية في واجهة مستخدِم AdMob.
الخطوة 3: استيراد المحوّل وحزمة تطوير البرامج (SDK) لمنصة Meta Audience Network
دمج "استوديو Android" (إجراء يُنصح به)
في ملف 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")
}
الدمج اليدوي
نزِّل أحدث إصدار من حزمة تطوير برامج (SDK) Meta Audience Network لأجهزة Android. استخرِج
AudienceNetwork.aar
ضمن مجلدAudienceNetwork/bin
وأضِفه إلى مشروعك.انتقِل إلى ملفّات محوِّل Meta Audience Network الترميز في مستودع Maven من Google. اختَر أحدث إصدار، ونزِّل ملف
.aar
الخاص بمحوِّل Meta Audience Network، وأضِفه إلى مشروعك.
الخطوة 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 Audience Network" باسم العلامة التجارية.
- تمت إزالة عملية دمج العرض الإعلاني بدون انقطاع.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 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 من حزمة تطوير البرامج (SDK) لـ Facebook.
الإصدار 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 من Facebook SDK.
تم التصميم والاختبار باستخدام:
- الإصدار 20.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.7.0 من حزمة تطوير البرامج (SDK) لـ Facebook.
الإصدار 6.6.0.0
- تم التحقّق من التوافق مع الإصدار 6.6.0 من حزمة تطوير البرامج (SDK) من Facebook.
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "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 من Facebook SDK.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.2.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 20.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.5.1 من حزمة تطوير البرامج (SDK) من Facebook
الإصدار 6.5.0.0
- تم التحقّق من التوافق مع الإصدار 6.5.0 من Facebook SDK.
- تم إصلاح مشكلة عدم تضمين الإعلانات المدمجة مع المحتوى صورة غلاف Facebook.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.1.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 20.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.5.0 من حزمة Facebook SDK
الإصدار 6.4.0.0
- تم التحقّق من التوافق مع الإصدار 6.4.0 من حزمة تطوير البرامج (SDK) من Facebook.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "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 من حزمة تطوير البرامج (SDK) لـ Facebook.
الإصدار 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 من حزمة تطوير البرامج (SDK) من Facebook.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.5.0.
تم التصميم والاختبار باستخدام:
- الإصدار 19.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.2.0 من حزمة تطوير البرامج (SDK) الخاصة بـ Facebook.
الإصدار 6.1.0.0
- تم التحقّق من التوافق مع الإصدار 6.1.0 من حزمة Facebook SDK.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.4.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 19.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 6.1.0 من حزمة تطوير البرامج (SDK) لـ Facebook.
الإصدار 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 من Facebook SDK.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "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 عند استخدام عروض الأسعار.
- تستخدم الإعلانات المدمجة مع المحتوى الآن "قابل للرسم" لمادة عرض الرمز.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 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 من حزمة Facebook SDK
الإصدار 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 من Facebook SDK.
الإصدار 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 من حزمة تطوير البرامج (SDK) من Facebook.
الإصدار 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 من حزمة تطوير البرامج (SDK) في Facebook.
الإصدار 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
- الإصدار الأولي