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

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

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

يمتلك Ad Manager محوِّل التوسّط في Meta Audience Network الإمكانات التالية:

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

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

المتطلبات

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

الخطوة 1: إعداد الإعدادات في واجهة مستخدم "شبكة جمهور Facebook"

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

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

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

إنشاء موقع

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

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

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

Android

iOS

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

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

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

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

انقر على تم.

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

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

الخطوة 2: إعداد طلب شبكة Audience Network من Meta في Ad Manager واجهة المستخدِم

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

Android

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

iOS

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

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

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

الخطوة 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.

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

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

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى النافذة > مدير الحِزم لفتح مدير حِزم Unity و اختَر السجلّات الخاصة بي من القائمة المنسدلة.

سجلات Unity

اختَر حزمة توسّط Meta Audience Network في "إعلانات Google" للأجهزة الجوّالة وانقر على تثبيت.

التثبيت من OpenUPM

حزمة Unity

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

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

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

بعد ذلك، اختَر مواد العرض > مدير التبعيات الخارجية > Android Resolver > Force Resolve (حلّ المشاكل بالقوة). ستنفذ مكتبة مدير التبعية الخارجية حل التبعية من البداية وتنسخ التبعيات المُعلنة إلى دليل Assets/Plugins/Android في تطبيق Unity.

فرض الحل

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

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

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

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

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

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

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

Android

ليس عليك استخدام رمز إضافي لدمج Meta Audience Network.

iOS

دمج SKAdNetwork

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

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

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

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

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

تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم Meta Audience Network.

إثبات صحة الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من Meta Audience Network، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات في Meta Audience Network (عروض الأسعار).

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

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

Android

بدءًا من الإصدار 9 من نظام Android (المستوى 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.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

الإصدار

  • يتوافق مع الإصدار 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.

الإصدار 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) لنظام التشغيل Facebook iOS.