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

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

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

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

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

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

المتطلبات

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

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

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

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

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

Android

iOS

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

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

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

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

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

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 مثبَّتًا، يمكنك تثبيت "إضافة التوسّط بين شبكتَي i-mobile وGoogle Mobile Ads" في 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: اختبار عملية التنفيذ

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

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

ملاحظة مهمة: عليك إيقاف وضع الاختبار في "مدير إعلانات Google" و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 Unity Mediation Plugin الإضافي

الإصدار 1.3.7

• يتوافق مع الإصدار 2.3.2.1 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.3.4.2 من محوّل i-mobile iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 10.0.0 من إضافة Google Mobile Ads 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.

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

الإصدار 1.3.1

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

الإصدار 1.3.0

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

الإصدار 1.2.2

• يتوافق مع الإصدار 2.0.23.1 من محوّل i-mobile Android.
• يتوافق مع الإصدار 2.2.0.1 من محوّل i-mobile iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 7.0.2 من إضافة Google Mobile Ads 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".

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