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

اختيار النظام الأساسي: Android iOS Unity Flutter

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

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

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

يتضمّن محوّل التوسّط في AdMob لشبكة i-mobile الإمكانات التالية:

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

المتطلبات

• أحدث إصدار من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity
• ‫Unity 5.6 أو إصدار أحدث
• للنشر على Android
  • المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
• للنشر على أجهزة iOS
  • الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث
• مشروع Unity يعمل تم إعداده باستخدام إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity لمزيد من التفاصيل، يُرجى الاطّلاع على البدء.
• إكمال دليل البدء الخاص بالتوسّط

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

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

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

Android

iOS

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

Android

iOS

ملاحظة: يجب أن توافق i-mobile على تسجيلك. بعد الموافقة على طلبك، يمكنك إنشاء مساحة إعلانية.

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

Android

iOS

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

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

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

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

Android

iOS

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

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

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

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

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

Android

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

iOS

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

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

ملاحظة: قد يؤدي عدم دمج إصدارات متوافقة من حزمة تطوير البرامج (SDK) لكلّ من i-mobile و"إعلانات Google على الأجهزة الجوّالة" إلى حدوث مشاكل في الإصدار.

OpenUPM-CLI

ملاحظة مهمة: إذا كنت تريد الانتقال من استخدام .unitypackage إلى استخدام OpenUPM-CLI، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم عن طريق حذف جميع الملفات من المجلد Assets/GoogleMobileAds/Mediation/IMobile.

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت Google Mobile Ads i-mobile Mediation Plugin for Unity على مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

ملاحظة مهمة: إذا كنت تريد الانتقال من استخدام .unitypackage إلى استخدام OpenUPM، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم عن طريق حذف جميع الملفات من المجلد Assets/GoogleMobileAds/Mediation/IMobile.

في أداة تعديل مشروع Unity، اختَر تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحزم (Package Manager) لفتح إعدادات "إدارة حزم Unity" (Unity Package Manager Settings).

ضمن علامة التبويب المستودعات ذات النطاق المحدود، أضِف OpenUPM كمستودع ذي نطاق محدود مع التفاصيل التالية:

• الاسم: OpenUPM
• عنوان URL: https://package.openupm.com
• النطاقات: com.google

بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager (إدارة حِزم Unity)، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.

اختَر حزمة Google Mobile Ads IMobile Mediation وانقر على تثبيت.

حزمة Unity

نزِّل أحدث إصدار من المكوّن الإضافي للتوسّط في "إعلانات Google للأجهزة الجوّالة" من أجل i-mobile من رابط التنزيل في سجلّ التغيير، واستخرِج GoogleMobileAdsIMobileMediation.unitypackage من ملف zip.

في أداة تعديل مشروع Unity، اختَر Assets > Import Package > Custom Package، وابحث عن ملف GoogleMobileAdsIMobileMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

بعد ذلك، اختَر مواد العرض (Assets) > أداة إدارة التبعيات الخارجية (External Dependency Manager) > أداة حلّ المشاكل في Android (Android Resolver) > فرض الحلّ (Force Resolve). ستنفّذ مكتبة External Dependency Manager عملية تحديد العناصر التابعة من البداية وستنسخ العناصر التابعة المحدّدة إلى الدليل Assets/Plugins/Android في تطبيق Unity.

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

Android

لا يلزم توفير أي رمز إضافي لدمج i-mobile.

iOS

تكامل SKAdNetwork

اتّبِع مستندات i-mobile لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

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

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

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

ملاحظة مهمة: عليك إيقاف وضع الاختبار في AdMob و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 التي تم ضبطها في واجهة مستخدم AdMob غير متوفّرة أو غير صالحة.
103	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع i-mobile.
104	أرجعت دالة الاستدعاء الناجحة لتحميل الإعلانات المدمجة في i-mobile قائمة فارغة بالإعلانات المدمجة.

iOS

رمز الخطأ	السبب
0-10	عرضت حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile خطأً. اطّلِع على الرمز لمزيد من التفاصيل.
101	مَعلمات خادم i-mobile التي تم ضبطها في واجهة مستخدم AdMob غير متوفّرة أو غير صالحة.
102	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع i-mobile.
103	تعذّر على i-mobile عرض إعلان.
104	أرجعت i-mobile مصفوفة فارغة من الإعلانات المدمجة مع المحتوى.
105	تعذّر على i-mobile تنزيل مواد عرض الإعلانات المدمجة.
106	لا يتيح i-mobile طلب عدّة إعلانات بينية باستخدام Spot ID نفسه.

سجلّ تغييرات مكوّن i-mobile Unity Mediation Plugin الإضافي

الإصدار 1.3.8 (قيد التطوير)

الإصدار 1.3.7

• يتوافق مع الإصدار 2.3.2.1 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.3.4.2 من محوّل i-mobile iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 10.0.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.

الإصدار 1.3.6

• يتوافق مع الإصدار 2.3.2.0 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.3.4.1 من محوّل i-mobile iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.3.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.3.5

• يتوافق مع الإصدار 2.3.2.0 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.3.4.0 من محوّل i-mobile iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.3.4

• يتوافق مع الإصدار 2.3.1.2 من محوّل Android الخاص بشبكة i-mobile.
• يتوافق مع الإصدار 2.3.4.0 من محوّل i-mobile iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.0.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.3.3

• يتوافق مع الإصدار 2.3.1.1 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.3.3.0 من محوّل i-mobile iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.0.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.3.2

• تم نقل محتوى المحوّل إلى GoogleMobileAds/Mediation/IMobile/.
• يتوافق مع الإصدار 2.3.1.1 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.3.2.0 من محوّل i-mobile iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 8.1.0 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.

الإصدار 1.3.1

• يتوافق مع الإصدار 2.3.0.0 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.3.0.1 من محوّل i-mobile iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.4.1 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.3.0

• يتوافق مع الإصدار 2.3.0.0 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.3.0.0 من محوّل i-mobile iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.3.1 من إضافة Google Mobile Ads Unity.

الإصدار 1.2.2

• يتوافق مع الإصدار 2.0.23.1 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.2.0.1 من محوّل i-mobile iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.0.2 من إضافة "إعلانات Google على الأجهزة الجوّالة" في Unity.

الإصدار 1.2.1

• يتوافق مع الإصدار 2.0.23.0 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.2.0.1 من محوّل i-mobile iOS.
• تم إنشاء هذا الإصدار واختباره باستخدام الإصدار 7.0.0 من إضافة Google Mobile Ads Unity Plugin.

الإصدار 1.2.0

• يتوافق مع الإصدار 2.0.23.0 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.2.0.0 من محوّل i-mobile iOS.

الإصدار 1.1.0

• يتوافق مع الإصدار 2.0.22.2 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.1.0.1 من محوّل i-mobile iOS.

الإصدار 1.0.2

• يتوافق مع الإصدار 2.0.22.0 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.0.32.0 من محوّل i-mobile iOS.

الإصدار 1.0.1

• يتوافق مع الإصدار 2.0.21.0 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.0.31.0 من محوّل i-mobile iOS.

الإصدار 1.0.0

• الإصدار الأول!
• يتوافق مع الإصدار 2.0.20.1 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.0.29.0 من محوّل i-mobile iOS.