يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض إعلانات من Meta Audience Network باستخدام التوسّط، التي تتناول عمليات دمج عروض الأسعار يتناول كيفية إضافة Meta Audience Network إلى تهيئة التوسط للوحدة الإعلانية وكيفية دمج Meta Audience حزمة تطوير البرامج (SDK) والمحوّل للشبكة في Android تطبيق.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمّن محوِّل التوسّط في Meta Audience Network الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال 1 | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
إعلان بيني يضم مكافأة | |
مدمجة مع المحتوى |
1 Meta Audience Network أصبح عروض الأسعار فقط في عام 2021.
المتطلبات
أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
إكمال عملية التوسّط دليل البدء
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- محوّل Meta Audience Network الإصدار 5.10.0.0 أو إصدار أحدث (ننصح باستخدام أحدث إصدار)
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم Meta Audience Network
الاشتراك وتسجيل الدخول إلى صفحة بدء "مركز إدارة النشاط التجاري"
انقر على البدء ثم إنشاء حساب جديد.
املأ الحقول المطلوبة بتفاصيل نشاطك التجاري، ثم انقر على التالي.
إنشاء موقع
بعد ملء المعلومات المطلوبة، يُطلب منك إنشاء موقع لتطبيقك. أدخِل الاسم الذي تريده للموقع الخاص بتطبيقك وانقر على التالي.
الخطوة التالية هي اختيار المنصّة لتحقيق الربح.
أضِف تفاصيل التطبيق وانقر على التالي.
![](https://developers.google.cn/admob/images/mediation/facebook/app_details_Android.png?authuser=7&hl=ar)
يمكنك إعداد حساب الدفعات بالنقر على إضافة حساب دفعات جديد. ستتم إعادة توجيهك إلى صفحة جديدة لإدخال معلومات الدفع الخاصة بك. املأ التفاصيل اللازمة، ثم انقر على التالي.
اختر Google AdMob باعتباره منصّة التوسّط، ثمّ انقر على إنشاء موضع إعلان.
اختَر تنسيقًا واملأ النموذج وانقر على إنشاء.
دوِّن رقم تعريف موضع الإعلان.
انقر على تم.
تفعيل وضع الاختبار
اطّلع على دليل تنفيذ شبكة جمهور اختبار للحصول على تعليمات تفصيلية حول كيفية تفعيل الإعلانات الاختبارية "شبكة جمهور Meta".
الخطوة 2: إعداد طلب شبكة Meta Audience Network في واجهة مستخدم Ad Manager
سجِّل الدخول إلى حسابك على "مدير إعلانات Google".
تفعيل مشاركة الإشارات الآمنة
انتقل إلى المشرف > الإعدادات العامة: الانتقال إلى قسم علامة تبويب إعدادات حساب Ad Exchange ومراجعة مفتاح التبديل وتفعيله مشاركة الإشارات الآمنة: انقر على حفظ (Save).
ضبط عروض الأسعار الوصفية
مدير الإعلانات 360
الانتقال إلى التسليم > عروض الأسعار، وانقر على أداة تقديم عروض أسعار جديدة ضمن عروض الأسعار باستخدام حِزم تطوير البرامج (SDK).
اختَر Meta كمقدِّم عروض الأسعار.
فعِّل الخيار إضافة مكتبة إشارات مقدِّم عرض السعر هذا إلى قائمة الإعلانات المسموح بها. الإشارات والسماح بمشاركة الإشارات مع مقدِّم عرض السعر هذا. بعد ذلك، انقر على متابعة
انقر على متابعة.
انقر على تم.
مدير الإعلانات
الانتقال إلى التسليم > عروض الأسعار، وانقر على أداة تقديم عروض أسعار جديدة ضمن عروض الأسعار باستخدام حِزم تطوير البرامج (SDK).
اختَر Meta كمقدِّم عروض الأسعار.
انقر على الانضمام على الإنترنت الآن. بعد ذلك، انقر على نعم، أوافق في مربّع الحوار على ستتم إعادة توجيهه إلى موقع Facebook لبدء عملية الإعداد.
تسجيل الدخول باستخدام حساب على "مركز إدارة النشاط التجاري".
اختَر نشاطك التجاري.
بعد اختيار نشاطك التجاري، سيظهر مربّع الحوار التالي. انقر على رجوع. إلى "مدير إعلانات Google"
فعِّل الخيار إضافة مكتبة إشارات مقدِّم عرض السعر هذا إلى قائمة الإعلانات المسموح بها. الإشارات والسماح بمشاركة الإشارات مع مقدِّم عرض السعر هذا. بعد ذلك، انقر على متابعة
انقر على متابعة.
انقر على تم.
ضبط ربط الوحدات الإعلانية
الانتقال إلى التسليم > مقدِّمو عروض الأسعار، واختَر الشركة لتطبيق Meta ضمن علامة التبويب عروض الأسعار باستخدام حِزم تطوير البرامج (SDK)
انتقِل إلى علامة التبويب ربط الوحدات الإعلانية وانقر على ربط وحدة إعلانية جديدة.
اختَر وحدة إعلانية معيّنة. اختر وحدة إعلانية وشكلاً، تطبيق للأجهزة الجوّالة كـ ونوع المستودع وتطبيق الأجهزة الجوّالة. ثم أدخل تم الحصول عليه في القسم السابق. وأخيرًا، انقر على حفظ.
إضافة Facebook إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة Facebook إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في Ad Manager واجهة المستخدم.
الخطوة 3: استيراد المحوّل وحزمة تطوير البرامج (SDK) لمنصة Meta Audience Network
الدمج مع "استوديو Android" (يُنصح به)
في ملف build.gradle.kts
على مستوى التطبيق، أضِف عملية التنفيذ التالية
والتبعيات والتكوينات. استخدام أحدث إصدارات Meta Audience
حزمة تطوير البرامج (SDK) ومحوّل الشبكة:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:facebook:6.17.0.0")
}
الدمج اليدوي
نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) الخاصة بشبكة Meta Audience Network للنطاق Android استخرِج "
AudienceNetwork.aar
" ضمن المجلد "AudienceNetwork/bin
". وإضافته إلى مشروعك.انتقِل إلى محوّل Meta Audience Network. العناصر على مستودع Maven من Google. حدد أحدث إصدار، ونزِّل Meta ملف
.aar
لمحوّل شبكة الجمهور، وإضافته إلى مشروعك.
الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) الخاصة بشبكة Meta Audience Network
موافقة المستخدمين في الاتحاد الأوروبي واللائحة العامة لحماية البيانات
بموجب موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google السياسة، يجب التأكّد من الإفصاح عن معلومات معيّنة الموافقات التي تم الحصول عليها من المستخدمين في المنطقة الاقتصادية الأوروبية في ما يتعلق استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية و"حماية البيانات العامة" اللائحة (اللائحة العامة لحماية البيانات). عند طلب الحصول على موافقة، عليك تحديد كل شبكة إعلانات. في سلسلة التوسط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها تقدم معلومات حول استخدام كل شبكة. يتعذّر على Google حاليًا إجراء ما يلي: تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
اتّبِع الإرشادات الواردة في مستندات Meta. للّائحة العامة لحماية البيانات والإعلانات الوصفية
قوانين الخصوصية في الولايات الأمريكية
الولايات المتحدة قوانين الخصوصية السارية في الولايات تتطلب منح المستخدمين لإيقاف "التخفيضات" "معلوماتهم الشخصية" (كما يحدّد القانون هذه البنود)، مع ميزة الإيقاف المتوفرة من خلال ميزة "عدم بيع بياناتي الشخصية" المعلومات" حول "البيع" للصفحة الرئيسية. تشير رسالة الأشكال البيانية الولايات المتحدة خصوصية الولايات دليل الامتثال للقوانين إمكانية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن يتعذّر على Google تطبيق هذا الإعداد على كل إعلان الشبكة في سلسلة التوسط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسط التي قد تشارك في بيع البضائع المعلومات واتباع الإرشادات من كل شبكة من تلك الشبكات للتأكد الامتثال.
اتّبِع الإرشادات الواردة في مستندات Meta لخيارات معالجة البيانات للمستخدمين في كاليفورنيا.
الخطوة 5: إضافة الرمز المطلوب
وليس عليك استخدام رمز إضافي لدمج شبكة Meta Audience Network.
الخطوة 6: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل Ad Manager وتفعيل وضع الاختبار في واجهة المستخدم Meta Audience Network .
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من Meta Audience Network، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام Meta Audience Network (Bidding) مصادر الإعلانات.
خطوات اختيارية
إعلانات مدمجة مع المحتوى
بعض الإشعارات
الإعلان المدمج مع المحتوى على شبكة 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 بدون 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) لشبكة Audience Network |
تفرض Meta Audience Network متطلبات محدّدة لعرض مواد العرض من أجل مرة الظهور ليتم اعتبارها صالحة، اعتمادًا على ما إذا كنت قد اخترت شكل إعلان مدمج مع المحتوى أو إعلان بانر مدمج مع المحتوى عند إعداد Meta Audience الشبكة.
شكل الإعلان المدمج مع المحتوى في Meta Audience Network | مادة العرض المطلوبة | فئة العرض المطلوبة |
---|---|---|
مدمجة مع المحتوى | عرض الوسائط |
MediaView
|
إعلان بانر مدمج مع المحتوى | رمز التطبيق |
ImageView
|
التخزين المؤقت على نظام Android 9
بدءًا من الإصدار 9 من نظام التشغيل Android (المستوى 28 من واجهة برمجة التطبيقات)، يتم إيقاف دعم cleartext تلقائيًا ما سيؤثر في وظائف التخزين المؤقت للوسائط في Meta Audience حزمة تطوير البرامج (SDK) للشبكة ويمكن أن تؤثر في تجربة المستخدم وأرباح الإعلانات. متابعة مستندات 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
الإصدار 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
- تم تحديث المحوِّل لطلب Mediation withinAdCallback#onAdFoundToShow() عندما تشير حزمة 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 من Facebook SDK.
- تمت إضافة رسائل تحذيرية بشأن إيقاف توسّط العرض الإعلاني بدون انقطاع. يُرجى الاطّلاع على مدوّنة 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 من حزمة تطوير البرامج (SDK) لـ Facebook.
الإصدار 6.8.0.0
- تم التحقق من التوافق مع الإصدار 6.8.0 من Facebook SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.4.0.
تم التصميم والاختبار باستخدام:
- الإصدار 20.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.8.0 من حزمة تطوير البرامج (SDK) لـ Facebook.
الإصدار 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 من حزمة تطوير البرامج (SDK) الخاصة بـ Facebook.
الإصدار 6.5.1.1
- تم إصلاح خطأ ظهر في الإصدار 6.5.1.0 حيث يتم عرض الإعلانات الاختبارية بدلاً من الإعلانات المباشرة.
- تم تعديل المحوّل لاستخدام واجهة برمجة تطبيقات
AdError
الجديدة.
تم التصميم والاختبار باستخدام:
- الإصدار 20.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.5.1 من Facebook SDK.
الإصدار 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 من Facebook SDK.
الإصدار 6.5.0.0
- تم التحقّق من التوافق مع الإصدار 6.5.0 من Facebook SDK.
- تم إصلاح مشكلة عدم اشتمال الإعلانات المدمجة مع المحتوى على صورة غلاف Facebook.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.1.0.
تم التصميم والاختبار باستخدام:
- الإصدار 20.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.5.0 من حزمة تطوير البرامج (SDK) الخاصة بـ Facebook.
الإصدار 6.4.0.0
- تم التحقّق من التوافق مع الإصدار 6.4.0 من حزمة تطوير البرامج (SDK) من Facebook.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.0.0.
تم التصميم والاختبار باستخدام:
- الإصدار 20.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.4.0 من حزمة تطوير البرامج (SDK) لـ Facebook.
الإصدار 6.3.0.1
- تم إصلاح مشكلة طرح
ClassCastException
عند عرض الإعلانات المدمجة مع المحتوى على التطبيقات التي لا تستخدمImageView
لعرض مواد عرض الصور.
تم التصميم والاختبار باستخدام:
- الإصدار 19.7.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.3.0 من حزمة تطوير البرامج (SDK) لـ Facebook.
الإصدار 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 من Facebook SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.7.0.
تم التصميم والاختبار باستخدام:
- الإصدار 19.7.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.2.1 من Facebook SDK.
الإصدار 6.2.0.1
- تمت إزالة الدعم لتنسيق
NativeAppInstallAd
المتوقّف. يجب أن تطلب التطبيقات استخدام إعلانات موحَّدة مدمجة مع المحتوى. - تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.6.0.
تم التصميم والاختبار باستخدام:
- الإصدار 19.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.2.0 من حزمة تطوير البرامج (SDK) الخاصة بـ Facebook.
الإصدار 6.2.0.0
- تم التحقّق من التوافق مع الإصدار 6.2.0 من Facebook SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "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 من حزمة تطوير البرامج (SDK) من Facebook.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.3.0.
تم التصميم والاختبار باستخدام:
- الإصدار 19.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 6.0.0 من حزمة تطوير البرامج (SDK) لـ Facebook.
الإصدار 5.11.0.0
- تم التحقّق من التوافق مع الإصدار 5.11.0 من Facebook SDK.
تم التصميم والاختبار باستخدام:
- الإصدار 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 من Facebook SDK.
الإصدار 5.10.0.0
- تم التحقّق من التوافق مع الإصدار 5.10.0 من Facebook SDK.
تم التصميم والاختبار باستخدام:
- الإصدار 19.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 5.10.0 من Facebook SDK.
الإصدار 5.9.1.0
- تم التحقّق من التوافق مع الإصدار 5.9.1 من Facebook SDK.
تم التصميم والاختبار باستخدام:
- الإصدار 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
- يعيد المحوّل الآن توجيه رسالة خطأ إذا واجهت حزمة تطوير البرامج (SDK) لشبكة Facebook Audience خطأ أثناء عرض إعلان بيني أو إعلان بمكافأة.
تم التصميم والاختبار باستخدام:
- الإصدار 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 من حزمة تطوير البرامج (SDK) الخاصة بـ Facebook
الإصدار 5.8.0.1
- تمت إضافة رموز خطأ وصفية إضافية وأسباب تعذُّر تحميل/عرض المحوّل.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.1.0.
تم التصميم والاختبار باستخدام:
- الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 5.8.0 من حزمة تطوير البرامج (SDK) الخاصة بـ Facebook
الإصدار 5.8.0.0
- تم التحقّق من التوافق مع الإصدار 5.8.0 من Facebook SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.0.1.
تم التصميم والاختبار باستخدام:
- الإصدار 19.0.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 5.8.0 من حزمة تطوير البرامج (SDK) الخاصة بـ Facebook
الإصدار 5.7.1.1
- تمت إضافة دعم لأخطاء محوّل Facebook Audience Network.
- تمت إضافة رموز خطأ وصفية وأسباب تعذُّر تحميل/عرض المحوّل.
تم التصميم والاختبار باستخدام:
- الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 5.7.1 من Facebook SDK.
الإصدار 5.7.1.0
- تم التحقّق من التوافق مع الإصدار 5.7.1 من Facebook SDK.
- تمت إضافة دعم لإعلانات البانر المدمجة مع المحتوى في 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 من Facebook SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "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 من Facebook SDK.
الإصدار 5.4.1.1
- تم إصلاح مشكلة تسببت في حدوث عطل عند إزالة الإعلانات المدمجة مع المحتوى.
الإصدار 5.4.1.0
- تم التحقّق من التوافق مع الإصدار 5.4.1 من Facebook SDK.
- تمت إضافة دعم لإعلانات البانر المدمجة مع المحتوى في 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
- تم تعديل ميزة تتبُّع مرات ظهور الإعلانات المدمجة مع المحتوى التي تستخدم عروض الأسعار في الوقت الفعلي (RTB).
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 17.2.1.
الإصدار 5.3.1.0
- تمت إضافة إمكانية تقديم عروض الأسعار إلى المحوّل لإعلانات البانر والإعلانات البينية الإعلانات التي تضم مكافأة والإعلانات المدمجة مع المحتوى
- تم التحقّق من التوافق مع الإصدار 5.3.1 من Facebook SDK.
الإصدار 5.3.0.0
- تم تحديث اسم خدمة التوسط لإعلانات Google على الأجهزة الجوّالة.
- تمت إضافة إصدار المحوّل إلى طلب الإعداد.
- تم التحقّق من التوافق مع الإصدار 5.3.0 من Facebook SDK.
الإصدار 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
- تم استبدال عرض خيارات الإعلان بعرض AdOptions.
- تم التحقّق من التوافق مع الإصدار 5.1.1 من Facebook SDK.
الإصدار 5.1.0.1
- تم إصلاح مشكلة ANR التي حدثت بسبب "getGMSVersionCode() ".
الإصدار 5.1.0.0
- إعداد Facebook SDK لكل شكل إعلان.
الإصدار 5.0.1.0
- تم التحقّق من التوافق مع الإصدار 5.0.1 من Facebook SDK.
الإصدار 5.0.0.1
- تم تعديل المحوّل لإنشاء عنصر الإعلان الذي يضم مكافأة في وقت طلب الإعلان.
الإصدار 5.0.0.0
- تم التحقّق من التوافق مع الإصدار 5.0.0 من Facebook SDK.
الإصدار 4.99.3.0
- تم التحقّق من التوافق مع الإصدار 4.99.3 من Facebook SDK.
الإصدار 4.99.1.1
- تم إصلاح خطأ عدم ظهور رمز "خيارات الإعلان" للإعلانات الموحّدة المدمجة مع المحتوى.
- تم إصلاح الخطأ الذي يُحدِث فيه المحوّل استثناءً عند محاولة تنزيل الصور.
الإصدار 4.99.1.0
- تم التحقّق من التوافق مع الإصدار 4.99.1 من Facebook SDK.
الإصدار 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 من Facebook SDK.
الإصدار 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 من Facebook SDK.
- تحديث مشروع المحوّل للإصدار 3.0 من "استوديو Android"
الإصدار 4.26.0.0
- تمت إضافة دعم لإعلانات الفيديو التي تضم مكافأة.
- تم توفير إعلانات الفيديو المدمجة مع المحتوى.
- تم التحقّق من التوافق مع الإصدار 4.26.0 من Facebook SDK.
الإصدار 4.25.0.0
- تم إصلاح مشكلة عرض إعلانات بانر ذات أحجام غير صحيحة.
- تم تعديل تتبُّع مشاهدات المحوّل للإعلانات المدمجة مع المحتوى من أجل تسجيل مرّات مشاهدة مواد العرض باستخدام Facebook SDK بدلاً من مشاهدة الإعلان بالكامل. يعني ذلك تلك الخلفية (أو "المسافة البيضاء") على الإعلان المدمج مع المحتوى ينتج عنها نسب النقر إلى الظهور.
- تم التحقّق من التوافق مع الإصدار 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 من Facebook SDK.
الإصدار 4.22.0.0
- تم تحديث المحوّل ليكون متوافقًا مع الإصدار 4.22.0 من حزمة تطوير البرامج (SDK) في Facebook.
الإصدار 4.21.1.0
- تم التحقّق من التوافق مع الإصدار 4.21.1 من Facebook SDK.
الإصدار 4.21.0.0
- تم التحقّق من التوافق مع الإصدار 4.21.0 من Facebook SDK.
الإصدار 4.20.0.0
- تم تعديل الحد الأدنى المتوافق مع واجهة برمجة تطبيقات Android إلى 14 أو الأحدث.
- تم التحقّق من التوافق مع الإصدار 4.20.0 من حزمة تطوير البرامج (SDK) من Facebook.
الإصدار 4.19.0.0
- تم التحقّق من التوافق مع الإصدار 4.19.0 من حزمة تطوير البرامج (SDK) من Facebook.
الإصدار 4.18.0.0
- تم التحقّق من التوافق مع الإصدار 4.18.0 من حزمة تطوير البرامج (SDK) من Facebook.
الإصدار 4.17.0.0
- تم توفير إمكانية استخدام الإعلانات المدمجة مع المحتوى.
الإصدار 4.15.0.0
- تم تغيير نظام تسمية الإصدار إلى [إصدار حزمة تطوير البرامج (SDK) لشبكة المعجبين].[إصدار رمز تصحيح المحوّل].
- تم تحديث الحد الأدنى المطلوب لحزمة تطوير البرامج (SDK) الخاصة بشبكة المعجبين (FAN) إلى الإصدار 4.15.0.
- تم تحديث الحد الأدنى المطلوب لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة إلى الإصدار 9.2.0.
- تم إصلاح خطأ عدم تنفيذ استدعاءات النقر على Facebook للإعلانات البينية إعادة توجيهها بشكل صحيح.
- يقوم المحول الآن أيضًا بإعادة توجيه onAdLeftApplication عند النقر على أحد الإعلانات.
الإصدار 1.2.0
- تم إصلاح خطأ جعل حجم AdSize.SMART_BANNER صالحًا الآن.
الإصدار 1.1.0
- تمت إضافة دعم لتنسيق العرض الكامل x 250 عندما يكون الطلب لـ AdSize.MEDIUM_RECTANGLE
الإصدار 1.0.1
- دعم إضافي لـ AdSize.SMART_BANNER
الإصدار 1.0.0
- الإصدار الأولي