يوضّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من "شبكة جمهور Facebook" باستخدام التوسّط، مع تغطية عمليات دمج bidding . ويتناول هذا الدليل كيفية إضافة Meta Audience Network إلى إعدادات التوسّط لوحدة إعلانية، وكيفية دمج Meta Audience Network ومقترِح الربط في Flutter تطبيق.
أشكال الإعلانات وعمليات الدمج المتوافقة
يشمل محوِّل AdMob التوسّط في Meta AudienceNetwork الإمكانات التالية:
التكامل | |
---|---|
عروض الأسعار | |
شلال 1 | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
إعلان بيني يضمّ مكافأة |
1 أصبحت منصّة Meta Audience Network تتيح عروض الأسعار فقط في عام 2021.
المتطلبات
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- إصدار 10.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
- يتطلّب أحدث إصدار من حزمة تطوير البرامج (SDK) في "شبكة جمهور Meta" عادةً استخدام أحدث إصدار من Xcode.
- Flutter مشروع صالح تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" اطّلِع على البدء لمعرفة التفاصيل.
- إكمال دليل البدء للتوسّط
الخطوة 1: إعداد الإعدادات في واجهة مستخدم "شبكة جمهور Facebook"
سجِّل الدخول إلى الصفحة الرئيسية لـ "مركز إدارة النشاط التجاري".
انقر على البدء ثم إنشاء حساب جديد.
املأ الحقول المطلوبة بتفاصيل نشاطك التجاري، ثم انقر على التالي.
إنشاء موقع
بعد ملء المعلومات المطلوبة، سيُطلب منك إنشاء موقع لتطبيقك. أدخِل الاسم المطلوب للموقع الخاص بتطبيقك وانقر على التالي.
بعد ذلك، اختَر المنصة التي تريد تحقيق الربح منها.
أضِف تفاصيل تطبيقك وانقر على التالي.
Android
iOS
عليك إعداد حساب الدفعات بالنقر على إضافة حساب دفعات جديد. ستتم إعادة توجيهك إلى صفحة جديدة لإدخال معلومات الدفع. أدخِل التفاصيل اللازمة، ثم انقر على التالي.
اختَر Google AdMob كمنصّة توسّط، ثمّ انقر على إنشاء موضع إعلان.
اختَر تنسيقًا واملأ النموذج وانقر على إنشاء.
دوِّن رقم تعريف موضع الإعلان.
انقر على تم.
تفعيل وضع الاختبار
اطّلِع على دليل اختبار تنفيذ Audience Network للحصول على تعليمات detallada حول كيفية تفعيل الإعلانات الاختبارية في Meta Audience Network.
الخطوة 2: إعداد طلب شبكة Audience Network من Meta في AdMob واجهة المستخدِم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة Facebook إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات "اللائحة العامّة لحماية البيانات" (GDPR) و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Meta إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية في واجهة مستخدِم AdMob.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوِّل Meta Audience Network
الدمج من خلال pub.dev
أضِف التبعية التالية مع أحدث إصدارات
Meta Audience Network حزمة SDK والمحوِّل في ملف
pubspec.yaml
الحزمة:
dependencies:
gma_mediation_meta: ^1.0.0
الدمج اليدوي
نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة لنظام التشغيل
Meta Audience Network،
واسحب الملف الذي تم تنزيله، وأضِف مجلد المكوّن الإضافي المُستخرَج
(ومحتوياته) إلى مشروع Flutter. بعد ذلك، يمكنك الإشارة إلى المكوّن الإضافي في ملف
pubspec.yaml
عن طريق إضافة التبعية التالية:
dependencies:
gma_mediation_meta:
path: path/to/local/package
الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network
موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامّة لحماية البيانات"
بموجب سياسة موافقة المستخدِم في الاتّحاد الأوروبي المتّبَعة في Google، عليك التأكّد من تقديم بيانات الإفصاح المعيّنة إلى المستخدِمين في المنطقة الاقتصادية الأوروبية والحصول على موافقاتهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تراعي هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR). عند طلب الموافقة، عليك تحديد كل شبكة إعلانية في سلسلة التوسّط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، و تقديم معلومات عن استخدام كل شبكة. لا يمكن لشركة Google حاليًا تمرير اختيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
راجِع الإرشادات من Meta للحصول على معلومات عن "اللائحة العامّة لحماية البيانات" (GDPR) والإعلان على Meta.
قوانين الخصوصية في الولايات الأمريكية
قوانين الخصوصية في الولايات الأمريكية تتطلّب منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن لا يمكن لشركة Google تطبيق هذا الإعداد على كل شبكة إعلانية في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة مواقع إعلانية في سلسلة التوسّط التي قد تشارك في بيع المَعلومات الشخصية واتباع الإرشادات الواردة من كلّ من هذه الشبكات لضمان الامتثال.
بالنسبة إلى المستخدمين في كاليفورنيا، راجِع خيارات معالجة البيانات في Meta.
الخطوة 5: إضافة الرمز المطلوب
Android
ليس عليك استخدام رمز إضافي لدمج Meta Audience Network.
iOS
دمج SKAdNetwork
اتّبِع مستندات Meta Audience Network
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist
الخاص بمشروعك.
تم تفعيل تتبُّع الإعلانات
إذا كنت بصدد إنشاء تطبيق لنظام التشغيل iOS 14 أو إصدار أحدث، اطّلِع على تعليمات Meta Audience Network لكيفية ضبط علامة التتبّع الإعلاني.
الخطوة 6: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم "شبكة جمهور Facebook".
إثبات صحة الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من Meta Audience Network، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات في Meta Audience Network (عروض الأسعار).
الخطوات الاختيارية
التخزين المؤقت على Android 9
Android
اعتبارًا من الإصدار 9 من Android (المستوى 28 لواجهة برمجة التطبيقات)، يكون خيار استخدام النص الواضح غير مفعّل تلقائيًا، ما سيؤثّر في وظيفة تخزين الوسائط المؤقت لحزمة تطوير البرامج (SDK) لشبكة قياس الجمهور في Meta، وقد يؤثّر ذلك في تجربة المستخدم وأرباح الإعلانات. اتّبِع مستندات Meta لتعديل إعدادات أمان الشبكة في تطبيقك.
iOS
لا ينطبق ذلك على عمليات الدمج مع نظام التشغيل iOS.
رموز الخطأ
إذا تعذّر على المحوّل استلام إعلان من Audience Network، يمكنك التحقّق من
الخطأ الأساسي في استجابة الإعلان باستخدام
ResponseInfo
ضمن الفئات التالية:
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل Meta Audience Network عند تعذُّر تحميل إعلان:
Android
رمز الخطأ | السبب |
---|---|
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 لمزيد من التفاصيل. |
iOS
رمز الخطأ | السبب |
---|---|
101 | مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف موضع الإعلان). |
102 | لا يتطابق حجم الإعلان المطلوب مع حجم البانر المتوافق مع Meta Audience Network. |
103 | تعذّر إعداد عنصر إعلان Meta Audience Network. |
104 | تعذّر على حزمة تطوير البرامج (SDK) في Meta Audience Network عرض الإعلان البيني/الإعلان ذي المكافأة. |
105 | وحدة التحكّم في العرض الجذر لإعلان البانر هي nil . |
106 | تعذّر إعداد حزمة تطوير البرامج (SDK) لمنصّة Meta Audience Network. |
1000-9999 | عرَضَ Meta Audience Network خطأً خاصًا بحزمة تطوير البرامج (SDK). اطّلِع على مستندات Meta Audience Network لمزيد من التفاصيل. |
سجلّ التغييرات في "محوِّل توسّط Flutter" في Meta Audience Network
النسخة التالية
- تم إنشاء هذا البرنامج واختباره باستخدام الإصدار 5.2.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.
1.1.0
- تم التحقّق من التوافق مع الإصدار 6.17.0.0 من محوِّل Meta Android
- تم التحقّق من التوافق مع الإصدار 6.15.2.0 من محوِّل Meta iOS
- تم إنشاء هذا البرنامج واختباره باستخدام الإصدار 5.1.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.
1.0.1
- تمت إضافة فئة dart للسماح بتحليل التوافق الصحيح مع الأنظمة الأساسية للمضيف
- تم التحقّق من التوافق مع الإصدار 6.17.0.0 لمحوّل Meta Android.
- تم التحقق من التوافق مع الإصدار 6.15.0.0 لمحوّل Meta iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 5.1.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".
1.0.0
- الإصدار الأولي.
- تم التحقّق من التوافق مع الإصدار 6.17.0.0 من محوِّل Meta Android
- تم التحقّق من التوافق مع الإصدار 6.15.0.0 من محوِّل Meta iOS
- تم إنشاء هذا المكوّن الإضافي واختباره باستخدام الإصدار 5.0.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.