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

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

تستخدم واجهة لوحة البيانات في maio نصًا يابانيًا للتصنيفات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة في هذا الدليل. في المقابل، يتم في الأوصاف والتعليمات هنا الإشارة إلى التصنيفات والأزرار باستخدام ما يعادلها باللغة الإنجليزية. "URL スキーム," على سبيل المثال، يعني "مخطّط URL".

عمليات الدمج وأشكال الإعلانات المتوافقة

يتضمّن محوّل التوسّط الخاص بمنصة maio الميزات التالية:

التكامل
عروض الأسعار
عرض إعلاني بدون انقطاع
التنسيقات
بانر
الإعلانات البينية
تم منح المكافأة

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫Unity 4 أو الإصدارات الأحدث
  • للنشر على Android
    • المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
  • للنشر على أجهزة iOS
    • الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث
  • مشروع Unity يعمل وتم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لمزيد من التفاصيل، يُرجى الاطّلاع على البدء.
  • أكمِل دليل البدء الخاص بالتوسّط

الخطوة 1: ضبط الإعدادات في واجهة مستخدم maio

أولاً، عليك الاشتراك أو تسجيل الدخول إلى حسابك على maio. انقر على زر إدارة التطبيقات في الشريط الجانبي الأيمن، ثم انقر على تطبيق جديد.

اختَر علامة التبويب التي تتوافق مع نوع الإعلان المفضّل لديك.

إعلان بيني

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

Android

iOS

مقابل مكافأة

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

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

Android

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

iOS

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

الخطوة 3: استيراد حزمة تطوير البرامج والمحوّل الخاصَّين بمنصة maio

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت Google Mobile Ads maio Mediation Plugin for Unity في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

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

OpenUPM

في أداة تعديل مشروع Unity، اختَر تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحِزم (Package Manager) لفتح إعدادات إدارة حِزم Unity (Unity Package Manager Settings).

ضمن علامة التبويب المستودعات المسجّلة ذات النطاق المحدود، أضِف OpenUPM كمستودع مسجّل ذي نطاق محدود مع التفاصيل التالية:

  • الاسم: OpenUPM
  • عنوان URL: https://package.openupm.com
  • النطاقات: com.google

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.

Unity Registries

اختَر حزمة Google Mobile Ads Maio Mediation وانقر على تثبيت.

التثبيت من OpenUPM

حزمة Unity

نزِّل أحدث إصدار من المكوّن الإضافي للتوسّط في "إعلانات Google على الأجهزة الجوّالة" لمنصة maio من رابط التنزيل في سجلّ التغيير، واستخرِج GoogleMobileAdsMaioMediation.unitypackage من ملف zip.

في أداة تعديل مشروع Unity، اختَر Assets > Import Package > Custom Package، وابحث عن ملف GoogleMobileAdsMaioMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

الاستيراد من Unity

بعد ذلك، اختَر مواد العرض (Assets) > أداة إدارة التبعيات الخارجية (External Dependency Manager) > أداة حلّ المشاكل في Android (Android Resolver) > فرض الحلّ (Force Resolve). ستنفّذ مكتبة External Dependency Manager عملية تحديد العناصر التابعة من البداية، وستنسخ العناصر التابعة المحدّدة إلى الدليل 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). لمزيد من التفاصيل، يمكنك الاطّلاع على الرمز والمستندات الخاصة بـ maio.
101 لا يتوفّر إعلان على Maio.
102 مَعلمات الخادم غير صالحة (مثل رقم تعريف موضع الإعلان غير متوفّر).
103 لم يكن السياق المستخدَم لتحميل إعلان مثيلاً لـ `Activity`.

iOS

رمز الخطأ السبب
0-10 عرضت Maio خطأً خاصًا بحزمة تطوير البرامج (SDK). يمكنك الاطّلاع على رمز maio للحصول على مزيد من التفاصيل.
101 لا يتوفّر إعلان على maio بعد.
102 مَعلمات الخادم غير صالحة (مثل رقم تعريف موضع الإعلان غير متوفّر).
103 لا يتوافق برنامج Maio الإعلاني مع شكل الإعلان المطلوب.
104 تم تحميل إعلان مسبقًا لإعدادات الشبكة هذه.

سجلّ تغييرات إضافة Unity Mediation من maio

الإصدار 3.0.2

الإصدار 3.0.1

الإصدار 3.0.0

الإصدار 2.0.4

الإصدار 2.0.3

الإصدار 2.0.2

الإصدار 2.0.1

الإصدار 2.0.0

الإصدار 1.4.3

الإصدار 1.4.2

الإصدار 1.4.1

الإصدار 1.4.0

الإصدار 1.3.6

الإصدار 1.3.5

الإصدار 1.3.4

الإصدار 1.3.3

الإصدار 1.3.2

الإصدار 1.3.1

الإصدار 1.3.0

الإصدار 1.2.3

  • تم تعديل المكوّن الإضافي ليتوافق مع واجهة برمجة التطبيقات الجديدة "إعلانات مقابل مكافآت".
  • يتوافق مع الإصدار 1.1.7.0 من محوّل maio Android.
  • يتوافق مع الإصدار 1.4.6.0 من محوّل maio iOS.

الإصدار 1.2.2

  • يتوافق مع الإصدار 1.1.6.0 من محوّل maio Android.
  • يتوافق مع الإصدار 1.4.2.0 من أداة الربط maio iOS.

الإصدار 1.2.1

  • يتوافق مع الإصدار 1.1.6.0 من محوّل maio Android.
  • يتوافق مع الإصدار 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 من محوّل maio Android.
  • يتوافق مع الإصدار 1.3.2.0 من محوّل maio iOS.

الإصدار 1.1.2

  • يتوافق مع الإصدار 1.1.3.0 من محوّل maio Android.
  • يتوافق مع الإصدار 1.3.2.0 من محوّل maio iOS.

الإصدار 1.1.1

  • يتوافق مع الإصدار 1.1.1.0 من محوّل maio Android.
  • يتوافق مع الإصدار 1.3.1.1 من أداة الربط maio iOS.

الإصدار 1.1.0

  • يتوافق مع الإصدار 1.1.0.0 من أداة الربط الخاصة بمنصة maio على Android.
  • يتوافق مع الإصدار 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) لمنصة maio على نظام التشغيل iOS.