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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads Unity Plugin لتحميل الإعلانات وعرضها من Meta Audience Network باستخدام التوسّط، مع تغطية عمليات الدمج المستندة إلى عروض الأسعار. توضّح هذه الصفحة كيفية إضافة Meta Audience Network إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج Meta Audience Network والمحوّل في تطبيق Unity.

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

يتضمّن محوّل التوسّط في "مدير إعلانات Google" لشبكة Meta Audience Network الإمكانات التالية:

التكامل
عروض الأسعار
Waterfall  1
التنسيقات
بانر
إعلان بيني
تمت المكافأة
إعلان بيني مقابل مكافأة

1 أصبحت Meta Audience Network متاحة لتقديم عروض الأسعار فقط في عام 2021.

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

  • أحدث إصدار من Google Mobile Ads Unity Plugin
  • الإصدار 5.6 من Unity Editor أو إصدار أحدث
  • المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" في Meta Audience Network، الإصدار 2.11.0 (يُنصح باستخدام أحدث إصدار)
  • للنشر على أجهزة Android
    • المستوى 24 من واجهة برمجة التطبيقات Android أو الإصدارات الأحدث
  • للنشر على أجهزة iOS
    • الإصدار 15.0 أو إصدار أحدث من iOS deployment target
    • يتطلّب أحدث إصدار من حزمة تطوير البرامج (SDK) لشبكة Meta Audience Network عادةً أحدث إصدار من Xcode.
  • مشروع Unity قيد العمل تم إعداده باستخدام Google Mobile Ads Unity Plugin لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Unity Plugin.
  • إعداد التوسّط

    • الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم Meta Audience Network

    اشترِك وسجِّل الدخول إلى صفحة "مركز إدارة النشاط التجاري".

    انقر على البدء ثم على إنشاء حساب جديد.

    املأ الحقول المطلوبة بتفاصيل نشاطك التجاري وانقر على التالي.

    إنشاء موقع

    بعد ملء المعلومات المطلوبة، سيُطلب منك إنشاء موقع لتطبيقك. أدخِل الاسم المطلوب للموقع الخاص بتطبيقك، ثم انقر على التالي.

    بعد ذلك، اختَر المنصة التي تريد تحقيق الربح منها.

    أضِف تفاصيل تطبيقك وانقر على التالي.

    Android

    iOS

    أعِدّوا حساب الدفع من خلال النقر على إضافة حساب دفع جديد. ستتم إعادة توجيهك إلى صفحة جديدة لإدخال معلومات الدفع. املأ التفاصيل اللازمة، ثم انقر على التالي.

    اختَر إدارة إعلانات Google كـ منصّة التوسّط، ثمّ انقر على إنشاء موضع إعلان.

    اختَر تنسيقًا، واملأ النموذج، وانقر على إنشاء.

    دوِّن رقم تعريف موضع الإعلان.

    انقر على تم.

    تعديل ملف app-ads.txt

    مبادرة "البائعون المعتمَدون للتطبيقات" (app-ads.txt) هي مبادرة من "المختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقاتك إلا من خلال القنوات التي حدّدتها على أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، عليك إنشاء ملف app-ads.txt في "إدارة إعلانات Google".

    لتنفيذ app-ads.txt في Meta Audience Network، يُرجى الاطّلاع على مقالة تحديد البائعين المعتمَدين باستخدام ملف app-ads.txt.

    تفعيل "وضع الاختبار"

    يمكنك الاطّلاع على دليل اختبار تنفيذ Audience Network للحصول على تعليمات مفصّلة حول كيفية تفعيل الإعلانات الاختبارية في Meta Audience Network.

    الخطوة 2: إعداد طلب Meta Audience Network في واجهة مستخدم "إدارة الإعلانات"

    ضبط إعدادات التوسّط للوحدة الإعلانية

    Android

    للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

    iOS

    للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

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

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

    الخطوة 3: استيراد حزمة تطوير البرامج والمحوّل الخاصَّين بشبكة Meta Audience Network

    OpenUPM-CLI

    إذا كان لديك OpenUPM-CLI مثبّتًا، يمكنك تثبيت المكوّن الإضافي لتوسّط Google Mobile Ads Meta Audience Network في Unity لمشروعك عن طريق تشغيل الأمر التالي من الدليل الجذري لمشروعك:

    openupm add com.google.ads.mobile.mediation.metaaudiencenetwork

    OpenUPM

    في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > أداة إدارة الحِزم لفتح إعدادات أداة إدارة حِزم Unity.

    ضمن علامة التبويب Scoped Registries، أضِف OpenUPM كسجلّ نطاق باستخدام التفاصيل التالية:

    • الاسم: OpenUPM
    • عنوان URL: https://package.openupm.com
    • النطاقات: com.google

    تفاصيل‫ OpenUPM

    بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager (إدارة حِزم Unity)، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.

    Unityمستودعات ‫

    اختَر حزمة Google Mobile Ads MetaAudienceNetwork Mediation وانقر على تثبيت.

    التثبيت من‫ OpenUPM

    حزمة Unity

    نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" لشبكة Meta Audience Network من رابط التنزيل في سجلّ التغييرات واستخرِج GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage من ملف ZIP.

    في محرِّر مشروع Unity، اختَر مواد العرض > استيراد حزمة > حزمة مخصّصة وابحث عن ملف GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات، ثم انقر على استيراد.

    الاستيراد من‫ Unity

    بعد ذلك، اختَر مواد العرض > مدير التبعية الخارجية > أداة حلّ مشاكل Android > فرض الحلّ. ستنفّذ مكتبة External Dependency Manager عملية تحديد التبعيات من البداية وستنسخ التبعيات المحدّدة إلى الدليل Assets/Plugins/Android في تطبيق Unity.

    فرض الحلّ

    الخطوة 4: تطبيق إعدادات الخصوصية على حزمة تطوير البرامج (SDK) لشبكة Meta Audience Network

    للامتثال لسياسة موافقة المستخدِم في الاتحاد الأوروبي التي تتّبعها Google، عليك تقديم إفصاحات معيّنة للمستخدِمين في المنطقة الاقتصادية الأوروبية والمملكة المتحدة وسويسرا، والحصول على موافقتهم على استخدام ملفات تعريف الارتباط أو غيرها من وسائل التخزين المحلية حيثما يكون ذلك مطلوبًا بموجب القانون، وعلى جمع البيانات الشخصية ومشاركتها واستخدامها لتخصيص الإعلانات. تعكس هذه السياسة شروط "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR). أنت مسؤول عن التحقّق من نشر الموافقة على كل مصدر إعلان في سلسلة التوسّط.

    يُرجى مراجعة إرشادات Meta للحصول على معلومات حول "اللائحة العامة لحماية البيانات" والإعلانات على Meta.

    قوانين الخصوصية في الولايات الأمريكية

    تتطلّب قوانين الخصوصية في الولايات الأمريكية منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح لك دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات من Google، ولكن لا يمكن لـ Google تطبيق هذا الإعداد على كل شبكة إعلانات في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية واتّباع الإرشادات المقدَّمة من كل شبكة من هذه الشبكات لضمان الامتثال.

    بالنسبة إلى المستخدمين في كاليفورنيا، راجِع خيارات معالجة البيانات من Meta.

    الخطوة 5: إضافة الرمز المطلوب

    Android

    لا حاجة إلى استخدام رمز إضافي لدمج Meta Audience Network.

    iOS

    دمج SKAdNetwork

    اتّبِع مستندات Meta Audience Network لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

    تم تفعيل ميزة تتبُّع الإعلانات

    إذا كنت تنشئ تطبيقًا لنظام التشغيل iOS 14 أو إصدار أحدث، اطّلِع على تعليمات Meta Audience Network حول كيفية ضبط علامة تتبُّع الإعلانات.

    الخطوة 6: اختبار عملية التنفيذ

    تفعيل الإعلانات الاختبارية

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

    سجلّ التغييرات في المكوّن الإضافي لتوسّط Unity في Meta Audience Network

    الإصدار 3.20.1

    الإصدار 3.20.0

    الإصدار 3.19.0

    الإصدار 3.18.7

    الإصدار 3.18.6

    الإصدار 3.18.5

    الإصدار 3.18.4

    الإصدار 3.18.3

    الإصدار 3.18.2

    الإصدار 3.18.1

    الإصدار 3.18.0

    الإصدار 3.17.3

    الإصدار 3.17.2

    الإصدار 3.17.1

    الإصدار 3.17.0

    الإصدار 3.16.0

    الإصدار 3.15.0

    الإصدار 3.14.0

    الإصدار 3.13.1

    الإصدار 3.13.0

    الإصدار 3.12.2

    الإصدار 3.12.1

    الإصدار 3.12.0

    الإصدار 3.11.0

    الإصدار 3.10.0

    الإصدار 3.9.1

    الإصدار 3.9.0

    الإصدار 3.8.0

    الإصدار 3.7.0

    الإصدار 3.6.1

    الإصدار 3.6.0

    الإصدار 3.5.0

    الإصدار 3.4.0

    الإصدار 3.3.2

    الإصدار 3.3.1

    الإصدار 3.3.0

    الإصدار 3.2.0

    الإصدار 3.1.0

    الإصدار 3.0.0

    الإصدار 2.12.0

    الإصدار 2.11.1

    الإصدار 2.11.0

    الإصدار 2.10.0

    الإصدار 2.9.2

    الإصدار 2.9.1

    الإصدار 2.9.0

    الإصدار 2.8.1

    الإصدار 2.8.0

    الإصدار 2.7.1 (تم إيقافه نهائيًا، يُرجى استخدام الإصدار 2.8.0 أو إصدار أحدث)

    الإصدار 2.7.0 (تم إيقافه نهائيًا، يُرجى استخدام الإصدار 2.8.0 أو إصدار أحدث)

    الإصدار 2.6.1 (تم إيقافه نهائيًا، يُرجى استخدام الإصدار 2.8.0 أو إصدار أحدث)

    الإصدار 2.6.0

    الإصدار 2.5.1

    • يتوافق مع الإصدار 5.5.0.0 من محوّل Facebook على Android.
    • يتوافق مع الإصدار 5.5.1.0 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 2.5.0

    • يتوافق مع الإصدار 5.5.0.0 من محوّل Facebook على Android.
    • يتوافق مع الإصدار 5.5.0.0 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 2.4.1

    • يتوافق مع الإصدار 5.4.1.1 من محوّل Facebook لنظام التشغيل Android.
    • متوافق مع الإصدار 5.4.0.0 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 2.4.0

    • يتوافق مع الإصدار 5.4.0.0 من محوّل Facebook على Android.
    • متوافق مع الإصدار 5.4.0.0 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 2.3.2

    • يتوافق مع الإصدار 5.3.1.2 من محوّل Facebook لنظام التشغيل Android.
    • يتوافق مع الإصدار 5.3.2.0 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 2.3.1

    • يتوافق مع الإصدار 5.3.1.0 من محوّل Facebook لنظام التشغيل Android.
    • يتوافق مع الإصدار 5.3.2.0 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 2.3.0

    • يتوافق مع الإصدار 5.3.0.0 من محوّل Facebook Android.
    • يتوافق مع الإصدار 5.3.0.0 من محوّل Facebook iOS.

    الإصدار 2.2.0

    • تم تعديل المكوّن الإضافي ليتوافق مع واجهة برمجة التطبيقات الجديدة للإعلانات التي تضم مكافآت في الإصدار التجريبي المفتوح.
    • يتوافق مع الإصدار 5.2.0.1 من محوّل Facebook Android.
    • يتوافق مع الإصدار 5.2.0.1 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 2.1.1

    • يتوافق مع الإصدار 5.1.0.1 من محوّل Facebook Android.
    • يتوافق مع الإصدار 5.1.0.0 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 2.1.0

    • يتوافق مع الإصدار 5.1.0.0 من محوّل Facebook Android.
    • يتوافق مع الإصدار 5.1.0.0 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 2.0.0

    • يتوافق مع الإصدار 5.0.1.0 من محوّل Facebook لنظام التشغيل Android.
    • يتوافق مع الإصدار 5.0.1.0 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 1.2.1

    • يتوافق مع الإصدار 4.99.3.0 من محوّل Facebook Android.
    • يتوافق مع الإصدار 4.99.3.0 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 1.2.0

    • متوافق مع الإصدار 4.99.1.1 من محوّل Facebook لنظام التشغيل Android.
    • يتوافق مع الإصدار 4.99.2.0 من محوّل Facebook iOS.

    الإصدار 1.1.3

    • يتوافق مع الإصدار 4.28.2.1 من محوّل Facebook Android.
    • تتوافق هذه الحزمة مع الإصدار 4.28.1.2 من محوّل Facebook iOS.

    الإصدار 1.1.2

    • تم إصلاح تعارض محتمل مع إضافة التوسّط Unity Ads Unity.

    الإصدار 1.1.1

    • يتوافق مع الإصدار 4.28.2.0 من محوّل Facebook لنظام التشغيل Android.
    • متوافق مع الإصدار 4.28.1.1 من محوّل Facebook لنظام التشغيل iOS.

    الإصدار 1.1.0

    • يتوافق مع الإصدار 4.28.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Facebook.
    • يتوافق مع الإصدار 4.28.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Facebook.

    الإصدار 1.0.0

    • الإصدار الأول
    • يتوافق مع الإصدار 4.27.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Facebook.
    • يتوافق مع الإصدار 4.27.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Facebook.