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

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

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

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

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

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

المتطلبات

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

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

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

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

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

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

إعلان بيني

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

مقابل مكافأة

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

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

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

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

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

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

عليك إضافة maio إلى إعدادات التوسّط الخاصة بوحدتك الإعلانية.

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

لإنشاء مجموعة توسّط جديدة، انقر على إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصة، ثم انقر على متابعة.

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

اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية الحالية على AdMob. بعد ذلك، انقر على تم.

من المفترض أن تظهر الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:

إضافة maio كمصدر إعلان


ضمن بطاقة العرض بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان.

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



إذا كان لديك عملية ربط في maio، يمكنك اختيارها. بخلاف ذلك، انقر على إضافة عملية ربط.

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


الخطوة 3: استيراد حزمة تطوير البرامج والمحوّل الخاصَّين بمنصة 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:24.5.0")
    implementation("com.google.ads.mediation:maio:2.0.5.0")
}

الدمج اليدوي

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

لا يلزم توفير رمز إضافي لدمج Maio على Android.

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

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

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

سيتلقّى الناشرون الذين يستخدمون الإصدار 11.6.0 أو إصدارًا أحدث من حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" تلقائيًا إعلانات اختبارية من 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`.

سجلّ تغييرات "محوّل وسيط" في Android الخاص بمنصة 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

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

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

  • تم إصلاح مشكلة كانت تؤدي إلى حدوث أخطاء NullPointerException عند تعذُّر تحميل الإعلانات.

الإصدار 1.0.7.0

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

الإصدار 1.0.6.0

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