دمج i-mobile مع التوسّط

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

تستخدم واجهة لوحة البيانات في i-mobile نصًا يابانيًا للتصنيفات والأزرار والأوصاف. لم تتم ترجمة لقطات الشاشة في هذا الدليل. في المقابل، يتم في أوصاف هذا الدليل وتعليماته ترجمة التصنيفات والأزرار مع ما يعادلها باللغة الإنجليزية بين قوسين.

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

يوفّر محوّل التوسّط في "مدير إعلانات Google" لخدمة i-mobile الإمكانات التالية:

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

قبل المتابعة، يُرجى التحقّق مما يلي:

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

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

اشترِك أو سجِّل الدخول إلى حسابك على i-mobile.

أضِف تطبيقك إلى لوحة بيانات i-mobile بالنقر على علامة التبويب サイト／アプリ管理 (إدارة الموقع الإلكتروني/التطبيق) والزر الخاص بنظام تشغيل تطبيقك.

املأ النموذج وانقر على الزر 新規登録 (اشتراك).

لإنشاء موضع إعلاني جديد، اختَر تطبيقك ضمن علامة التبويب サイト／アプリ管理 (إدارة المواقع الإلكترونية/التطبيقات).

انتقِلوا إلى علامة التبويب 広告スポット管理 (إدارة المساحات الإعلانية) وانقروا على الزر 新規広告スポット (مساحة إعلانية جديدة).

بعد ذلك، املأ النموذج من خلال تقديم 広告スポット名 (اسم موضع الإعلان) و広告スポットサイズ (حجم موضع الإعلان) وتفاصيل أخرى. بعد ذلك، انقر على الزرّ 新規登録 (اشتراك).

أصبح الموضع الإعلاني الجديد جاهزًا. لعرض تفاصيل الدمج، انقر على الزر アプリ設定取得 (الحصول على إعدادات التطبيق).

دوِّن パブリッシャーID (الرقم التعريفي للناشر) وメディアID (معرّف الوسائط) وスポットID (معرّف الموضع). ستحتاج إلى هذه المَعلمات لاحقًا عند ضبط i-mobile للتوسّط في واجهة مستخدم "مدير إعلانات Google".

تعديل ملف app-ads.txt

مبادرة البائعون المعتمَدون للتطبيقات (app-ads.txt) هي مبادرة من المختبَر التقني لمكتب الإعلانات التفاعلية (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقك إلا من خلال القنوات التي حدَّدت أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم تكن قد فعلت ذلك، أنشئ ملف app-ads.txt في "إدارة إعلانات Google".

لتنفيذ app-ads.txt لـ i-mobile، يُرجى الاطّلاع على الأسئلة الشائعة.

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

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

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

الدمج من خلال pub.dev

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

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

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

dependencies:
  gma_mediation_imobile: ^1.0.6

الدمج اليدوي

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

dependencies:
  gma_mediation_imobile:
    path: path/to/local/package

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

الخطوة 5: اختبار عملية التنفيذ

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

تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات". توفّر i-mobile رقم تعريف المكان ورقم تعريف الوسائط ورقم تعريف الناشر لأغراض الاختبار، ويمكنك العثور عليها هنا.

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

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

رموز الخطأ

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

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

سجلّ التغييرات في محوّل التوسّط في Flutter من i-mobile

الإصدار 1.0.6

• يتوافق مع الإصدار 2.3.2.5 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.3.4.8 من محوّل i-mobile iOS.
• تم إنشاء هذا الدليل واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.5

• تم تعديل هذا الإصدار ليتوافق مع الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• إضافة إمكانية استخدام Swift Package Manager
• يتوافق مع الإصدار 2.3.2.4 من محوِّل i-mobile Android.
• يتوافق مع الإصدار 2.3.4.8 من محوّل i-mobile iOS.
• تم إنشاء هذا الدليل واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.4

• يتوافق مع الإصدار 2.3.2.3 من محوِّل i-mobile Android.
• يتوافق مع الإصدار 2.3.4.7 من محوّل i-mobile iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.3

• تم تعديل الحدّ الأدنى لإصدار Flutter إلى 3.38.1
• تم تعديل هذا الإصدار ليتوافق مع الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
• يتوافق مع الإصدار 2.3.2.3 من محوِّل i-mobile Android.
• يتوافق مع الإصدار 2.3.4.6 من محوّل i-mobile iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 8.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.