دمج 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
  • الإصدار 13.0 من نظام التشغيل iOS أو إصدار أحدث
• مشروع Flutter يعمل تم إعداده باستخدام Google Mobile Ads Flutter Plugin لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Flutter Plugin.
• إعداد التوسّط

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

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

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

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

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

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

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

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

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

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

مبادرة "البائعون المعتمَدون للتطبيقات" app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف 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 عندما يتعذّر تحميل إعلان:

سجلّ التغييرات في "محوّل التوسّط" الخاص بـ 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

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

الإصدار 1.0.1

• يتوافق مع محوّل i-mobile Android الإصدار 2.3.2.1.
• يتوافق مع الإصدار 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.