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

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

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

AdMob يمتلك محوِّل التوسّط في 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 كمنصّة توسّط، ثمّ انقر على إنشاء موضع إعلان.

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

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

انقر على تم.

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

تفاصيل OpenUPM

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

سجلات Unity

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

التثبيت من OpenUPM

حزمة Unity

نزِّل أحدث إصدار من المكوّن الإضافي لوسيط إعلانات Google للأجهزة الجوّالة لشبكة قياس أداء الجمهور في Meta من رابط التنزيل في سجلّ التغييرات واستخرِج ملف 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 وتفعيل وضع الاختبار في واجهة مستخدم "شبكة جمهور Facebook".

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

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

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

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

Android

اعتبارًا من الإصدار 9 من Android (المستوى 28 لواجهة برمجة التطبيقات)، يكون خيار استخدام النص الواضح غير مفعّل بشكلٍ default، ما سيؤثّر في وظيفة تخزين الوسائط المؤقت لحزمة تطوير البرامج (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 لمزيد من التفاصيل.

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

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

  • تم تعديل المكوّن الإضافي ليتوافق مع الإصدار التجريبي المفتوح الجديد من Rewarded API.
  • يتوافق مع الإصدار 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) لنظام التشغيل iOS من Facebook