يوضِّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل إعلانات وعرضها من Meta Audience Network باستخدام التوسّط، ويشمل ذلك عمليات دمج عروض الأسعار. وتتناول كيفية إضافة Meta Audience Network إلى إعدادات التوسّط في وحدة إعلانية معيَّنة، وكيفية دمج Meta Audience Network والمحوّل في أحد التطبيقات Flutter .
عمليات الدمج وأشكال الإعلانات المتوافقة
يتميّز AdMob محوّل التوسّط لشبكة Meta Audience Network بالإمكانيات التالية:
| الدمج | |
|---|---|
| عروض الأسعار | |
| العرض الإعلاني بدون انقطاع 1 | |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| تم منح المكافأة | |
| الإعلانات البينية التي تضم مكافأة | |
1 أصبحت Meta Audience Network تطلق عليها عروض الأسعار فقط في العام 2021.
المتطلّبات
- أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android:
- المستوى 21 من واجهة برمجة تطبيقات Android أو أعلى
- للنشر على iOS:
- هدف نشر iOS هو 10.0 أو أحدث
- عادةً ما يتطلب أحدث إصدار من Meta Audience Network SDK استخدام أحدث إصدار من Xcode.
- مشروع Flutter قيد العمل تم إعداده باستخدام "SDK لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على التفاصيل.
- إكمال دليل البدء للتوسّط
الخطوة 1: إعداد الإعدادات في واجهة مستخدم Meta Audience Network
الاشتراك وتسجيل الدخول إلى صفحة بدء "مركز إدارة النشاط التجاري"
انقر على البدء ثم إنشاء حساب جديد.
املأ الحقول المطلوبة بتفاصيل نشاطك التجاري، ثم انقر على التالي.
إنشاء موقع
بعد ملء المعلومات المطلوبة، يُطلب منك إنشاء موقع لتطبيقك. أدخِل الاسم الذي تريده للموقع الخاص بتطبيقك وانقر على التالي.
الخطوة التالية هي اختيار المنصّة لتحقيق الربح.
أضِف تفاصيل التطبيق وانقر على التالي.
Android
iOS
يمكنك إعداد حساب الدفعات بالنقر على إضافة حساب دفعات جديد. ستتم إعادة توجيهك إلى صفحة جديدة لإدخال معلومات الدفع الخاصة بك. املأ التفاصيل اللازمة، ثم انقر على التالي.
اختر Google AdMob باعتباره منصّة التوسّط، ثمّ انقر على إنشاء موضع إعلان.
اختَر تنسيقًا واملأ النموذج وانقر على إنشاء.
دوِّن رقم تعريف موضع الإعلان.
انقر على تم.
تفعيل وضع الاختبار
اطّلع على دليل تنفيذ شبكة جمهور اختبار للحصول على تعليمات تفصيلية حول كيفية تفعيل الإعلانات الاختبارية "شبكة جمهور Meta".
الخطوة 2: إعداد طلب Meta Audience Network في AdMob واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة Facebook إلى قائمة شركاء الإعلانات الذين يخضعون للّائحة العامة لحماية البيانات (GDPR) ولوائح الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة Facebook إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في 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) والإعلانات الوصفية.
قوانين الخصوصية في الولايات الأمريكية
قوانين الخصوصية في الولايات الأمريكية تتطلب من المستخدمين منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفقًا لما يحدّده القانون) لهذه المصطلحات)، وذلك من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف "البيع". إنّ دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية يوفّر إمكانية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات على Google، ولكن يتعذّر على Google تطبيق هذا الإعداد على كل شبكة إعلانات في سلسلة التوسّط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية واتّباع الإرشادات من كل شبكة من هذه الشبكات لضمان الامتثال لها.
بالنسبة إلى المستخدمين في كاليفورنيا، يمكنك مراجعة خيارات معالجة البيانات في Meta.
الخطوة 5: إضافة الرمز المطلوب
Android
ما مِن رمز إضافي مطلوب لدمج Meta Audience Network.
iOS
دمج SKAdNetwork
اتّبِع مستندات Meta Audience Network
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
تم تفعيل تتبع الإعلانات
إذا كان الإصدار 14 من نظام التشغيل iOS أو إصدار أحدث، راجِع تعليمات Meta Audience Network عن كيفية ضبط علامة تتبُّع الإعلانات.
الخطوة 6: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم Meta Audience Network .
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من Meta Audience Network، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام Meta Audience Network (Bidding) مصادر الإعلانات.
خطوات اختيارية
التخزين المؤقت على نظام التشغيل Android 9
Android
بدءًا من نظام التشغيل Android 9 (المستوى 28 لواجهة برمجة التطبيقات)، يتم إيقاف cleartext بشكل تلقائي، ما سيؤثّر في وظائف التخزين المؤقت للوسائط لحزمة تطوير البرامج Meta Audience Network، وقد يؤثّر ذلك في تجربة المستخدِم وأرباح الإعلانات. اتبع وثائق 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 | تعذّر على Meta Audience Network SDK عرض الإعلان البيني/إعلان المكافأة. |
| 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 | تعذّر على Meta Audience Network SDK عرض الإعلان البيني/إعلان المكافأة. |
| 105 | وحدة التحكّم في العرض الجذري لإعلان البانر هي nil. |
| 106 | تعذّر إعداد حزمة تطوير البرامج (SDK) للشبكة Meta Audience Network. |
| 1000-9999 | عرضت Meta Audience Network خطأً متعلقًا بحزمة SDK. يمكنك الاطّلاع على مستندات Meta Audience Network للحصول على مزيد من التفاصيل. |
سجلّ تغييرات محوّل Flutter التوسّط في Meta Audience Network
1.0.1
- تمت إضافة فئة لعبة رمي السهام للسماح بتحليل التوافق الصحيح مع الأنظمة الأساسية المضيفة.
- تم التحقق من التوافق مع الإصدار 6.17.0.0 من محوّل Meta Android
- تم التحقق من التوافق مع محوّل Meta iOS بالإصدار 6.15.0.0
- تمّ إنشاء الإصدار 5.1.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة واختباره باستخدام الإصدار 5.1.0.
1.0.0
- الإصدار الأولي.
- تم التحقق من التوافق مع الإصدار 6.17.0.0 من محوّل Meta Android
- تم التحقق من التوافق مع محوّل Meta iOS بالإصدار 6.15.0.0
- تم إنشاء الإصدار 5.0.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة واختباره باستخدام الإصدار 5.0.0.