يوضِّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات وعرضها من شبكة maio باستخدام التوسّط، وتغطي عمليات دمج العرض الإعلاني بدون انقطاع. كما يتناول كيفية إضافة شبكة maio إلى إعدادات التوسّط في وحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) في maio والمحوّل في أحد تطبيقات Unity.
تستخدم واجهة لوحة المعلومات في maio النص الياباني للتسميات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة في هذا الدليل. ومع ذلك، في الأوصاف والتعليمات هنا، يشار إلى التسميات والأزرار بمقابلاتها باللغة الإنجليزية. على سبيل المثال، "عنوان URL شكرًا ーム" يشير إلى "مخطط عنوان URL"، وما إلى ذلك.
عمليات الدمج وأشكال الإعلانات المتوافقة
يتميّز محوّل التوسّط في شبكة maio بالإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
الإعلانات البينية | |
تم منح المكافأة |
المتطلّبات
- Unity 4 أو أعلى
- أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
- للنشر على Android:
- المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android
- للنشر على iOS:
- هدف نشر iOS هو 12.0 أو إصدار أحدث
- مشروع Unity عملي تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: ضبط الإعدادات في واجهة مستخدم maio
أولاً، اشترِك أو سجّل الدخول إلى حسابك في maio. انقر على زر إدارة التطبيقات في الشريط الجانبي الأيمن وانقر على تطبيق جديد.
اختَر علامة التبويب المقابلة لنوع الإعلان المفضّل لديك.
إعلان بيني
أدخِل اسم تطبيقك واختَر النظام الأساسي وأدخِل عنوان URL للتطبيق. اختَر إعلان فيديو بيني كنوع الإعلان، ثم انقر على تعديل.
Android
iOS
تم منح المكافأة
أدخِل اسم تطبيقك واختَر النظام الأساسي وأدخِل عنوان URL للتطبيق. اختَر مكافآت الفيديو على أنّه نوع الإعلان، ثم انقر على تعديل.
Android
iOS
في صفحة إدارة التطبيقات، دوِّن معرّف الوسائط. عليك إعداد وحدتك Ad Manager الإعلانية في القسم التالي.
Android
iOS
في صفحة إدارة المنطقة، يمكنك تدوين رقم تعريف المنطقة. سيُطلب منك أيضًا إعداد Ad Manager وحدتك الإعلانية في القسم التالي.
Android
iOS
الخطوة 2: إعداد الطلب في شبكة maio في Ad Manager واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) في maio والمحوّل
نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في شبكة maio من رابط التنزيل في سجلّ التغييرات
في منطقة مايو ثم استخرِج GoogleMobileAdsMaioMediation.unitypackage
من ملف zip.
في محرّر مشروع Unity، اختَر Assets >Import Package > Custom
الحزمة وابحث عن الملف GoogleMobileAdsMaioMediation.unitypackage
الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.
بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android >
فرض الحل. ستنفِّذ مكتبة أداة حلّ المشاكل في Unity Play حلّ مشكلة الاعتماد من البداية وستنسخ التبعيات المُعلَنة إلى دليل Assets/Plugins/Android
في تطبيق Unity.
الخطوة 4: إضافة الرمز المطلوب
Android
ليس من المطلوب استخدام رمز إضافي للدمج في maio.
iOS
دمج SKAdNetwork
اتّبِع مستندات Maio
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist
الخاص بمشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل Ad Manager.
بالنسبة إلى الناشرين الذين يستخدمون الإصدار 7.26.0 أو الإصدارات الأحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة، سيتلقّى الناشرون إعلانات اختبارية من شبكة maio على الهواتف والأجهزة اللوحية المسجّلة كـ أجهزة اختبارية عند تقديم طلباتهم.
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من maio، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام maio (Bidding) and 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 | سبق أن تم تحميل إعلان لإعداد الشبكة هذه. |
سجلّ تغييرات المكوّن الإضافي لتوسّط maio Unity
الإصدار 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 من محوّل Android في Maio.
- يتوافق مع الإصدار 1.6.3.0 من محوّل Maio لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.4.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.4.1
- يتوافق مع الإصدار 1.1.16.1 من محوّل Android في 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 من محوّل Android في 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 من محوّل maio iOS.
الإصدار 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 من محوّل maio iOS.
الإصدار 1.2.0
- يتوافق الجهاز مع الإصدار 1.1.4.1 من محوِّل Android maio.
- يتوافق مع الإصدار 1.4.0.0 من محوّل maio iOS.
الإصدار 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 من محوّل maio iOS.
الإصدار 1.1.0
- يتوافق مع الإصدار 1.1.0.0 من محوّل Android في شبكة maio.
- يتوافق مع الإصدار 1.3.0.0 من محوّل maio iOS.
الإصدار 1.0.2
- يتوافق مع الإصدار 1.0.8 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android في شبكة maio.
- يتوافق مع الإصدار 1.2.19 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS في شبكة maio.
الإصدار 1.0.1
- يتوافق الجهاز مع الإصدار 1.0.7 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android في شبكة maio.
- يتوافق مع الإصدار 1.2.19 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS في شبكة maio.
الإصدار 1.0.0
- الإصدار الأول
- يتوافق مع الإصدار 1.0.6 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android في شبكة maio.
- يتوافق مع الإصدار 1.2.18 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS في شبكة maio.