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

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

يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads Unity Plugin لتحميل الإعلانات وعرضها من Meta Audience Network باستخدام التوسّط، ويغطي عمليات دمج عروض الأسعار. توضّح هذه الصفحة كيفية إضافة Meta Audience Network إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل 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
    • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
  • للنشر على 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: استيراد حزمة تطوير البرامج (SDK) والمحوِّل لشبكة 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 واختَر 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 الخاص بمشروعك.

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

    إذا كنت تستهدف الإصدار 14 من نظام التشغيل iOS أو إصدارًا أحدث، راجِع تعليمات علامة تتبُّع الإعلانات في 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.