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

يوضِّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل إعلانات وعرضها من Meta Audience Network باستخدام التوسّط، ويشمل ذلك عمليات دمج عروض الأسعار. وتتناول كيفية إضافة Meta Audience Network إلى إعدادات توسّط الوحدة الإعلانية، وكيفية دمج Meta Audience Network والمحوّل في تطبيق Unity.

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

يتميّز AdMob محوّل التوسّط لشبكة Meta Audience Network بالإمكانيات التالية:

الدمج
عروض الأسعار
العرض الإعلاني بدون انقطاع  1
التنسيقات
بانر
إعلان بيني
تم منح المكافأة
الإعلانات البينية التي تضم مكافأة

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

المتطلّبات

  • أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
  • Unity 5.6 أو إصدار أحدث
  • المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة للإصدار 2.11.0 من Meta Audience Network (أحدث إصدار مقترح)
  • للنشر على Android:
    • المستوى 21 من واجهة برمجة تطبيقات Android أو أعلى
  • للنشر على iOS:
    • هدف نشر iOS هو 10.0 أو أحدث
    • عادةً ما يتطلب أحدث إصدار من Meta Audience Network SDK استخدام أحدث إصدار من Xcode.
  • مشروع Unity قيد العمل تم إعداده باستخدام "SDK لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على التفاصيل.
  • إكمال دليل البدء للتوسّط

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

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

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

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

إنشاء موقع

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

الخطوة التالية هي اختيار المنصّة لتحقيق الربح.

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

Android

iOS

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

اختر Google AdMob باعتباره منصّة التوسّط، ثمّ انقر على إنشاء موضع إعلان.

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

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

انقر على تم.

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

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

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

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

Android

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

iOS

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

إضافة Facebook إلى قائمة شركاء الإعلانات الذين يخضعون للّائحة العامة لحماية البيانات (GDPR) ولوائح الولايات الأمريكية

اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة Facebook إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في AdMob واجهة المستخدم.

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

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

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

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

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

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

يمكنك مراجعة إرشادات Meta للحصول على معلومات حول الإعلانات المتعلّقة باللائحة العامة لحماية البيانات (GDPR) والإعلانات الوصفية.

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

قوانين الخصوصية في الولايات الأمريكية تتطلب من المستخدمين منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفقًا لما يحدّده القانون) لهذه المصطلحات)، وذلك من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف "البيع". إنّ دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية يوفّر إمكانية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات على 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 (Bidding) مصادر الإعلانات.

خطوات اختيارية

التخزين المؤقت على نظام التشغيل Android 9

Android

بدءًا من نظام التشغيل Android 9 (المستوى 28 لواجهة برمجة التطبيقات)، يتم إيقاف cleartext بشكل تلقائي، ما سيؤثّر في وظائف التخزين المؤقت للوسائط لحزمة تطوير البرامج 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 تعذّر على Meta Audience Network SDK عرض الإعلان البيني/إعلان المكافأة.
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 تعذّر على Meta Audience Network SDK عرض الإعلان البيني/إعلان المكافأة.
105 وحدة التحكّم في العرض الجذري لإعلان البانر هي nil.
106 تعذّر إعداد حزمة تطوير البرامج (SDK) للشبكة Meta Audience Network.
1000-9999 عرضت Meta Audience Network خطأً متعلقًا بحزمة SDK. يمكنك الاطّلاع على مستندات Meta Audience Network للحصول على مزيد من التفاصيل.

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

الإصدار 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 من محوّل Android لنظام التشغيل Facebook.
  • يتوافق مع الإصدار 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 من محوّل Android لنظام التشغيل Facebook.
  • يتوافق مع الإصدار 5.3.2.0 من محوّل Facebook لنظام التشغيل iOS.

الإصدار 2.3.1

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

الإصدار 2.3.0

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

الإصدار 2.2.0

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

الإصدار 2.1.1

  • يتوافق الجهاز مع الإصدار 5.1.0.1 من محوّل Android لنظام التشغيل Facebook.
  • يتوافق مع الإصدار 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 من محوّل Android لنظام التشغيل Facebook.
  • يتوافق مع الإصدار 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 من Google.

الإصدار 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.