يوضّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات من maio وعرضها باستخدام التوسّط، ويشمل ذلك عمليات دمج العرض الإعلاني بدون انقطاع. ويتناول هذا الدليل كيفية إضافة 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
أولاً، اشترك أو سجّل الدخول إلى حسابك في maio. انقر على زر إدارة التطبيقات في الشريط الجانبي الأيمن، ثم انقر على تطبيق جديد.
اختَر علامة التبويب المقابلة لنوع الإعلان المفضّل لديك.
إعلان بيني
أدخِل اسم تطبيقك، واختَر النظام الأساسي للتطبيق، ثم أدخِل عنوان URL للتطبيق. اختَر إعلان بيني في الفيديو كـ نوع الإعلان، ثمّ انقر على تعديل.
Android
iOS
تم منح المكافأة
أدخِل اسم تطبيقك، واختَر النظام الأساسي وقدِّم عنوان URL للتطبيق. اختَر مكافآت الفيديو على أنّها نوع الإعلان، ثم انقر على تعديل.
Android
iOS
في صفحة إدارة التطبيقات، دوِّن معرّف الوسائط. يجب إعداد وحدتك الإعلانية على AdMob في القسم التالي.
Android
iOS
في صفحة إدارة المنطقة، دوِّن رقم تعريف المنطقة. سيكون عليك أيضًا إعداد وحدتك الإعلانية على AdMob في القسم التالي.
Android
iOS
الخطوة 2: إعداد طلب مايو في Ad Manager واجهة المستخدِم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة SDK ومحوِّل maio
OpenUPM-CLI
إذا كان لديك OpenUPM-CLI مثبّتًا، يمكنك تثبيت الإضافة Mediation Plugin for Unity لإعلانات Google على الأجهزة الجوّالة في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:
openupm add com.google.ads.mobile.mediation.maioOpenUPM
في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > مدير الحِزم لفتح إعدادات مدير حزم Unity.
ضمن علامة التبويب السجلات المندرجة ضمن النطاق، أضِف OpenUPM كسجلّ نطاق واسع مع تقديم التفاصيل التالية:
- الاسم:
OpenUPM - عنوان URL:
https://package.openupm.com - النطاقات:
com.google
بعد ذلك، انتقِل إلى النافذة > مدير الحِزم لفتح مدير حِزم Unity و اختَر السجلّات الخاصة بي من القائمة المنسدلة.
اختَر حزمة Google Mobile Ads maio Mediation وانقر على تثبيت.
حزمة Unity
نزِّل أحدث إصدار من المكوّن الإضافي لدمج إعلانات Google للأجهزة الجوّالة في
maio من رابط التنزيل في
سجلّ التغييرات
واستخرِج
GoogleMobileAdsMaioMediation.unitypackage منملف zip
.
في محرِّر مشروع Unity، اختَر مواد العرض > استيراد حزمة >
حزمة مخصّصة وابحث عن
GoogleMobileAdsMaioMediation.unitypackage
الملف الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض > مدير التبعية الخارجية >
أداة حل Android > فرض الحل. ستنفذ مكتبة مدير التبعية الخارجية حل التبعية من البداية وتنسخ
التبعيات المُعلنة إلى دليل Assets/Plugins/Android في
تطبيق Unity.
الخطوة 4: إضافة الرمز المطلوب
Android
ولن يُطلب منك استخدام رمز إضافي لدمج شبكة maio.
iOS
دمج SKAdNetwork
اتّبِع مستندات maio
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist في مشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob.
سيتلقّى الناشرون الذين يستخدمون الإصدار 7.26.0 أو إصدارًا أحدث من "مجموعة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" تلقائيًا إعلانات اختبارية من maio على الهواتف والأجهزة اللوحية المسجّلة على أنّها أجهزة اختبارية عند تقديم الطلبات.
إثبات صحة الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من maio، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات maio (العرض بدون انقطاع).
رموز الخطأ
إذا تعذّر على المحوّل استلام إعلان من 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.4
- متوافق مع الإصدار 1.1.16.3 من محوِّل Android من maio.
- يتوافق مع الإصدار 2.1.5.1 من محوّل maio iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.3.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.0.3
- متوافق مع الإصدار 1.1.16.3 من محوِّل Android من maio.
- يتوافق مع إصدار محوِّل maio iOS 2.1.5.0.
- تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.0.2
- متوافق مع الإصدار 1.1.16.3 من محوِّل Android من maio.
- يتوافق مع الإصدار 2.1.4.0 من محوِّل maio iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.0.1
- متوافق مع الإصدار 1.1.16.2 من محوِّل Android من maio.
- يتوافق مع الإصدار 2.1.3.0 من محوّل maio iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.0.0
- متوافق مع الإصدار 1.1.16.2 من محوِّل Android من maio.
- يتوافق مع الإصدار 2.1.1.0 من محوِّل maio iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 8.6.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 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 من محوّل Android maio.
- يتوافق مع الإصدار 1.6.3.0 من محوّل maio iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 7.4.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.4.1
- متوافق مع الإصدار 1.1.16.1 من محوِّل Android من 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 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.3.6
- يتوافق مع الإصدار 1.1.16.0 من محوّل نظام التشغيل maio.
- متوافق مع إصدار محوِّل maio iOS 1.5.8.0.
الإصدار 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 من محوِّل Android من 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 من محوِّل Android من 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
- تم تعديل المكوّن الإضافي ليتوافق مع واجهة برمجة التطبيقات الجديدة لنظام "المكافآت".
- يتوافق مع الإصدار 1.1.7.0 من محوِّل Android من maio.
- يتوافق مع الإصدار 1.4.6.0 من محوّل iOS الذي يعمل بنظام التشغيل maio.
الإصدار 1.2.2
- متوافق مع الإصدار 1.1.6.0 من محوِّل Android
- يتوافق مع الإصدار 1.4.2.0 من محوّل maio iOS.
الإصدار 1.2.1
- متوافق مع الإصدار 1.1.6.0 من محوِّل Android
- يتوافق مع الإصدار 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.
- يتوافق مع محوِّل iOS من maio 1.3.2.0.
الإصدار 1.1.1
- يتوافق مع الإصدار 1.1.1.0 من محوِّل Android.
- يتوافق مع الإصدار 1.3.1.1 من محوّل iOS الذي يعمل بنظام التشغيل maio.
الإصدار 1.1.0
- متوافق مع الإصدار 1.1.0.0 من محوِّل Android من maio
- يتوافق مع محوِّل iOS من maio 1.3.0.0.
الإصدار 1.0.2
- تتوافق مع الإصدار 1.0.8 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
- تتوافق مع الإصدار 1.2.19 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS.
الإصدار 1.0.1
- يتوافق مع الإصدار 1.0.7 من حزمة تطوير البرامج (SDK) لنظام التشغيل maio.
- تتوافق مع الإصدار 1.2.19 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS.
الإصدار 1.0.0
- الإصدار الأول
- تتوافق مع الإصدار 1.0.6 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
- تتوافق مع الإصدار 1.2.18 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS.