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

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

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

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

تتوفر للمحوِّل التوسّط في maio الإمكانات التالية:

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

المتطلبات

  • المستوى 21 أو إصدار أحدث من واجهة برمجة التطبيقات لنظام التشغيل Android
  • ‫mai SDK 1.0.7 أو إصدار أحدث

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

  • إكمال التوسّط دليل البدء

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

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

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

إعلان بيني

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

تم منح المكافأة

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

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

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

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

الخطوة 2: إعداد طلب مايو في Ad Manager واجهة المستخدِم

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

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

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

بعد ذلك، أضِف في ملف build.gradle.kts على مستوى التطبيق الإعدادات وتبعيات التنفيذ التالية. استخدِم أحدث إصدارات من حزمة SDK ومحوِّل maio:

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

الدمج اليدوي

  • يمكنك تنزيل أحدث إصدار من maio Android SDK وإضافته إلى مشروعك.
  • انتقِل إلى عناصر محوّلات Maio في مستودع Maven من Google. اختَر أحدث إصدار، ثم نزِّل ملف ‎.aar الخاص بمحوِّل maio وأضِفه إلى مشروعك.

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

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

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

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

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

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

إثبات صحة الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من 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. اطّلِع على الرمز البرمجي ومستندات مايو لمزيد من التفاصيل.
101 لا يتوفّر إعلان لـ "مايو".
102 مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف موضع الإعلان).
103 لم يكن السياق المستخدَم لتحميل إعلان مثيلًا لـ "نشاط".

سجلّ التغييرات في محوِّل التوسّط في إعلانات Android من 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

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

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

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

الإصدار 1.1.15.0

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

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

  • الإصدار 20.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 1.1.15 من حزمة تطوير البرامج 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

  • للحدّ من حالات انتهاء مهلة الانتظار، ستتعذّر الآن طلبات الإعلانات على الفور إذا لم يكن لدى Maia إعلان جاهز للعرض.
  • تم تعديل الحد الأدنى المطلوب لإصدار حزمة "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

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

الإصدار 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

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