يوضّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات من maio وعرضها باستخدام التوسّط، ويتناول دمج الإعلانات بدون انقطاع. ويتناول هذا الدليل كيفية إضافة maio إلى إعدادات التوسّط لوحدة إعلانية، وكيفية دمج حزمة SDK ومحوِّل maio في تطبيق Unity.
تستخدم واجهة لوحة بيانات maio النص الياباني للقوائم والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة الواردة في هذا الدليل. ومع ذلك، في الأوصاف والتعليمات الواردة هنا، تتم الإشارة إلى التصنيفات والأزرار باستخدام الأسماء المقابلة لها باللغة الإنجليزية. على سبيل المثال، "URL スキーム" يعني "مخطّط عنوان 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
OpenUPM-CLI
إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت "مكوّن إضافي للتوسّط في maio" لإعلانات Google على الويب المتوافقة مع Unity في مشروعك من خلال تنفيذ الأمر التالي من directory root لمشروعك:
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 Resolver > Force Resolve (حلّ المشاكل بالقوة). ستنفِّذ مكتبة "مدير التبعية الخارجية"
عملية حلّ التبعية من البداية وستنسخ
التبعيات المعلَن عنها إلى الدليل 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). اطّلِع على رمز مايو لمعرفة المزيد من التفاصيل. |
| 101 | لا يتوفّر إعلان في maio بعد. |
| 102 | مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف موضع الإعلان) |
| 103 | لا يتيح محوِّل maio تنسيق الإعلان المطلوب. |
| 104 | سبق أن تم تحميل إعلان لإعدادات الشبكة هذه. |
سجلّ التغييرات في مكوّن maio Unity Mediation الإضافي
الإصدار 2.0.4
- متوافق مع الإصدار 1.1.16.3 من محوِّل Android من maio.
- متوافق مع الإصدار 2.1.5.1 من محوِّل iOS من maio.
- تم إنشاؤه واختباره باستخدام الإصدار 9.3.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 2.0.3
- متوافق مع الإصدار 1.1.16.3 من محوِّل Android من maio.
- يتوافق مع إصدار 2.1.5.0 من محوِّل maio iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 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 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.4.2
- يتوافق مع الإصدار 1.1.16.1 من محوِّل Android من maio.
- يتوافق مع الإصدار 1.6.3.0 من محوِّل iOS من maio.
- تم إنشاؤه واختباره باستخدام الإصدار 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 من محوِّل 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
- يتوافق مع محوِّل iOS من maio الإصدار 1.4.6.0.
الإصدار 1.2.2
- يتوافق مع الإصدار 1.1.6.0 من محوِّل Android.
- يتوافق مع محوِّل iOS من maio الإصدار 1.4.2.0.
الإصدار 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.
- يتوافق مع محوِّل iOS من maio الإصدار 1.3.2.0.
الإصدار 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.
- يتوافق مع محوِّل 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) لنظام التشغيل Android
- تتوافق مع الإصدار 1.2.19 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS.
الإصدار 1.0.0
- الإصدار الأول
- تتوافق مع الإصدار 1.0.6 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
- تتوافق مع الإصدار 1.2.18 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS.