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

يوضّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (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 على الأجهزة الجوّالة.