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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (الإصدار القديم)

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

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

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

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

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

المتطلبات الأساسية

قبل المتابعة، يُرجى التأكّد مما يلي:

  • أحدث إصدار من Google Mobile Ads Unity Plugin
  • الإصدار 4 أو إصدار أحدث من Unity Editor
  • للنشر على أجهزة Android
    • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
  • للنشر على iOS
    • الإصدار 15.0 أو إصدار أحدث من نظام التشغيل iOS
  • مشروع Unity قيد العمل تم إعداده باستخدام Google Mobile Ads Unity Plugin لمعرفة التفاصيل، يُرجى الاطّلاع على إعداد Google Mobile Ads Unity Plugin.
  • إعداد التوسّط

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

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

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

    إعلان بيني

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

    Android

    iOS

    مقابل مكافأة

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

    Android

    iOS

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

    Android

    iOS

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

    Android

    iOS

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

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

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

    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، اختَر تعديل > إعدادات المشروع > أداة إدارة الحِزم لفتح إعدادات أداة إدارة حِزم Unity.

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

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

    تفاصيل‫ OpenUPM

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

    Unityمستودعات ‫

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

    التثبيت من‫ OpenUPM

    حزمة Unity

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

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

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

    بعد ذلك، اختَر مواد العرض > مدير التبعية الخارجية > أداة حلّ مشاكل Android > فرض الحلّ. ستعمل مكتبة External Dependency Manager على حلّ التبعيات من البداية ونسخ التبعيات المُعلَن عنها إلى دليل Assets/Plugins/Android في تطبيق Unity.

    فرض الحلّ

    الخطوة 4: إضافة الرمز المطلوب

    Android

    لا يلزم استخدام أي رمز إضافي لدمج Maio.

    iOS

    تكامل SKAdNetwork

    اتّبِع مستندات maio لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

    الخطوة 5: اختبار عملية التنفيذ

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

    تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات".

    سيتلقّى الناشرون الذين يستخدمون الإصدار 7.26.0 أو الإصدارات الأحدث من Google Mobile Ads Unity Plugin تلقائيًا إعلانات اختبارية من 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 تم تحميل إعلان مسبقًا لإعدادات الشبكة هذه.

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

    الإصدار 3.1.11

    الإصدار 3.1.10

    الإصدار 3.1.9

    الإصدار 3.1.8

    الإصدار 3.1.7

    الإصدار 3.1.6

    الإصدار 3.1.5

    الإصدار 3.1.4

    الإصدار 3.1.3

    الإصدار 3.1.2

    الإصدار 3.1.1

    الإصدار 3.1.0

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

    الإصدار 1.0.1

    • يتوافق مع الإصدار 1.0.7 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من maio.
    • يتوافق مع الإصدار 1.2.19 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio على أجهزة iOS.

    الإصدار 1.0.0

    • الإصدار الأول
    • يتوافق مع الإصدار 1.0.6 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من maio.
    • يتوافق مع الإصدار 1.2.18 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio على أجهزة iOS.