يوضّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (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
في صفحة إدارة التطبيقات، دوِّن معرّف الوسائط. يجب إعداد وحدتك الإعلانية في "مدير إعلانات Google" في القسم التالي.
Android
iOS
في صفحة إدارة المنطقة، دوِّن رقم تعريف المنطقة. سيكون مطلوبًا أيضًا إعداد وحدتك الإعلانية في "مدير إعلانات Google" في القسم التالي.
Android
iOS
الخطوة 2: إعداد طلب مايو في Ad Manager واجهة المستخدِم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل استخدام iOS.
الخطوة 3: استيراد حزمة SDK ومحوِّل maio
OpenUPM-CLI
إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت "مكوّن إضافي لتوسّط maiO في إعلانات Google للأجهزة الجوّالة" لنظام Unity في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:
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: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك التجريبي في "مدير إعلانات Google".
سيتلقّى الناشرون الذين يستخدمون الإصدار 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 | سبق أن تم تحميل إعلان لإعدادات الشبكة هذه. |
سجلّ التغييرات في "مكوّن توسّط إعلانات Unity" من maio
الإصدار 2.0.4
- متوافق مع الإصدار 1.1.16.3 من محوِّل Android من maio.
- متوافق مع إصدار محوِّل maio iOS 2.1.5.1.
- تم إنشاؤه واختباره باستخدام الإصدار 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 من محوِّل 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 من محوِّل 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.
- يتوافق مع إصدار محوِّل maio iOS 1.5.0.0.
الإصدار 1.2.3
- تم تعديل المكوّن الإضافي ليتوافق مع واجهة برمجة التطبيقات الجديدة لنظام "المكافآت".
- متوافق مع الإصدار 1.1.7.0 من محوِّل Android
- يتوافق مع الإصدار 1.4.6.0 من محوِّل iOS من maio.
الإصدار 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 من maio.
- يتوافق مع محوِّل 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.