يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من i-mobile باستخدام التوسّط، التي تغطي عمليات دمج الشلال. ويتناول هذا الدليل كيفية إضافة i-mobile إلى إعدادات التوسّط لوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوِّل i-mobile في تطبيق Unity.
تستخدم واجهة لوحة التحكم لـ i-mobile النص الياباني في تصنيفاته، والأزرار والأوصاف. لم تتم ترجمة لقطات الشاشة الواردة في هذا الدليل. في أوصاف هذا الدليل وتعليماته، يتمّ ترجمة التصنيفات والأزرار مع إدراج نظائرها باللغة الإنجليزية بين قوسين.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمّن Ad Manager محوّل التوسّط الخاص بـ i-mobile الإمكانات التالية:
| الدمج | |
|---|---|
| عروض الأسعار | |
| شلال | |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| تم منح المكافأة | |
المتطلبات
- Unity 5.6 أو إصدار أحدث
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Unity قيد التشغيل تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". اطّلِع على البدء لمعرفة التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم i-mobile
الخطوة 2: إعداد الطلب على i-mobile في واجهة مستخدم Ad Manager
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد المحوّل وحزمة تطوير البرامج (SDK) لـ i-mobile
OpenUPM-CLI
إذا كان لديك OpenUPM-CLI يمكنك تثبيت إعلانات Google على الأجهزة الجوّالة i-mobile المكوّن الإضافي للتوسّط for Unity إلى مشروعك من خلال تشغيل الأمر التالي من الدليل الجذري لمشروعك:
openupm add com.google.ads.mobile.mediation.imobile
OpenUPM
في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > مدير الحِزم لفتح إعدادات مدير حِزم Unity.
ضمن علامة التبويب السجلات المندرجة ضمن النطاق، أضِف OpenUPM كسجلّ نطاق محدَّد باستخدام التفاصيل التالية:
- الاسم:
OpenUPM - عنوان URL:
https://package.openupm.com - النطاقات:
com.google
بعد ذلك، انتقل إلى Window > مدير الحزم لفتح Unity Package Manager اختَر سجلاتي من القائمة المنسدلة.
حدد حزمة وساطة إعلانات Google للجوال i-mobile انقر على تثبيت.
حزمة الانسجام
نزِّل أحدث إصدار من المكوّن الإضافي لدمج "إعلانات Google على الأجهزة الجوّالة" لنظام i-mobile من رابط التنزيل في سجلّ التغييرات واستخرِج GoogleMobileAdsIMobileMediation.unitypackage من ملف zip.
في محرِّر مشروعات Unity، اختَر مواد العرض >. استيراد حزمة >
الحزمة المخصّصة واعثر على
GoogleMobileAdsIMobileMediation.unitypackage
الملف الذي قمت بتنزيله. تأكد من تحديد كل الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض >. محلل خدمات Play >
أداة تحليل Android > فرض الحل: أداة حلّ خدمات Unity Play
دقة التبعية من البداية ونسخ
التي تم الإعلان عنها ضمن دليل Assets/Plugins/Android في
Unity.
الخطوة 4: إدخال رمز إضافي
Android
ولا يلزم إدخال رمز إضافي مع i-mobile.
iOS
دمج SKAdNetwork
اتّباع مستندات i-mobile
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل Ad Manager. يوفّر تطبيق i-mobile بيانات اختبار Spot ID وMedia ID والرقم التعريفي للناشر للاختبار، يمكنك العثور عليها هنا.
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من i-mobile، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام i-mobile (Waterfall) مصادر الإعلانات.
رموز الخطأ
إذا تعذّر على المُحوِّل تلقّي إعلان من 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 | حدث خطأ في حزمة i-mobile SDK. الاطّلاع على الرمز لمزيد من التفاصيل. |
| 101 | يتطلب i-mobile سياق Activity لتحميل الإعلانات. |
| 102 | عدم توفّر/عدم صلاحية مَعلمات خادم i-mobile التي تم ضبطها في واجهة مستخدم Ad Manager |
| 103 | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع i-mobile. |
| 104 | عرض معاودة الاتصال بنجاح في تحميل الإعلانات المدمجة مع المحتوى لـ i-mobile قائمة فارغة للإعلانات المدمجة مع المحتوى. |
iOS
| رمز الخطأ | السبب |
|---|---|
| 0-10 | حدث خطأ في حزمة i-mobile SDK. راجِع الرمز لمزيد من التفاصيل. |
| 101 | عدم توفّر/عدم صلاحية مَعلمات خادم i-mobile التي تم ضبطها في واجهة مستخدم Ad Manager |
| 102 | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع i-mobile. |
| 103 | تعذّر على i-mobile عرض إعلان. |
| 104 | عرض i-mobile مصفوفة إعلان مدمج مع المحتوى فارغة. |
| 105 | تعذّر على i-mobile تنزيل مواد عرض الإعلانات المدمجة مع المحتوى. |
| 106 | لا تتيح i-mobile طلب إعلانات بينية متعددة باستخدام رقم تعريف الإعلان نفسه. |
سجلّ التغييرات في مكوّن i-mobile Unity Mediation الإضافي
الإصدار 1.3.5
- يتوافق مع الإصدار 2.3.2.0 من محوّل Android للأجهزة الجوّالة.
- يتوافق مع الإصدار 2.3.4.0 من محوّل iOS من i-mobile.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.3.4
- متوافق مع إصدار 2.3.1.2 من محوِّل i-mobile Android.
- يتوافق مع الإصدار 2.3.4.0 من محوّل iOS من i-mobile.
- تم إنشاء هذا المكوِّن واختباره باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.3.3
- يتوافق مع الإصدار 2.3.1.1 من محوّل Android للأجهزة الجوّالة.
- يتوافق مع الإصدار 2.3.3.0 من محوّل iOS من i-mobile.
- تم إنشاء هذا المكوِّن واختباره باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.3.2
- تم نقل محتوى المحوّل إلى
GoogleMobileAds/Mediation/IMobile/. - يتوافق مع الإصدار 2.3.1.1 من محوّل Android للأجهزة الجوّالة.
- يتوافق مع الإصدار 2.3.2.0 من محوّل iOS من i-mobile.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.3.1
- يتوافق مع الإصدار 2.3.0.0 من محوّل Android للأجهزة الجوّالة.
- يتوافق مع الإصدار 2.3.0.1 من محوّل iOS من i-mobile.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.4.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.3.0
- متوافق مع الإصدار 2.3.0.0 من محوِّل i-mobile Android.
- يتوافق مع الإصدار 2.3.0.0 من محوّل iOS من i-mobile.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.3.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.2.2
- متوافق مع محوِّل i-mobile Android 2.0.23.1.
- يتوافق مع الإصدار 2.2.0.1 من محوّل iOS من i-mobile.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.2 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.2.1
- يتوافق مع الإصدار 2.0.23.0 من محوّل Android للأجهزة الجوّالة.
- يتوافق مع الإصدار 2.2.0.1 من محوّل iOS من i-mobile.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.2.0
- يتوافق مع الإصدار 2.0.23.0 من محوِّل i-mobile Android.
- يتوافق مع الإصدار 2.2.0.0 من محوّل iOS من i-mobile.
الإصدار 1.1.0
- يتوافق مع الإصدار 2.0.22.2 من محوّل i-mobile Android.
- يتوافق مع الإصدار 2.1.0.1 من محوّل iOS من i-mobile.
الإصدار 1.0.2
- يتوافق مع الإصدار 2.0.22.0 من محوّل Android للأجهزة الجوّالة.
- يتوافق مع الإصدار 2.0.32.0 من محوّل iOS من i-mobile.
الإصدار 1.0.1
- متوافق مع محوِّل i-mobile Android 2.0.21.0
- يتوافق مع الإصدار 2.0.31.0 من محوّل iOS من i-mobile.
الإصدار 1.0.0
- الإصدار الأول!
- يتوافق مع الإصدار 2.0.20.1 من محوّل Android للأجهزة الجوّالة.
- يتوافق مع الإصدار 2.0.29.0 من محوّل iOS من i-mobile.