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

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

الإصدار 1.3.0

الإصدار 1.2.0

الإصدار 1.1.0

الإصدار 1.0.1

  • تمت إضافة فئة Dart للسماح بإجراء تحليل التوافق بشكل صحيح مع المنصات المضيفة
  • تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.1.0 من إضافة Google Mobile Ads Flutter.

الإصدار 1.0.0

  • الإصدار الأوّلي.
  • تم إنشاؤه واختباره باستخدام الإصدار 5.0.0 من "إضافة Flutter لإعلانات Google على الأجهزة الجوّالة".