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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (الإصدار القديم)

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

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

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

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

التكامل
عروض الأسعار
عرض إعلاني بدون انقطاع
التنسيقات
بانر
إعلان بيني
مقابل مكافأة
مدمج مع المحتوى

المتطلبات

  • أحدث محتوى من قناة Google Mobile Ads Flutter Plugin
  • الإصدار 3.7.0 من Flutter أو إصدار أحدث
  • للنشر على 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

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

create_ad_spot

بعد ذلك، املأ النموذج من خلال تقديم اسم موضع الإعلان (Ad Spot name) وحجم موضع الإعلان (Ad Spot size) وغير ذلك من التفاصيل. بعد ذلك، انقر على الزر 新規登録 (اشتراك).

new_ad_spot_form

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

ad_spot_list

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

Android

iOS

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

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

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

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

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

Android

للحصول على التعليمات، راجِع الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

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

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

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

dependencies:
  gma_mediation_imobile: ^1.0.4

الدمج اليدوي

نزِّل أحدث إصدار من مكوّن التوسّط الإضافي لـ 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 طلب إعلانات بينية متعدّدة باستخدام Spot ID نفسه.

سجلّ التغييرات في "محوّل التوسّط" الخاص بـ i-mobile على Flutter

الإصدار 1.0.4

الإصدار 1.0.3

  • تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1
  • تم تعديلها لتتوافق مع الإصدار 8.0.0 من مكوّن Google Mobile Ads الإضافي لـ Flutter

الإصدار 1.0.2

الإصدار 1.0.1

الإصدار 1.0.0