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

يوضِّح لك هذا الدليل كيفية استخدام "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

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

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

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

Android

iOS

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

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

Android

iOS

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

Android

iOS

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

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

الخطوة 2: إعداد الطلب في شبكة maio في AdMob واجهة المستخدم

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

Android

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

iOS

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

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) في maio والمحوّل

ملاحظة: قد يؤدي عدم دمج إصدارَي "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" المتوافقَين مع إصدار 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: اختبار عملية التنفيذ

تفعيل الإعلانات التجريبية

احرص على تسجيل جهاز الاختبار من أجل AdMob.

بالنسبة إلى الناشرين الذين يستخدمون الإصدار 7.26.0 أو الإصدارات الأحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة، سيتلقّى الناشرون إعلانات اختبارية من شبكة maio على الهواتف والأجهزة اللوحية المسجّلة كـ أجهزة اختبارية عند تقديم طلباتهم.

ملاحظة مهمة: يجب إيقاف وضع الاختبار لـ AdMob و 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.