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

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

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

يتضمّن برنامج التكييف الخاص بالتوسّط في AdMob لشبكة Meta Audience Network الإمكانات التالية:

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

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

المتطلبات

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

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

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

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

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

إنشاء موقع

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

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

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

Android

iOS

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

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

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

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

انقر على تم.

تعديل ملف app-ads.txt

مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، عليك إعداد ملف app-ads.txt لتطبيقك.

لتنفيذ app-ads.txt في Meta Audience Network، اطّلِع على تحديد البائعين المعتمَدين باستخدام app-ads.txt.

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت Google Mobile Ads Meta Audience Network Mediation Plugin for Unity في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

openupm add com.google.ads.mobile.mediation.metaaudiencenetwork

OpenUPM

في أداة تعديل مشروع Unity، اختَر تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحِزم (Package Manager) لفتح إعدادات "إدارة حِزم Unity" (Unity Package Manager Settings).

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

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

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager (إدارة حِزم Unity)، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.

Unity Registries

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

التثبيت من OpenUPM

حزمة Unity

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

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

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

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

فرض الحلّ

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

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

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

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

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

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

التخزين المؤقت على 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.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 من محوّل Android في Facebook.
  • يتوافق مع الإصدار 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.