يوضّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل تحميل الإعلانات وعرضها من maio باستخدام التوسّط، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة maio إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل maio في تطبيق Flutter.
تستخدم واجهة لوحة البيانات في maio نصًا يابانيًا للتصنيفات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة في هذا الدليل. في المقابل، يتم في الأوصاف والتعليمات هنا الإشارة إلى التصنيفات والأزرار باستخدام ما يعادلها باللغة الإنجليزية. "URL スキーム," على سبيل المثال، يعني "مخطّط URL".
عمليات الدمج وأشكال الإعلانات المتوافقة
يتضمّن محوّل التوسّط الخاص بمنصة maio الميزات التالية:
| التكامل | |
|---|---|
| عروض الأسعار | |
| عرض إعلاني بدون انقطاع | |
| التنسيقات | |
| بانر | |
| الإعلانات البينية | |
| تم منح المكافأة | |
| مدمج مع المحتوى | |
المتطلبات
- أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 3.7.0 من Flutter أو إصدار أحدث
- للنشر على Android
- المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
- للنشر على أجهزة iOS
- الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث
- مشروع Flutter يعمل وتم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لمزيد من التفاصيل، يُرجى الاطّلاع على البدء.
- أكمِل دليل البدء الخاص بالتوسّط
الخطوة 1: ضبط الإعدادات في واجهة مستخدم maio
أولاً، عليك الاشتراك أو تسجيل الدخول إلى حسابك على maio. انقر على زر إدارة التطبيقات في الشريط الجانبي الأيمن، ثم انقر على تطبيق جديد.
اختَر علامة التبويب التي تتوافق مع نوع الإعلان المفضّل لديك.
إعلان بيني
أدخِل اسم تطبيقك، واختَر النظام الأساسي وقدِّم عنوان URL للتطبيق. اختَر إعلان فيديو بيني كـ نوع الإعلان، ثمّ انقر على تعديل.
Android
iOS
مقابل مكافأة
أدخِل اسم تطبيقك، واختَر النظام الأساسي وقدِّم عنوان URL للتطبيق. اختَر مقابل مكافأة كـ نوع الإعلان، ثمّ انقر على تعديل.
Android
iOS
في صفحة إدارة التطبيقات، سجِّل معرّف الوسائط. ويجب توفُّرها لإعداد وحدتك الإعلانية في AdMob في القسم التالي.
Android
iOS
في صفحة إدارة المنطقة، دوِّن رقم تعريف المنطقة. سيكون هذا المعرّف مطلوبًا أيضًا لإعداد الوحدة الإعلانية في AdMob في القسم التالي.
Android
iOS
الخطوة 2: إعداد طلب maio في واجهة مستخدم AdMob
ضبط إعدادات التوسّط للوحدة الإعلانية
Android
للحصول على التعليمات، راجِع الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج والمحوّل الخاصَّين بمنصة maio
الدمج من خلال pub.dev
أضِف الاعتمادية التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) والمحوّل من maio في ملف pubspec.yaml الخاص بالحزمة:
dependencies:
gma_mediation_maio: ^
الدمج اليدوي
نزِّل أحدث إصدار من مكوّن التوسّط الإضافي لخدمة "إعلانات Google على الأجهزة الجوّالة" في maio، واستخرِج الملف الذي تم تنزيله، ثم أضِف مجلد المكوّن الإضافي المستخرَج (ومحتوياته) إلى مشروع Flutter. بعد ذلك، أشِر إلى المكوّن الإضافي في ملف pubspec.yaml من خلال إضافة التبعية التالية:
dependencies:
gma_mediation_maio:
path: path/to/local/package
الخطوة 4: إضافة الرمز المطلوب
Android
لا يلزم استخدام رمز إضافي لدمج Maio.
iOS
تكامل SKAdNetwork
اتّبِع مستندات maio
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob.
سيتلقّى الناشرون الذين يستخدمون الإصدار 7.26.0 أو إصدارًا أحدث من "SDK لإعلانات Google على الأجهزة الجوّالة" تلقائيًا إعلانات اختبارية من 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 | تم تحميل إعلان مسبقًا لإعدادات الشبكة هذه. |
سجلّ التغييرات في "مهيّئ التوسّط" في Flutter لمنصة maio
الإصدار 1.0.3
- يتوافق مع الإصدار 2.0.5.0 من محوّل Android الخاص بمنصة maio.
- يتوافق مع الإصدار 2.1.6.1 من برنامج maio iOS الإضافي.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من "إضافة Flutter لإعلانات Google على الأجهزة الجوّالة".
الإصدار 1.0.2
- يتوافق مع الإصدار 2.0.4.0 من محوّل Android الخاص بمنصة maio.
- يتوافق مع الإصدار 2.1.6.1 من برنامج maio iOS الإضافي.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من "إضافة Flutter لإعلانات Google على الأجهزة الجوّالة".
الإصدار 1.0.1
- يتوافق مع الإصدار 2.0.3.1 من محوّل Android الخاص بمنصة maio.
- يتوافق مع الإصدار 2.1.6.1 من برنامج maio iOS الإضافي.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من "إضافة Flutter لإعلانات Google على الأجهزة الجوّالة".
الإصدار 1.0.0
- الإصدار الأوّلي.
- يتوافق مع الإصدار 2.0.3.0 من محوّل Android الخاص بمنصة maio.
- يتوافق مع الإصدار 2.1.6.0 من محوّل maio iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.3.1 من Google Mobile Ads Flutter Plugin.