دمج Meta Audience Network مع عروض الأسعار

يوضّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من Meta Audience Network باستخدام التوسّط، مع تغطية عمليات دمج bidding. ويتناول هذا الدليل كيفية إضافة Meta Audience Network إلى إعدادات التوسّط لوحدة إعلانية، وكيفية دمج Meta Audience Network ومقترِح الإعلانات في تطبيق Flutter.

عمليات الدمج وأشكال الإعلانات المتوافقة

تتوفر لبرنامج AdMob Mediation Adapter في Meta Audience Network الإمكانات التالية:

التكامل
عروض الأسعار
العرض بدون انقطاع  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.

إضافة "ميتا" إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" واللوائح التنظيمية السارية في الولايات الأمريكية

اتّبِع الخطوات الواردة في إعدادات "اللائحة العامّة لحماية البيانات" (GDPR) و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Meta إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية في واجهة مستخدِم AdMob.

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوِّل Meta Audience Network

الدمج من خلال pub.dev

أضِف التبعية التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) ومحوِّل Meta Audience Network في ملف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 لواجهة برمجة التطبيقات)، يكون خيار استخدام النص الواضح غير مفعّل بشكلٍ default، ما سيؤثّر في وظيفة تخزين الوسائط المؤقت لحزمة تطوير البرامج (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 على الأجهزة الجوّالة".