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

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

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

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

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

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

المتطلبات

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI يمكنك تثبيت Meta Audience Network لإعلانات Google على الأجهزة الجوّالة المكوّن الإضافي للتوسّط for Unity إلى مشروعك من خلال تشغيل الأمر التالي من الدليل الجذري لمشروعك:

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

OpenUPM

في محرِّر مشروع Unity، اختَر تعديل >. إعدادات المشروع > مدير الحزم لفتح إعدادات Unity Package Manager

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

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

تفاصيل OpenUPM

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

سجلات الانسجام

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

التثبيت من OpenUPM

حزمة الانسجام

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

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

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

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

فرض الحل

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

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

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

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

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

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

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

Android

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

iOS

دمج SKAdNetwork

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

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

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

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

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

احرص على تسجيل جهاز الاختبار من أجل Ad Manager وتفعيل وضع الاختبار في واجهة المستخدم Meta Audience Network .

التحقّق من الإعلانات الاختبارية

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

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

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

Android

بدءًا من Android 9 (المستوى 28 من واجهة برمجة التطبيقات)، يتم إيقاف دعم النص الواضح من خلال التلقائي، ما سيؤثر في وظائف التخزين المؤقت للوسائط في Meta Audience حزمة تطوير البرامج (SDK) للشبكة ويمكن أن تؤثر في تجربة المستخدم وأرباح الإعلانات. متابعة Meta's المستندات لتعديل إعدادات أمان الشبكة في تطبيقك.

iOS

لا ينطبق ذلك على عمليات دمج iOS.

رموز الخطأ

إذا تعذّر على المحوّل استلام إعلان من Audience Network، يمكنك التحقّق من خطأ أساسي من استجابة الإعلان باستخدام ResponseInfo ضمن الفئات التالية:

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

في ما يلي الرموز والرسائل المصاحبة التي يطرحها جمهور Meta محوّل الشبكة عند تعذُّر تحميل إعلان:

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.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.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.

الإصدار

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

الإصدار

  • يتوافق مع الإصدار 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) لنظام التشغيل Facebook Android.
  • يتوافق مع الإصدار 4.28.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Facebook iOS.

الإصدار 1.0.0

  • الإصدار الأول!
  • يتوافق مع الإصدار 4.27.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Facebook Android.
  • يتوافق مع الإصدار 4.27.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Facebook iOS.