يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض من Meta Audience Network باستخدام التوسّط، والذي يشمل عروض الأسعار عمليات الدمج. ويتناول كيفية إضافة Meta Audience Network إلى تهيئة التوسط، وكيفية دمج Meta Audience Network محوّل في Flutter تطبيق.
أشكال الإعلانات وعمليات الدمج المتوافقة
محوِّل التوسّط AdMob في Meta Audience توفّر الشبكة الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال 1 | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
إعلان بيني يضم مكافأة |
1 Meta Audience Network أصبح عروض الأسعار فقط في عام 2021.
المتطلبات
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 10.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- عادةً ما تتطلب أحدث حزمة تطوير برامج (SDK) من Meta Audience Network أحدث المعلومات إصدار Xcode.
- مشروع Flutter عامل مهيأ باستخدام SDK لإعلانات Google على الأجهزة الجوّالة. عرض البدء لمعرفة التفاصيل.
- أكمِل دليل البدء الخاص بالتوسّط.
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم Meta Audience Network
الخطوة 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 السياسة، يجب التأكّد من الإفصاح عن معلومات معيّنة الموافقات التي تم الحصول عليها من المستخدمين في المنطقة الاقتصادية الأوروبية في ما يتعلق استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية و"حماية البيانات العامة" اللائحة (اللائحة العامة لحماية البيانات). عند طلب الحصول على موافقة، عليك تحديد كل شبكة إعلانات. في سلسلة التوسط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها تقدم معلومات حول استخدام كل شبكة. يتعذّر على Google حاليًا إجراء ما يلي: تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
يمكنك مراجعة إرشادات Meta للحصول على معلومات عن اللائحة العامة لحماية البيانات (GDPR) والإعلان الوصفي.
قوانين الخصوصية في الولايات الأمريكية
الولايات المتحدة قوانين الخصوصية السارية في الولايات تتطلب منح المستخدمين لإيقاف "التخفيضات" "معلوماتهم الشخصية" (كما يحدّد القانون هذه البنود)، مع ميزة الإيقاف المتوفرة من خلال ميزة "عدم بيع بياناتي الشخصية" المعلومات" حول "البيع" للصفحة الرئيسية. تشير رسالة الأشكال البيانية الولايات المتحدة خصوصية الولايات دليل الامتثال للقوانين إمكانية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن يتعذّر على Google تطبيق هذا الإعداد على كل إعلان الشبكة في سلسلة التوسط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسط التي قد تشارك في بيع البضائع المعلومات واتباع الإرشادات من كل شبكة من تلك الشبكات للتأكد الامتثال.
بالنسبة إلى المستخدمين في كاليفورنيا، يمكنك مراجعة مقالة معالجة البيانات في Meta. الخيارات.
الخطوة 5: إضافة الرمز المطلوب
Android
ليس عليك استخدام رمز إضافي لدمج Meta Audience Network.
iOS
دمج SKAdNetwork
اتّباع مستندات Meta Audience Network
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist
الخاص بمشروعك.
تم تفعيل تتبُّع الإعلانات
إذا كنت تريد إنشاء نظام التشغيل iOS 14 أو إصدار أحدث، اطّلِع على تعليمات بشأن كيفية ضبط تتبُّع الإعلانات إبلاغ
الخطوة 6: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم Meta Audience Network .
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من Meta Audience Network، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام Meta Audience Network (Bidding) مصادر الإعلانات.
خطوات اختيارية
التخزين المؤقت على نظام Android 9
Android
بدءًا من Android 9 (المستوى 28 من واجهة برمجة التطبيقات)، يتم إيقاف دعم النص الواضح من خلال التلقائي، ما سيؤثر في وظائف التخزين المؤقت للوسائط في Meta Audience حزمة تطوير البرامج (SDK) للشبكة ويمكن أن تؤثر في تجربة المستخدم وأرباح الإعلانات. متابعة Meta's المستندات لتعديل إعدادات أمان الشبكة في تطبيقك.
iOS
لا ينطبق ذلك على عمليات دمج iOS.
رموز الخطأ
إذا تعذّر على المحوّل استلام إعلان من Audience Network، يمكنك التحقّق من
خطأ أساسي من استجابة الإعلان باستخدام
ResponseInfo
ضمن الفئات التالية:
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
في ما يلي الرموز والرسائل المصاحبة التي يطرحها جمهور Meta محوّل الشبكة عند تعذُّر تحميل إعلان:
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
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 على الأجهزة الجوّالة.