يوضّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج لإعلانات Google على الأجهزة الجوّالة" من أجل تحميل الإعلانات وعرضها من "شبكة الجمهور" التابعة لشركة Meta باستخدام التوسّط، مع تغطية عمليات الدمج الخاصة بعروض الأسعار. ويشرح هذا الدليل كيفية إضافة Meta Audience Network إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج Meta Audience Network والمحوّل في تطبيق Flutter.
عمليات الدمج وأشكال الإعلانات المتوافقة
يتضمّن برنامج التكييف الخاص بالتوسّط في AdMob لشبكة Meta Audience Network الإمكانات التالية:
التكامل | |
---|---|
عروض الأسعار | |
الترتيب بدون انقطاع 1 | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
إعلان بيني يضمّ مكافأة |
1 أصبحت شبكة Meta Audience Network تتيح عروض الأسعار فقط في عام 2021.
المتطلبات
- أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 3.7.0 من Flutter أو إصدار أحدث
- للنشر على Android
- المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
- للنشر على أجهزة iOS
- إصدار iOS المستهدف هو 10.0 أو إصدار أحدث
- تتطلّب عادةً أحدث إصدار من حزمة تطوير البرامج (SDK) لشبكة Audience Network من Meta توفُّر أحدث إصدار من Xcode.
- مشروع Flutter يعمل وتم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لمزيد من التفاصيل، يُرجى الاطّلاع على البدء.
- أكمِل دليل البدء في التوسّط.
الخطوة 1: إعداد الإعدادات في واجهة مستخدم Meta Audience Network
اشترِك وسجِّل الدخول إلى صفحة "مركز إدارة النشاط التجاري".
انقر على البدء ثم على إنشاء حساب جديد.
املأ الحقول المطلوبة بتفاصيل نشاطك التجاري وانقر على التالي.
إنشاء موقع
بعد ملء المعلومات المطلوبة، سيُطلب منك إنشاء موقع لتطبيقك. أدخِل الاسم المطلوب للموقع الخاص بتطبيقك، ثم انقر على التالي.
بعد ذلك، اختَر المنصة التي تريد تحقيق الربح منها.
أضِف تفاصيل تطبيقك وانقر على التالي.
Android
iOS
يمكنك إعداد حساب الدفع من خلال النقر على إضافة حساب دفع جديد. ستتم إعادة توجيهك إلى صفحة جديدة لإدخال معلومات الدفع. املأ التفاصيل اللازمة، ثم انقر على التالي.
اختَر Google AdMob كـ منصّة التوسّط، ثم انقر على إنشاء موضع إعلان.
اختَر تنسيقًا، واملأ النموذج، وانقر على إنشاء.
دوِّن معرّف موضع الإعلان.
انقر على تم.
تعديل ملف app-ads.txt
مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt
.
إذا لم يسبق لك إجراء ذلك، عليك إعداد ملف app-ads.txt لتطبيقك.
لتنفيذ app-ads.txt
في Meta Audience Network، اطّلِع على
تحديد البائعين المعتمَدين باستخدام app-ads.txt.
تفعيل وضع الاختبار
اطّلِع على دليل اختبار تنفيذ Audience Network للحصول على تعليمات مفصّلة حول كيفية تفعيل الإعلانات الاختبارية على Meta Audience Network.
الخطوة 2: إعداد طلب Meta Audience Network في واجهة مستخدم AdMob
ضبط إعدادات التوسّط للوحدة الإعلانية
Android
للحصول على التعليمات، راجِع الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة Meta إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Meta إلى قائمة شركاء الإعلانات بموجب اللوائح التنظيمية الأوروبية واللوائح التنظيمية في الولايات الأمريكية ضمن واجهة مستخدِم AdMob.
الخطوة 3: استيراد حزمة تطوير البرامج والمحوّل الخاصَّين بشبكة Meta Audience Network
الدمج من خلال pub.dev
أضِف الاعتمادية التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) والمحوّل لشبكة Meta Audience Network في ملف pubspec.yaml
الخاص بالحزمة:
dependencies:
gma_mediation_meta: ^
الدمج اليدوي
نزِّل أحدث إصدار من مكوّن التوسّط الإضافي في "إعلانات Google على الأجهزة الجوّالة" لمنصة Meta Audience Network، واستخرِج الملف الذي تم تنزيله، وأضِف مجلد المكوّن الإضافي الذي تم استخراجه (ومحتواه) إلى مشروع Flutter. بعد ذلك، أشِر إلى المكوّن الإضافي في ملف pubspec.yaml
من خلال إضافة التبعية التالية:
dependencies:
gma_mediation_meta:
path: path/to/local/package
الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) الخاصة بشبكة Audience Network من Meta
موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامة لحماية البيانات"
بموجب سياسة موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google، عليك التأكّد من تقديم إفصاحات معيّنة للمستخدمين في المنطقة الاقتصادية الأوروبية والحصول على موافقتهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تراعي هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR) في الاتحاد الأوروبي. عند طلب الموافقة، عليك تحديد كل شبكة إعلانية في سلسلة التوسّط قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، وتقديم معلومات عن استخدام كل شبكة. في الوقت الحالي، لا يمكن لـ Google أن ينقل تلقائيًا خيار الموافقة الذي يحدّده المستخدم إلى هذه الشبكات.
راجِع إرشادات Meta للحصول على معلومات حول "اللائحة العامة لحماية البيانات" والإعلانات على Meta.
قوانين الخصوصية في الولايات الأمريكية
تتطلّب قوانين الخصوصية في الولايات الأمريكية منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات من 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 (عروض الأسعار).
الخطوات الاختيارية
التخزين المؤقت على 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
الإصدار 1.4.0
- يتوافق مع الإصدار 6.20.0.0 من محوّل Meta Audience Network لنظام التشغيل Android.
- يتوافق مع الإصدار 6.20.0.0 من محوّل Meta Audience Network لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من "إضافة Flutter لإعلانات Google على الأجهزة الجوّالة".
الإصدار 1.3.0
- يتوافق مع الإصدار 6.20.0.0 من محوّل Meta Audience Network لنظام التشغيل Android.
- يتوافق مع الإصدار 6.17.1.0 من محوّل Meta Audience Network لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من "إضافة Flutter لإعلانات Google على الأجهزة الجوّالة".
الإصدار 1.2.0
- يتوافق مع الإصدار 6.19.0.1 من محوّل Meta Audience Network لنظام التشغيل Android.
- يتوافق مع الإصدار 6.17.0.0 من محوّل Meta Audience Network لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من "إضافة Flutter لإعلانات Google على الأجهزة الجوّالة".
الإصدار 1.1.0
- أصبح المكوّن الإضافي لنظام التشغيل iOS إطارًا ثابتًا.
- يتوافق مع الإصدار 6.18.0.0 من محوّل Meta Audience Network لنظام التشغيل Android.
- يتوافق مع الإصدار 6.16.0.0 من محوّل Meta Audience Network لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.3.1 من Google Mobile Ads Flutter Plugin.
الإصدار 1.0.1
- تمت إضافة فئة Dart للسماح بإجراء تحليل التوافق بشكل صحيح مع المنصات المضيفة
- يتوافق مع الإصدار 6.17.0.0 من محوّل Meta Audience Network لنظام التشغيل Android.
- يتوافق مع الإصدار 6.15.0.0 من محوّل Meta Audience Network لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.1.0 من إضافة Google Mobile Ads Flutter.
الإصدار 1.0.0
- الإصدار الأوّلي.
- يتوافق مع الإصدار 6.17.0.0 من محوّل Meta Audience Network لنظام التشغيل Android.
- يتوافق مع الإصدار 6.15.0.0 من محوّل Meta Audience Network لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 5.0.0 من "إضافة Flutter لإعلانات Google على الأجهزة الجوّالة".