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

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

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

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

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

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

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

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

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

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

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

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

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

إعلان بيني

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

مقابل مكافأة

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

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

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

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

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

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

سجِّل الدخول إلى حسابك على "مدير إعلانات Google".

انتقِل إلى التسليم > مجموعة الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة شبكات إعلانية مدِرّة للأرباح جديدة.

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

بعد ذلك، انقر على الزر إضافة شريك إعلاني مدِّر للأرباح.

إذا كان لديك شريك إعلاني مدِّر للأرباح في maio، يمكنك اختياره. بخلاف ذلك، اختَر إنشاء شريك جديد إعلاني مدِّر للأرباح.

اختَر maio كـ شبكة إعلانية، وأدخِل اسمًا فريدًا وفعِّل التوسّط.

فعِّل جمع البيانات تلقائيًا، وأدخِل معرّف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات الذي حصلت عليهما في القسم السابق.

بعد اختيار شريك إعلاني مدِّر للأرباح، اختَر التوسّط في حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وAndroid كـ النظام الأساسي، ونشط كـ الحالة. أدخِل معرّف الوسائط ومعرّف المنطقة الذي حصلت عليهما في القسم السابق. بعد ذلك، أدخِل قيمة تكلفة تلقائية لكل ألف ظهور.

انقر على حفظ في أسفل الصفحة عند الانتهاء.

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

في ملف settings.gradle.kts على مستوى المشروع، أضِف المستودعات التالية:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

في ملف gradle على مستوى التطبيق، أضِف تبعيات التنفيذ التالية:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:maio:2.0.9.1")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:maio:2.0.9.1'
}

الدمج اليدوي

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

لا يلزم استخدام رمز إضافي لدمج maio مع Android.

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

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

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

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

التحقّق من الإعلانات الاختبارية

للتأكّد من تلقّي إعلانات اختبارية من maio، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات maio (العرض بدون انقطاع).

رموز الخطأ

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

التنسيق اسم الصف
إعلان بيني jp.maio.sdk.android.mediation.admob.adapter.Interstitial
تمت المكافأة jp.maio.sdk.android.mediation.admob.adapter.Rewarded

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل Maio عند تعذُّر تحميل إعلان:

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

سجلّ التغييرات في محوّل التوسّط الخاص بـ maio على Android

الإصدار 2.0.9.1

  • ثبِّت تبعية Kotlin للمحوّل على الإصدار 1.9.0 (الحد الأدنى لإصدار Kotlin المتوافق مع الجيل التالي من حزمة SDK لإعلانات Google على الأجهزة الجوّالة).
  • تم إصلاح سلوك التجاوز في فروع الفشل المحظورة على فئات عمرية معيّنة أثناء بدء الإعلان وطلبات تحميل الإعلانات.

تم التصميم والاختبار باستخدام:

  • الإصدار 25.4.0 من SDK لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 1.5.0 من الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.0.9.1 من حزمة تطوير البرامج (SDK) لـ Maio

الإصدار 2.0.9.0

  • فلترة الطلبات المحظورة على الفئات العمرية في حزمة تطوير البرامج (SDK) من maio عندما يتم ضبط قيمة AgeRestrictedTreatment الجديدة على CHILD
  • تم التحقّق من التوافق مع الإصدار 2.0.9 من حزمة تطوير البرامج (SDK) لمنصة maio.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 25.4.0 من SDK لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 1.3.1 من الجيل التالي من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.9.0 من حزمة تطوير البرامج (SDK) لـ Maio

الإصدار 2.0.8.2

  • فلترة الطلبات المحظورة على فئات عمرية معيّنة لحزمة تطوير البرامج (SDK) الخاصة بمنصة maio لأنّها لا يمكنها تلقّي الإشارات المحظورة على فئات عمرية معيّنة
  • تمت إضافة سمة لإنشاء المحوّل مع مصدر الاعتمادية الخاص بـ "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة".

