يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads Flutter Plugin من أجل تحميل الإعلانات وعرضها من i-mobile باستخدام التوسّط، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة i-mobile إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل i-mobile في تطبيق Flutter.
تستخدم واجهة لوحة البيانات في i-mobile نصًا يابانيًا للتصنيفات والأزرار والأوصاف. لم تتم ترجمة لقطات الشاشة في هذا الدليل. في المقابل، يتم في أوصاف هذا الدليل وتعليماته ترجمة التصنيفات والأزرار باستخدام ما يعادلها باللغة الإنجليزية بين قوسَين.
عمليات الدمج وأشكال الإعلانات المتوافقة
يتمتّع محوّل التوسّط في "إدارة إعلانات Google" لـ i-mobile بالإمكانات التالية:
| التكامل | |
|---|---|
| عروض الأسعار | |
| عرض إعلاني بدون انقطاع | |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| مقابل مكافأة | |
| مدمج مع المحتوى | |
المتطلبات
- أحدث Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android:
- المستوى 23 من واجهة برمجة تطبيقات Android أو إصدار أحدث
- للنشر على iOS:
- هدف النشر على iOS هو الإصدار 13.0 أو إصدار أحدث
- مشروع Flutter يعمل بشكل سليم وتم ضبطه باستخدام Google Mobile Ads Flutter Plugin. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads Flutter Plugin.
- إعداد التوسّط.
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم i-mobile
اشترك أو سجّل الدخول إلى حسابك على i-mobile.
أضِف تطبيقك إلى لوحة بيانات i-mobile من خلال النقر على علامة التبويب サイト／アプリ管理 (إدارة المواقع الإلكترونية/التطبيقات) والزر الخاص بنظام تشغيل تطبيقك.
Android
iOS
املأ النموذج وانقر على الزر 新規登録 (اشتراك).
Android
iOS
لإنشاء موضع إعلاني جديد، اختَر تطبيقك ضمن علامة التبويب サイト／アプリ管理 (إدارة المواقع الإلكترونية/التطبيقات).
Android
iOS
انتقِل إلى علامة التبويب 広告スポット管理 (إدارة المواضع الإعلانية) وانقر على الزر 新規広告スポット (موضع إعلاني جديد).
بعد ذلك، املأ النموذج من خلال تقديم 広告スポット名 (اسم الموضع الإعلاني)، 広告スポットサイズ (حجم الموضع الإعلاني) وتفاصيل أخرى. بعد ذلك، انقر على الزر 新規登録 (اشتراك).
أصبح الموضع الإعلاني الجديد جاهزًا. للاطّلاع على تفاصيل عملية الدمج، انقر على الزر アプリ設定取得 (الحصول على إعدادات التطبيق).
دوِّن パブリッシャーID (رقم تعريف الناشر) وメディアID (معرّف الوسائط) وスポットID (رقم تعريف الموضع). ستحتاج إلى هذه المَعلمات لاحقًا عند ضبط i-mobile للتوسّط في واجهة مستخدم "إدارة إعلانات Google".
Android
iOS
تعديل ملف app-ads.txt
تشكّل مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt مبادرة "للمختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنها مخوّلة. للحيلولة دون حدوث خسارة كبيرة في أرباح الإعلانات، عليك تنفيذ ملف app-ads.txt.
إذا لم يسبق لك إجراء ذلك،
عليك إنشاء ملف app-ads.txt لـ "إدارة إعلانات Google".
لتنفيذ app-ads.txt لـ i-mobile، يُرجى الاطّلاع على
الأسئلة الشائعة.
الخطوة 2: إعداد طلب i-mobile في واجهة مستخدم "إدارة إعلانات Google"
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوّل i-mobile
التكامل من خلال pub.dev
أضِف التبعية التالية مع أحدث إصدارَين من حزمة تطوير البرامج (SDK) ومحوّل i-mobile في ملف pubspec.yaml لحزمتك:
dependencies:
gma_mediation_imobile: ^1.0.2
التكامل اليدوي
نزِّل أحدث إصدار من مكوّن التوسّط الإضافي لـ Google Mobile Ads من أجل
i-mobile،
واستخرِج الملف الذي تم تنزيله، وأضِف مجلد المكوّن الإضافي الذي تم استخراجه
(ومحتوياته) إلى مشروع Flutter. بعد ذلك، أشِر إلى المكوّن الإضافي في ملف pubspec.yaml من خلال إضافة التبعية التالية:
dependencies:
gma_mediation_imobile:
path: path/to/local/package
الخطوة 4: الرمز الإضافي المطلوب
Android
لا يلزم استخدام أي رمز إضافي لدمج i-mobile.
iOS
التكامل مع SKAdNetwork
اتّبِع مستندات i-mobile
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist لمشروعك.
الخطوة 5: اختبار عملية الإعداد
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات". توفّر i-mobile رقم تعريف الموضع ورقم تعريف الوسائط، ورقم تعريف الناشر للاختبار، ويمكنك العثور عليها هنا.
التحقّق من الإعلانات الاختبارية
للتحقّق من أنّك تتلقّى إعلانات اختبارية من i-mobile، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصدر (مصادر) الإعلانات i-mobile(بدون انقطاع).
رموز الخطأ
إذا تعذّر على المحوّل تلقّي إعلان من i-mobile، يمكن للناشرين التحقّق من الـ
خطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo
ضمن الفئات التالية:
Android
| التنسيق | اسم الصف |
|---|---|
| بانر | com.google.ads.mediation.imobile.IMobileAdapter |
| إعلان بيني | com.google.ads.mediation.imobile.IMobileAdapter |
| مدمج مع المحتوى | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
| التنسيق | اسم الصف |
|---|---|
| بانر | IMobileAdapter |
| إعلان بيني | IMobileAdapter |
| مدمج مع المحتوى | GADMediationAdapterIMobile |
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل i-mobile عندما يتعذّر تحميل إعلان:
Android
| رمز الخطأ | السبب |
|---|---|
| 0-99 | عرضت حزمة تطوير البرامج (SDK) لـ i-mobile خطأً. يُرجى الاطّلاع على الرمز لمزيد من التفاصيل. |
| 101 | تتطلب i-mobile سياق Activity لتحميل الإعلانات. |
| 102 | مَعلمات خادم i-mobile التي تم ضبطها في واجهة مستخدم "إدارة إعلانات Google" غير متوفّرة أو غير صالحة. |
| 103 | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع i-mobile. |
| 104 | عرضت معاودة الاتصال الناجحة لتحميل الإعلانات المدمجة مع المحتوى في i-mobile قائمة فارغة بالإعلانات المدمجة مع المحتوى. |
iOS
| رمز الخطأ | السبب |
|---|---|
| 0-10 | عرضت حزمة تطوير البرامج (SDK) لـ i-mobile خطأً. يُرجى الاطّلاع على الرمز لمزيد من التفاصيل. |
| 101 | مَعلمات خادم i-mobile التي تم ضبطها في واجهة مستخدم "إدارة إعلانات Google" غير متوفّرة أو غير صالحة. |
| 102 | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع i-mobile. |
| 103 | تعذّر على i-mobile عرض إعلان. |
| 104 | عرضت i-mobile مصفوفة فارغة للإعلانات المدمجة مع المحتوى. |
| 105 | تعذّر على i-mobile تنزيل مواد عرض الإعلانات المدمجة مع المحتوى. |
| 106 | لا تتيح i-mobile طلب إعلانات بينية متعدّدة باستخدام رقم تعريف الموضع نفسه. |
سجلّ التغييرات في محوّل التوسّط لـ i-mobile Flutter
الإصدار 1.0.4 (قيد التطوير)
الإصدار 1.0.3 (قيد التطوير)
- تم تعديل الحد الأدنى لإصدار Flutter إلى 3.35.1
- تم التعديل ليتوافق مع الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
الإصدار 1.0.2
- يتوافق مع الإصدار 2.3.2.1 من محوّل i-mobile لنظام التشغيل Android.
- يتوافق مع الإصدار 2.3.4.3 من محوّل i-mobile لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.0.1
- يتوافق مع الإصدار 2.3.2.1 من محوّل i-mobile لنظام التشغيل Android.
- يتوافق مع الإصدار 2.3.4.2 من محوّل i-mobile لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.0.0
- الإصدار الأوّلي.
- يتوافق مع الإصدار 2.3.2.0 من محوّل i-mobile لنظام التشغيل Android.
- يتوافق مع الإصدار 2.3.4.1 من محوّل i-mobile لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.