دمج 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
  • المستوى 24 من واجهة برمجة تطبيقات Android أو إصدار أحدث
• للنشر على 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 في واجهة مستخدم "إدارة إعلانات Google"

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

الخطوة 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: اختبار عملية الإعداد

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

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

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

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

رموز الخطأ

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

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

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

الإصدار 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.