دمج شبكة 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 (قيد التطوير)

الإصدار 1.1.3

الإصدار 1.1.2

الإصدار 1.1.1

الإصدار 1.1.0

الإصدار 1.0.3

الإصدار 1.0.2

الإصدار 1.0.1

الإصدار 1.0.0