دمج 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 الميزات التالية:

التكامل
عروض الأسعار
العرض الإعلاني بدون انقطاع  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 مثبّتًا، يمكنك تثبيت المكوّن الإضافي لتوسّط Meta Audience Network في "إعلانات Google على الأجهزة الجوّالة" لمنصة 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 > فرض الحلّ. ستعمل مكتبة "مدير التبعية الخارجية" على حلّ التبعية من البداية ونسخ التبعيات المُعلَن عنها إلى دليل 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

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