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

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

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

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

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

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

قبل المتابعة، تأكَّد مما يلي:

• أحدث إصدار من Google Mobile Ads Flutter Plugin
• الإصدار 3.7.0 أو إصدار أحدث من إطار عمل Flutter
• للنشر على Android
  • المستوى 24 من واجهة برمجة تطبيقات Android أو إصدار أحدث
• للنشر على iOS
  • هدف النشر على iOS 15.0 أو إصدار أحدث
• مشروع Flutter يعمل بشكل صحيح وتمت تهيئته باستخدام Google Mobile Ads Flutter Plugin لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads Flutter Plugin.

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

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

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

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

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

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

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

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

التكامل من خلال pub.dev

(Android فقط) أضِف المستودعات التالية إلى ملف build.gradle داخل دليل android في مشروعك:

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

أضِف التبعية التالية باستخدام أحدث إصدارات حزمة تطوير البرامج (SDK) ومحوّل maio في ملف pubspec.yaml لحزمتك:

dependencies:
  gma_mediation_maio: ^1.1.8

التكامل اليدوي

نزِّل أحدث إصدار من مكوّن التوسّط الإضافي من Google Mobile Ads لـ maio، واستخرِج الملف الذي تم تنزيله، وأضِف مجلد المكوّن الإضافي الذي تم استخراجه (ومحتوياته) إلى مشروع Flutter. بعد ذلك، أشِر إلى المكوّن الإضافي في ملف pubspec.yaml عن طريق إضافة التبعية التالية:

dependencies:
  gma_mediation_maio:
    path: path/to/local/package

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

الخطوة 5: اختبار عملية الإعداد

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

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

سيتلقّى الناشرون الذين يستخدمون الإصدار 7.26.0 أو إصدارًا أحدث من Google Mobile Ads Flutter Plugin إعلانات اختبارية تلقائيًا من maio على الهواتف والأجهزة اللوحية المسجّلة كـ أجهزة اختبارية عند تقديم الطلبات.

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

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

رموز الخطأ

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

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

سجلّ التغييرات في محوّل التوسّط من maio لـ Flutter

الإصدار 1.1.8

• يتوافق مع الإصدار 2.0.9.1 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.2.3.0 من محوّل maio لنظام التشغيل iOS .
• تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.1.7

• تم التحديث لدعم الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• تمت إضافة دعم Swift Package Manager.
• يتوافق مع الإص0}دار 2.0.9.0 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.2.2.0 من محوّل maio لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من مكوّن Google Mobile Ads Flutter الإضافي.

الإصدار 1.1.6

• يتوافق مع الإص0}دار 2.0.9.0 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.2.1.2 من محوّل maio لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من مكوّن Google Mobile Ads Flutter الإضافي.

الإصدار 1.1.5

• يتوافق مع الإصدار 2.0.8.2 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.2.1.2 من محوّل maio لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.1.4

• تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1.
• تم التحديث لدعم الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• يتوافق مع الإصدار 2.0.8.2 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.2.1.1 من محوّل maio لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.1.3

• يتوافق مع الإصدار 2.0.7.0 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.2.0.3 من محوّل maio لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.1.2

• تم تعديل الحد الأدنى لإصدار Flutter إلى 3.35.1
• تم تعديله ليتوافق مع الإصدار 7.0.0 من مكوّن Google Mobile Ads Flutter الإضافي
• يتوافق مع الإصدار 2.0.8.0 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.2.0.1 من محوّل maio لنظام التشغيل iOS.

الإصدار 1.1.1

• يتوافق مع الإصدار 2.0.7.0 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.2.0.1 من محوّل maio لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.1.0

• يتوافق مع الإصدار 2.0.6.0 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.2.0.0 من محوّل maio لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.3

• يتوافق مع الإصدار 2.0.5.0 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.1.6.1 من محوّل maio لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.2

• يتوافق مع الإصدار 2.0.4.0 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.1.6.1 من محوّل maio لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.1

• يتوافق مع الإص0}الإصدار 2.0.3.1 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.1.6.1 من محوّل maio لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.0

• الإصدار الأوّلي
• يتوافق مع الإص0}دار 2.0.3.0 من محوّل maio لنظام التشغيل Android.
• يتوافق مع الإصدار 2.1.6.0 من محوّل maio لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.