يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض من Meta Audience Network باستخدام التوسّط، والذي يشمل عروض الأسعار عمليات الدمج. ويتناول كيفية إضافة Meta Audience Network إلى تهيئة التوسط، وكيفية دمج Meta Audience Network محوّل في Unity تطبيق.
أشكال الإعلانات وعمليات الدمج المتوافقة
محوِّل التوسّط AdMob في 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 في واجهة مستخدم AdMob
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة Facebook إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية
الخطوة 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
بعد ذلك، انتقل إلى Window > مدير الحزم لفتح Unity Package Manager اختَر سجلاتي من القائمة المنسدلة.
اختَر حزمة توسّط شبكة جمهور البيانات الوصفية لإعلانات Google على الأجهزة الجوّالة و انقر على تثبيت.
حزمة الانسجام
تنزيل أحدث إصدار من مكوّن توسّط إعلانات Google على الأجهزة الجوّالة
Meta Audience Network من رابط التنزيل في
الـ
سجلّ التغييرات
واستخراج
GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
من الرمز البريدي
الملف.
في محرِّر مشروعات Unity، اختَر مواد العرض >. استيراد حزمة >
الحزمة المخصّصة واعثر على
GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
الملف الذي قمت بتنزيله. تأكد من تحديد كل الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض >. محلل خدمات 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: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم 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
- يتوافق مع الإصدار 6.17.0.0 من محوّل Meta Audience Network.
- يتوافق مع الإصدار 6.15.1.0 من محوّل Meta Audience Network على iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.12.0
- يتوافق مع الإصدار 6.17.0.0 من محوّل Meta Audience Network.
- يتوافق مع الإصدار 6.15.0.0 من محوّل Meta Audience Network على iOS.
- تم إنشاء هذا المكوِّن واختباره باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.11.0
- يتوافق مع الإصدار 6.15.0.0 من محوّل Meta Audience Network.
- يتوافق مع الإصدار 6.14.0.0 من محوّل Meta Audience Network على iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.5.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.10.0
- تم نقل محتوى المحوّل إلى
GoogleMobileAds/Mediation/MetaAudienceNetwork/
. - يتوافق مع الإصدار 6.14.0.0 من محوّل Meta Audience Network.
- يتوافق مع الإصدار 6.12.0.1 من محوّل Meta Audience Network على iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.9.1
- يتوافق مع الإصدار 6.12.0.0 من محوّل Meta Audience Network.
- يتوافق مع الإصدار 6.12.0.1 من محوّل Meta Audience Network على iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.4.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.9.0
- يتوافق مع الإصدار 6.12.0.0 من محوّل Meta Audience Network.
- يتوافق مع الإصدار 6.12.0.0 من محوّل Meta Audience Network على iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.3.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.8.0
- تم تغيير اسم المكوِّن الإضافي لتوسّط Unity إلى "Meta Audience Network".
- يتوافق مع الإصدار 6.11.0.1 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 6.11.1.0 من محوّل Meta Audience Network على iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.2 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.7.0
- يتوافق مع الإصدار 6.10.0.0 من محوّل Meta Audience Network.
- يتوافق مع الإصدار 6.10.0.0 من محوّل Meta Audience Network على iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.6.1
- يتوافق مع الإصدار 6.8.0.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 6.9.0.1 من محوّل Meta Audience Network على iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.6.0
- يتوافق مع الإصدار 6.8.0.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 6.8.0.0 من محوّل Meta Audience Network على iOS.
الإصدار 3.5.0
- يتوافق مع الإصدار 6.7.0.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 6.7.0.0 من محوّل Meta Audience Network على iOS.
الإصدار 3.4.0
- يتوافق مع الإصدار 6.6.0.0 من محوّل Android لشبكة Meta Audience Network.
- يتوافق مع الإصدار 6.6.0.0 من محوّل Meta Audience Network على iOS.
الإصدار 3.3.2
- يتوافق مع الإصدار 6.5.1.1 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 6.5.1.0 من محوّل Meta Audience Network على iOS.
الإصدار 3.3.1
- يتوافق مع الإصدار 6.5.1.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 6.5.1.0 من محوّل Meta Audience Network على iOS.
الإصدار 3.3.0
- يتوافق مع الإصدار 6.4.0.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 6.4.1.0 من محوّل Meta Audience Network على iOS.
الإصدار 3.2.0
- يتوافق مع الإصدار 6.2.0.1 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 6.2.1.0 من محوّل Meta Audience Network على iOS.
الإصدار 3.1.0
- يتوافق مع الإصدار 6.2.0.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 6.2.0.0 من محوّل Meta Audience Network على iOS.
الإصدار 3.0.0
- يتوافق مع الإصدار 6.1.0.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 6.0.0.0 من محوّل Meta Audience Network على iOS.
الإصدار 2.12.0
- يتوافق مع الإصدار 5.11.0.0 من محوّل Meta Audience Network.
- يتوافق مع الإصدار 5.10.1.0 من محوّل Meta Audience Network على iOS.
الإصدار 2.11.1
- يتوافق مع الإصدار 5.10.1.0 من محوّل Meta Audience Network.
- يتوافق مع الإصدار 5.10.1.0 من محوّل Meta Audience Network على iOS.
الإصدار 2.11.0
- يتوافق مع الإصدار 5.10.0.0 من محوّل Meta Audience Network.
- يتوافق مع الإصدار 5.10.0.0 من محوّل Meta Audience Network على iOS.
الإصدار 2.10.0
- يتوافق مع الإصدار 5.9.1.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 5.9.0.1 من محوّل Meta Audience Network على iOS.
الإصدار 2.9.2
- يتوافق مع الإصدار 5.9.0.2 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 5.9.0.1 من محوّل Meta Audience Network على iOS.
الإصدار 2.9.1
- يتوافق مع الإصدار 5.9.0.1 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 5.9.0.1 من محوّل Meta Audience Network على iOS.
الإصدار 2.9.0
- يتوافق مع الإصدار 5.9.0.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 5.9.0.0 من محوّل Meta Audience Network على iOS.
الإصدار 2.8.1
- يتوافق مع الإصدار 5.8.0.1 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 5.8.0.2 من محوّل Meta Audience Network على iOS.
الإصدار 2.8.0
- يتوافق مع الإصدار 5.8.0.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 5.8.0.1 من محوّل Meta Audience Network على iOS.
الإصدار 2.7.1 (متوقّف، ويجب استخدام الإصدار 2.8.0 أو إصدار أحدث)
- يتوافق مع الإصدار 5.7.1.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 5.7.1.1 من محوّل Meta Audience Network على iOS.
الإصدار 2.7.0 (متوقّف، ويجب استخدام الإصدار 2.8.0 أو إصدار أحدث)
- يتوافق مع الإصدار 5.7.0.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 5.7.0.0 من محوّل Meta Audience Network على iOS.
الإصدار 2.6.1 (متوقّف، ويجب استخدام الإصدار 2.8.0 أو إصدار أحدث)
- يتوافق مع الإصدار 5.6.1.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 5.6.1.0 من محوّل Meta Audience Network على iOS.
الإصدار
- يتوافق مع الإصدار 5.6.0.0 من محوّل Android Meta Audience Network.
- يتوافق مع الإصدار 5.6.0.0 من محوّل Meta Audience Network على iOS.
الإصدار 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.