يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من شبكة maio باستخدام التوسّط، التي تغطي عمليات دمج الشلال. فهو يتناول كيفية إضافة شبكة إعلانية إلى صفحة إعلان إعدادات التوسّط وكيفية دمج مهايئ وحزمة تطوير البرامج (SDK) لمنصة maio في Unity.
تستخدم واجهة لوحة المعلومات في maio النص الياباني للتسميات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة الواردة في هذا الدليل. ومع ذلك، في الأوصاف والتعليمات هنا، فإن التسميات والأزرار الذين يشيرون إليهم بمكافئاتهم باللغة الإنجليزية. على سبيل المثال، "URL スキーム" يعني "URL Scheme"، وما إلى ذلك.
أشكال الإعلانات وعمليات الدمج المتوافقة
تتوفّر في محوّل التوسّط لنظام التشغيل maio الإمكانات التالية:
| الدمج | |
|---|---|
| عروض الأسعار | |
| شلال | |
| التنسيقات | |
| بانر | |
| الإعلانات البينية | |
| تم منح المكافأة | |
المتطلبات
- Unity 4 أو إصدار أحدث
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Unity قيد التشغيل تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". عرض البدء لمعرفة التفاصيل.
- إكمال التوسّط دليل البدء
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم maio
الخطوة 2: إعداد البيانات الشخصية في واجهة مستخدم AdMob
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة SDK ومحوِّل maio
OpenUPM-CLI
إذا كان لديك OpenUPM-CLI يمكنك تثبيت إعلانات Google للجوّال المكوّن الإضافي للتوسّط for Unity إلى مشروعك من خلال تشغيل الأمر التالي من الدليل الجذري لمشروعك:
openupm add com.google.ads.mobile.mediation.maio
OpenUPM
في محرِّر مشروع Unity، اختَر تعديل >. إعدادات المشروع > مدير الحزم لفتح إعدادات Unity Package Manager
ضمن علامة التبويب السجلات المندرجة ضمن النطاق، أضِف OpenUPM كسجلّ نطاق محدَّد باستخدام التفاصيل التالية:
- الاسم:
OpenUPM - عنوان URL:
https://package.openupm.com - النطاقات:
com.google
بعد ذلك، انتقل إلى Window > مدير الحزم لفتح Unity Package Manager اختَر سجلاتي من القائمة المنسدلة.
حدّد حزمة وساطة إعلانات Google للجوّال انقر على تثبيت.
حزمة الانسجام
نزِّل أحدث إصدار من المكوّن الإضافي لدمج إعلانات Google للأجهزة الجوّالة في
maio من رابط التنزيل في
سجلّ التغييرات
واسحب ملف
GoogleMobileAdsMaioMediation.unitypackage من ملف zip
.
في محرِّر مشروع Unity، اختَر مواد العرض > استيراد حزمة >
حزمة مخصّصة وابحث عن
GoogleMobileAdsMaioMediation.unitypackage
الملف الذي نزّلته. تأكد من تحديد كل الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض >. محلل خدمات Play >
أداة تحليل Android > فرض الحل: ستنفِّذ مكتبة Unity Play Services Resolver
حلّ التبعيات من البداية وستنسخ
التبعيات المعلَن عنها إلى الدليل Assets/Plugins/Android في
تطبيق Unity.
الخطوة 4: إضافة الرمز المطلوب
Android
ولن يُطلب منك استخدام رمز إضافي لدمج شبكة maio.
iOS
دمج SKAdNetwork
متابعة مستندات maio
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل AdMob.
بالنسبة إلى الناشرين الذين يستخدمون الإصدار 7.26.0 أو الإصدارات الأحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة، سيتلقّى الناشرون إعلانات اختبارية من شبكة maio على الهواتف والأجهزة اللوحية المسجّلة كـ أجهزة اختبارية عند تقديم طلباتهم.
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من maio، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام maio (Waterfall) مصادر الإعلانات.
رموز الخطأ
وفي حال لم يتمكن المحوّل من استلام إعلان من شبكة الجوّال maio، يمكن للناشرين التحقّق من
خطأ أساسي من استجابة الإعلان باستخدام
ResponseInfo ضمن
الفئات التالية:
Android
| التنسيق | اسم الصف |
|---|---|
| إعلان بيني | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| تم منح المكافأة | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
| التنسيق | اسم الصف |
|---|---|
| إعلان بيني | GADMMaioInterstitialAdapter |
| تم منح المكافأة | GADMMaioRewardedAdapter |
في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل maio عند تعذّر تحميل إعلان:
Android
| رمز الخطأ | السبب |
|---|---|
| 0-10 | عرَضَ maio خطأً خاصًا بحزمة تطوير البرامج (SDK). الاطّلاع على الرمز ووثائق مايو لمزيد من التفاصيل. |
| 101 | لا يتوفّر إعلان في صحيفة Maio. |
| 102 | معلمات الخادم غير صالحة (على سبيل المثال، رقم تعريف موضع الإعلان مفقود). |
| 103 | السياق المستخدَم لتحميل إعلان ليس حالة "نشاط". |
iOS
| رمز الخطأ | السبب |
|---|---|
| 0-10 | عرَضَ maio خطأً خاصًا بحزمة تطوير البرامج (SDK). عرض رمز maio لمزيد من التفاصيل. |
| 101 | لا يتوفر إعلان لدى maio حتى الآن. |
| 102 | معلمات الخادم غير صالحة (على سبيل المثال، رقم تعريف موضع الإعلان مفقود). |
| 103 | لا يدعم محول maio تنسيق الإعلان المطلوب. |
| 104 | سبق أن تم تحميل إعلان لإعداد الشبكة هذه. |
سجلّ تغييرات المكوّن الإضافي لتوسّط Unity في maio
الإصدار 2.0.3
- يتوافق مع الإصدار 1.1.16.3 من محوّل نظام التشغيل maio.
- يتوافق مع إصدار محوِّل maio iOS 2.1.5.0.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.0.2
- متوافق مع الإصدار 1.1.16.3 من محوِّل Android من maio.
- يتوافق مع الإصدار 2.1.4.0 من محوِّل maio iOS.
- تم إنشاء هذا المكوِّن واختباره باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.0.1
- يتوافق مع الإصدار 1.1.16.2 من محوّل Android maio.
- يتوافق مع الإصدار 2.1.3.0 من محوّل maio iOS.
- تم إنشاء هذا المكوِّن واختباره باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.0.0
- متوافق مع الإصدار 1.1.16.2 من محوِّل Android من maio.
- يتوافق مع الإصدار 2.1.1.0 من محوّل maio iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.6.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.4.3
- تم نقل محتوى المحوِّل إلى
GoogleMobileAds/Mediation/Maio/. - متوافق مع الإصدار 1.1.16.2 من محوِّل Android من maio.
- يتوافق مع الإصدار 1.6.3.1 من محوّل maio iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.4.2
- يتوافق مع الإصدار 1.1.16.1 من محوّل نظام التشغيل maio.
- يتوافق مع الإصدار 1.6.3.0 من محوّل maio iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.4.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.4.1
- يتوافق مع الإصدار 1.1.16.1 من محوّل نظام التشغيل maio.
- يتوافق مع الإصدار 1.6.2.0 من محوّل maio iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 7.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.4.0
- يتوافق مع الإصدار 1.1.16.0 من مهايئ Android maio.
- يتوافق مع الإصدار 1.6.0.1 من محوّل maio iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.3.6
- يتوافق مع الإصدار 1.1.16.0 من مهايئ Android maio.
- يتوافق مع الإصدار 1.5.8.0 من محوّل maio iOS.
الإصدار 1.3.5
- متوافق مع الإصدار 1.1.15.0 من محوِّل Android من maio.
- يتوافق مع الإصدار 1.5.6.1 من محوّل maio iOS.
الإصدار 1.3.4
- يتوافق مع الإصدار 1.1.11.1 من محوّل نظام التشغيل maio.
- يتوافق مع الإصدار 1.5.4.0 من محوّل maio iOS.
الإصدار 1.3.3
- يتوافق مع الإصدار 1.1.11.1 من محوّل نظام التشغيل maio.
- يتوافق مع الإصدار 1.5.3.1 من محوّل maio iOS.
الإصدار 1.3.2
- يتوافق مع الإصدار 1.1.11.0 من مهايئ Android maio.
- يتوافق مع الإصدار 1.5.2.1 من محوّل maio iOS.
الإصدار 1.3.1
- يتوافق مع الإصدار 1.1.10.0 من محوّل نظام التشغيل maio.
- يتوافق مع الإصدار 1.5.1.0 من محوِّل maio iOS.
الإصدار 1.3.0
- متوافق مع الإصدار 1.1.10.0 من محوِّل Android من maio.
- يتوافق مع الإصدار 1.5.0.0 من محوّل maio iOS.
الإصدار 1.2.3
- تم تحديث المكوّن الإضافي لإتاحة Bonus API الجديدة.
- يتوافق مع الإصدار 1.1.7.0 من محول Android maio.
- يتوافق مع الإصدار 1.4.6.0 من محوّل iOS الذي يعمل بنظام التشغيل maio.
الإصدار 1.2.2
- يتوافق مع الإصدار 1.1.6.0 من محول Android maio.
- يتوافق مع الإصدار 1.4.2.0 من محوّل maio iOS.
الإصدار 1.2.1
- يتوافق مع الإصدار 1.1.6.0 من محول Android maio.
- يتوافق مع الإصدار 1.4.1.0 من محوّل iOS الذي يعمل بنظام التشغيل maio.
الإصدار 1.2.0
- يتوافق مع الإصدار 1.1.4.1 من محول Android maio.
- يتوافق مع الإصدار 1.4.0.0 من محوّل iOS الذي يعمل بنظام التشغيل maio.
الإصدار 1.1.3
- يتوافق مع الإصدار 1.1.3.1 من محول Android maio.
- يتوافق مع الإصدار 1.3.2.0 من محوّل maio iOS.
الإصدار 1.1.2
- يتوافق مع الإصدار 1.1.3.0 من محول Android maio.
- يتوافق مع الإصدار 1.3.2.0 من محوّل maio iOS.
الإصدار 1.1.1
- يتوافق مع الإصدار 1.1.1.0 من محوِّل Android.
- يتوافق مع الإصدار 1.3.1.1 من محوّل iOS الذي يعمل بنظام التشغيل maio.
الإصدار 1.1.0
- يتوافق مع الإصدار 1.1.0.0 من محول Android maio.
- يتوافق مع الإصدار 1.3.0.0 من محوّل iOS الذي يعمل بنظام التشغيل maio.
الإصدار 1.0.2
- يتوافق مع الإصدار 1.0.8 من حزمة تطوير البرامج (SDK) لنظام التشغيل maio.
- تتوافق مع الإصدار 1.2.19 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS.
الإصدار 1.0.1
- يتوافق مع الإصدار 1.0.7 من حزمة تطوير البرامج (SDK) لنظام التشغيل maio.
- يتوافق مع الإصدار 1.2.19 من حزمة تطوير البرامج لنظام التشغيل iOS من maio.
الإصدار 1.0.0
- الإصدار الأول!
- يتوافق مع الإصدار 1.0.6 من حزمة تطوير البرامج (SDK) لنظام التشغيل maio.
- يتوافق مع الإصدار 1.2.18 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من maio.