تم إنشاؤه واختباره باستخدام:

  • الإصدار 25.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.0 من الجيل التالي من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.0.8.2 من حزمة تطوير البرامج (SDK) لمنصة Maio

الإصدار 2.0.8.1

  • تمت إضافة إمكانية استخدام شكل "إعلان البانر"

تم التصميم والاختبار باستخدام:

  • الإصدار 25.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.8.1 من حزمة تطوير البرامج (SDK) لمنصة Maio

الإصدار 2.0.8.0

  • تم التحقّق من التوافق مع الإصدار 2.0.8 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.

تم التصميم والاختبار باستخدام:

  • الإصدار 24.9.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.8.0 من حزمة تطوير البرامج (SDK) لمنصة Maio

الإصدار 2.0.7.0

  • تم التحقّق من التوافق مع الإصدار 2.0.7 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.

تم التصميم والاختبار باستخدام:

  • الإصدار 24.7.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.7.0 من حزمة تطوير البرامج (SDK) لشبكة Maio

الإصدار 2.0.6.0

  • تمت إزالة المراجع على مستوى الصف إلى Context. يمكن أن تساعد في تقليل مشاكل تسرُّب الذاكرة
  • تم التحقّق من التوافق مع الإصدار 2.0.6 من حزمة تطوير البرامج (SDK) لمنصة maio.

تم التصميم والاختبار باستخدام:

  • الإصدار 24.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.6.0 من حزمة تطوير البرامج (SDK) لـ Maio

الإصدار 2.0.5.0

  • تم التحقّق من التوافق مع الإصدار 2.0.5 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 24.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.5.0 من حزمة تطوير البرامج (SDK) لمنصة Maio

الإصدار 2.0.4.0

  • تم إثبات التوافق مع الإصدار 2.0.4 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 24.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.4.0 من حزمة تطوير البرامج (SDK) لمنصة Maio

الإصدار 2.0.3.1

  • تم تعديل الحد الأدنى المطلوب لمستوى واجهة برمجة تطبيقات Android إلى 23.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 24.0.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 24.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.3.0 من حزمة تطوير البرامج (SDK) لشبكة Maio

الإصدار 2.0.3.0

  • تم التأكّد من التوافق مع الإصدار 2.0.3.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.

تم التصميم والاختبار باستخدام:

  • الإصدار 23.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.3.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Maio

الإصدار 1.1.16.3

  • تم تعديل الحدّ الأدنى المطلوب لإصدار "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 23.0.0.
  • تم التحقّق من التوافق مع الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) لمنصة maio.

تم التصميم والاختبار باستخدام:

  • الإصدار 23.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Maio

الإصدار 1.1.16.2

  • تم تعديل المحوّل لاستخدام فئة VersionInfo الجديدة.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.0.0.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 22.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Maio

الإصدار 1.1.16.1

  • تم تحديث compileSdkVersion وtargetSdkVersion إلى الإصدار 31 من واجهة برمجة التطبيقات.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.0.0.
  • تم تعديل الحد الأدنى المطلوب لمستوى واجهة برمجة تطبيقات Android إلى 19.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 21.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) لمنصة Maio

الإصدار 1.1.16.0

  • تم تعديل رموز الخطأ لتسجيل أخطاء maio الإضافية.
  • تم التحقّق من التوافق مع الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.4.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 20.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) لـ Maio

الإصدار 1.1.15.0

  • تم التأكّد من التوافق مع الإصدار 1.1.15 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.0.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 20.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.15 من حزمة تطوير البرامج (SDK) لمنصة Maio

الإصدار 1.1.14.0

  • تمت إضافة رموز ورسائل خطأ موحّدة خاصة بالمحوّل.
  • تم التحقّق من التوافق مع الإصدار 1.1.14 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.8.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 19.8.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.14 من حزمة تطوير البرامج (SDK) لمنصة Maio

