دمج شبكة 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
    • أن يكون الإصدار المستهدَف لنشر iOS هو 15.0 أو إصدار أحدث
  • مشروع 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: استيراد حزمة تطوير البرامج (SDK) والمحوِّل من maio

    OpenUPM-CLI

    إذا كان لديك OpenUPM-CLI مثبّتًا، يمكنك تثبيت المكوّن الإضافي لتوسّط maio في "إعلانات Google على الأجهزة الجوّالة" لـ 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 > فرض الحلّ. ستعمل مكتبة "مدير التبعية الخارجية" على حلّ التبعية من البداية ونسخ التبعيات المُعلَن عنها إلى دليل 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.