دمج شبكة 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، انقر على تعديل (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مستودعات ‫

    اختَر حزمة 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 من مهايئ 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) الخاصة بمنصة 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.