يوضِّح لك هذا الدليل كيفية استخدام حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة لتحميل الإعلانات وعرضها من شبكة الجوّال باستخدام التوسّط، الذي يشمل عمليات دمج العرض الإعلاني بدون انقطاع. ويتناول كيفية إضافة شبكة Maio إلى إعداد التوسط لوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) لمنصة maio والمحوّل في تطبيق Unity.
تستخدم واجهة لوحة البيانات في maio النص الياباني للتسميات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة في هذا الدليل. ومع ذلك، في الأوصاف والتعليمات هنا، يُشار إلى التسميات والأزرار بما نظيرها في اللغة الإنجليزية. على سبيل المثال، "عنوان URL ಠ Voiceーム"، هو "مخطّط عنوان URL" وما إلى ذلك.
أشكال الإعلانات وعمليات الدمج المتوافقة
تتوفّر في محوّل التوسّط لنظام التشغيل 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: إعداد البيانات الشخصية في واجهة مستخدم AdMob
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد مهايئ وحزمة تطوير البرامج (SDK) لمنصة maio
نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في شبكة maio من رابط التنزيل في سجلّ التغييرات في علامة التبويب "مايو" واستخرِج GoogleMobileAdsMaioMediation.unitypackage من ملف ZIP.
في محرِّر مشروعات Unity، اختَر مواد العرض > استيراد حزمة > حزمة
مخصّصة وابحث عن ملف GoogleMobileAdsMaioMediation.unitypackage الذي نزّلته. تأكَّد من اختيار كل الملفات وانقر على استيراد.
بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android > فرض الحل. ستنفِّذ مكتبة Unity Play Services محللاً تحليلاً للتبعية من البداية وتنسخ الملحقات المُعلَن عنها إلى
دليل 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. يمكنك الاطّلاع على مستندات code وmaio لمزيد من التفاصيل. |
| 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.
- يتوافق مع الإصدار 2.1.5.0 من محوّل maio iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 2.0.2
- يتوافق مع الإصدار 1.1.16.3 من محوّل نظام التشغيل 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 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 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 من محوّل نظام التشغيل 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 maio.
- يتوافق مع الإصدار 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 من حزمة تطوير البرامج لنظام التشغيل iOS من maio.
الإصدار 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.