الإصدار 1.1.13.0

  • تم إثبات التوافق مع الإصدار 1.1.13 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.5.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 19.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.13 من حزمة تطوير البرامج (SDK) لمنصة Maio

الإصدار 1.1.12.0

  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.4.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 19.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.12 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Maio

الإصدار 1.1.11.1

  • للحدّ من حالات انتهاء المهلة، ستتعذّر طلبات الإعلانات على الفور إذا لم يكن لدى maio إعلان جاهز للعرض.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.1.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.11 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Maio

الإصدار 1.1.11.0

  • تم التحقّق من التوافق مع الإصدار 1.1.11 من حزمة تطوير البرامج (SDK) لمنصة maio.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.3.0.

تم التصميم والاختبار باستخدام:

  • الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.11 من حزمة تطوير البرامج (SDK) لشبكة Maio

الإصدار 1.1.10.0

  • تم التحقّق من التوافق مع الإصدار 1.1.10 من حزمة تطوير البرامج (SDK) لمنصة maio.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.2.0.

الإصدار 1.1.8.0

  • تمّ التحقّق من التوافق مع الإصدار 1.1.8 من حزمة تطوير البرامج (SDK) لمنصة maio.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.1.0.

الإصدار 1.1.7.0

  • إصلاح الأخطاء.
  • تم التحقّق من التوافق مع الإصدار 1.1.7 من حزمة تطوير البرامج (SDK) لمنصة maio.

الإصدار 1.1.6.1

  • تم تعديل المحوّل ليتوافق مع واجهة برمجة التطبيقات الجديدة للإعلانات مقابل مكافآت.
  • تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 17.2.0.

الإصدار 1.1.6.0

  • تم التحقّق من التوافق مع الإصدار 1.1.6 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.

الإصدار 1.1.5.0

  • تم التحقّق من التوافق مع الإصدار 1.1.5 من حزمة تطوير البرامج (SDK) لمنصة maio.

الإصدار 1.1.4.0

  • تم التحقّق من التوافق مع الإصدار 1.1.4 من حزمة تطوير البرامج (SDK) لمنصة maio.

الإصدار 1.1.3.1

  • تم تعديل المحوّل ليعمل مع فئة مثيل بدلاً من فئة singleton.

الإصدار 1.1.3.0

  • تم إثبات التوافق مع الإصدار 1.1.3 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.

الإصدار 1.1.2.1

  • تم تعديل المحوّل باستخدام دوال تهيئة معدَّلة.

الإصدار 1.1.2.0

  • تم التحقّق من التوافق مع الإصدار 1.1.2 من حزمة تطوير البرامج (SDK) لمنصة maio.

الإصدار 1.1.1.1

  • تم تعديل المحوِّل لاستدعاء حدث الإعلان onRewardedVideoComplete().

الإصدار 1.1.1.0

  • تم إثبات التوافق مع الإصدار 1.1.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.

الإصدار 1.1.0.0

  • تم التحقّق من التوافق مع الإصدار 1.1.0 من حزمة تطوير البرامج (SDK) لمنصة maio.

الإصدار 1.0.8.0

  • تمّ التحقّق من التوافق مع الإصدار 1.0.8 من حزمة تطوير البرامج (SDK) لمنصة maio.

الإصدار 1.0.7.1

  • تم إصلاح مشكلة قد تؤدي إلى حدوث NullPointerExceptions عند تعذُّر تحميل الإعلانات.

الإصدار 1.0.7.0

  • تمت إضافة إمكانية تفعيل وضع الاختبار من خلال إضافة رقم تعريف الجهاز الاختباري إلى AdRequest.
  • تم التحقّق من التوافق مع الإصدار 1.0.7 من حزمة تطوير البرامج (SDK) الخاصة بمنصة maio.

الإصدار 1.0.6.0

  • الإصدار الأول
  • تمت إضافة إمكانية عرض الإعلانات البينية وإعلانات الفيديو مقابل مكافأة.