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

اختيار النظام الأساسي: Android جديد Android iOS Unity Flutter

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

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

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

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

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

المتطلبات

  • أحدث Google Mobile Ads Flutter Plugin
  • ‫Flutter 3.7.0 أو إصدار أحدث
  • للنشر على Android
    • المستوى 23 من واجهة برمجة التطبيقات Android API أو إصدار أحدث
  • للنشر على iOS
    • هدف النشر على iOS 12.0 أو إصدار أحدث
  • مشروع Flutter يعمل وتم ضبطه باستخدام Google Mobile Ads Flutter Plugin. راجِع مقالة إعداد Google Mobile Ads Flutter 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

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

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

dependencies:
  gma_mediation_maio: ^1.1.3

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

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

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

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

Android

لا يلزم إضافة أي رمز إضافي لعملية التكامل مع maio.

iOS

التكامل مع SKAdNetwork

اتّبِع مستندات maio لإضافة معرّفات SKAdNetwork إلى ملف Info.plist في مشروعك.

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

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

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

سيتلقّى الناشرون الذين يستخدمون الإصدار 7.26.0 أو إصدارًا أحدث من Google Mobile Ads Flutter 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 لـ Flutter

الإصدار 1.1.4 (قيد التطوير)

  • تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1
  • تم التحديث لدعم الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads

الإصدار 1.1.3

الإصدار 1.1.2

الإصدار 1.1.1

الإصدار 1.1.0

الإصدار 1.0.3

الإصدار 1.0.2

الإصدار 1.0.1

الإصدار 1.0.0