دمج شبكة Maio مع ميزة التوسّط

يوضّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (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

ملاحظة: تكون الإعلانات البينية من maio قابلة للتخطّي تلقائيًا.

تم منح المكافأة

أدخِل اسم تطبيقك، واختَر النظام الأساسي وقدِّم عنوان URL للتطبيق. اختَر المكافآت في الفيديو كـ نوع الإعلان، ثم انقر على تعديل.

Android

iOS

ملاحظة: إعلانات الفيديو التي تضم مكافآت من maio لا يمكن تخطّيها تلقائيًا.

في صفحة إدارة التطبيقات، دوِّن معرّف الوسائط. يجب إعداد وحدتك الإعلانية على AdMob في القسم التالي.

Android

iOS

في صفحة إدارة المنطقة، دوِّن رقم تعريف المنطقة. سيكون عليك أيضًا إعداد وحدتك الإعلانية على AdMob في القسم التالي.

Android

iOS

(العرض الإعلاني بدون انقطاع فقط) بالإضافة إلى معرّف الوسائط ومعرّف المنطقة، ستحتاج إلى معرّف واجهة برمجة التطبيقات و مفتاح واجهة برمجة التطبيقات لإعداد رقم تعريف الوحدة الإعلانية للتوسّط. في صفحة Reporting API، دوِّن معرّف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات.

ملاحظة: (العرض الإعلاني بدون انقطاع فقط) إذا كانت هذه هي المرة الأولى التي تُعدّ فيها حسابك على maio، قد تحتاج إلى التواصل مع فريق دعم maio للحصول على رقم تعريف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات.

الخطوة 2: إعداد طلب مايو في Ad Manager واجهة المستخدِم

ضبط إعدادات التوسّط لوحدتك الإعلانية

Android

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل استخدام iOS.

الخطوة 3: استيراد حزمة SDK ومحوِّل maio

OpenUPM-CLI

ملاحظة مهمة: في حال كنت بصدد نقل البيانات من استخدام .unitypackage إلى استخدام OpenUPM-CLI، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم من خلال حذف جميع الملفات من المجلد Assets/GoogleMobileAds/Mediation/Maio.

إذا كان لديك OpenUPM-CLI مثبّتًا، يمكنك تثبيت الإضافة Mediation Plugin for Unity لإعلانات Google على الأجهزة الجوّالة في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

openupm add com.google.ads.mobile.mediation.maio

OpenUPM

ملاحظة مهمة: في حال نقل البيانات من استخدام .unitypackage إلى استخدام OpenUPM، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم من خلال حذف جميع الملفات من المجلد Assets/GoogleMobileAds/Mediation/Maio.

في محرِّر مشروع 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 على الهواتف والأجهزة اللوحية المسجّلة على أنّها أجهزة اختبارية عند تقديم الطلبات.

ملاحظة مهمة: يجب إيقاف وضع الاختبار في AdMob و 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.
• متوافق مع إصدار 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.
• يتوافق مع محوِّل maio iOS الإصدار 2.1.3.0.
• تم إنشاؤه واختباره باستخدام الإصدار 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.
• يتوافق مع محوِّل 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.