يوضِّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات وعرضها من i-mobile باستخدام التوسّط، الذي يشمل عمليات دمج العرض الإعلاني بدون انقطاع. فهو يتناول كيفية إضافة i-mobile إلى إعدادات التوسط لوحدة إعلانية، وكيفية دمج i-mobile SDK والمحوّل في تطبيق Unity.
تستخدم واجهة لوحة المعلومات في i-mobile النص الياباني للتسميات والأزرار والأوصاف. لم تتم ترجمة لقطات الشاشة الواردة في هذا الدليل. في كل من الأوصاف والتعليمات الخاصة بهذا الدليل، تتم ترجمة التسميات والأزرار إلى معادِلاتها باللغة الإنجليزية بين قوسين.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتمتع AdMob محوّل التوسط في i-mobile بالإمكانيات التالية:
| الدمج | |
|---|---|
| عروض الأسعار | |
| شلال | |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| تم منح المكافأة | |
المتطلّبات
- Unity 5.6 أو إصدار أحدث
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Unity قيد التشغيل تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". راجِع البدء لمعرفة التفاصيل.
- أكمِل دليل البدء الخاص بالتوسّط.
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم i-mobile
سجّل الدخول أو سجّل الدخول إلى حسابك في i-mobile.
أضف تطبيقك إلى لوحة بيانات i-mobile عن طريق النقر على علامة التبويب サイポ/アプっ管っ (إدارة المواقع/التطبيقات) والزر الخاص بالنظام الأساسي لتطبيقك.
Android
iOS
املأ النموذج وانقُر على الزر أردت 規登録 (الاشتراك).
Android
iOS
لإنشاء موضع إعلاني جديد، اختَر تطبيقك ضمن علامة التبويب サイ明/アプっ管元 (إدارة المواقع الإلكترونية/التطبيقات).
Android
iOS
انتقِل إلى علامة التبويب 広告 Join ッ社管っ (إدارة مواضع الإعلانات)وانقر على علامة التبويب أردت規広告明ッ بالتحديد (موضع إعلان جديد).
بعد ذلك، املأ النموذج من خلال إدخال كلّ من 広告スポッ بالتحديد名 (اسم موضع الإعلان) و広告ห社ッ بالتحديدサイズ (حجم منطقة الإعلان) والتفاصيل الأخرى. بعد ذلك، انقر على الزر أردت(規登録) (الاشتراك).
مكان الإعلان الجديد جاهز. وللاطّلاع على تفاصيل عملية الدمج، انقر على الزر アプ設定取得 (الحصول على إعدادات التطبيق).
حاوِل استخدام ッッポーID (الرقم التعريفي للناشر) و名デっアID (معرّف الوسائط) و إيقافグッ بالتحديدID (رقم تعريف الموقع الجغرافي). ستحتاج إلى هذه المعلمات لاحقًا عند تهيئة i-mobile للتوسط في واجهة مستخدم AdMob .
Android
iOS
الخطوة 2: إعداد الطلب على i-mobile في واجهة مستخدم AdMob
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد المحوّل وحزمة تطوير البرامج (SDK) لـ i-mobile
نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة لهواتف i-mobile من رابط التنزيل في سجلّ التغييرات واستخرِج GoogleMobileAdsIMobileMediation.unitypackage من ملف ZIP.
في محرِّر مشروعات Unity، اختَر مواد العرض > استيراد حزمة > حِزمة مخصّصة وابحث عن ملف GoogleMobileAdsIMobileMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android > فرض الحل. ستنفِّذ مكتبة Unity Play Services محللاً تحليلاً للتبعية من البداية وتنسخ الملحقات المُعلَن عنها إلى
دليل Assets/Plugins/Android في تطبيق Unity.
الخطوة 4: إدخال رمز إضافي
Android
ولا يلزم إدخال رمز إضافي مع i-mobile.
iOS
دمج SKAdNetwork
اتّبِع مستندات i-mobile
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل AdMob. يوفّر تطبيق 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 التي تم ضبطها في واجهة المستخدم AdMob غير متوفّرة أو غير صالحة. |
| 103 | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع i-mobile. |
| 104 | عرض معاودة الاتصال بنجاح في تحميل الإعلانات المدمجة مع المحتوى لـ i-mobile قائمة فارغة للإعلانات المدمجة مع المحتوى. |
iOS
| رمز الخطأ | السبب |
|---|---|
| 0-10 | حدث خطأ في حزمة i-mobile SDK. راجِع الرمز لمزيد من التفاصيل. |
| 101 | مَعلمات خادم i-mobile التي تم ضبطها في واجهة المستخدم AdMob غير متوفّرة أو غير صالحة. |
| 102 | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع i-mobile. |
| 103 | تعذّر على i-mobile عرض إعلان. |
| 104 | عرض i-mobile مصفوفة إعلان مدمج مع المحتوى فارغة. |
| 105 | تعذّر على i-mobile تنزيل مواد عرض الإعلانات المدمجة مع المحتوى. |
| 106 | لا يتيح i-mobile طلب عرض عدة إعلانات بينية باستخدام رقم تعريف Spot نفسه. |
سجلّ تغييرات المكوّن الإضافي لتوسّط Unity في i-mobile
الإصدار 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 من محوّل 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 من محوّل Android للأجهزة الجوّالة.
- يتوافق مع الإصدار 2.3.0.0 من محوّل iOS من i-mobile.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.3.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.2.2
- يتوافق مع الإصدار 2.0.23.1 من محوّل Android للأجهزة الجوّالة.
- يتوافق مع الإصدار 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 من محوّل 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 للأجهزة الجوّالة.
الإصدار 1.0.1
- يتوافق مع الإصدار 2.0.21.0 من محوّل Android للأجهزة الجوّالة.
- يتوافق مع الإصدار 2.0.31.0 من محوّل iOS من i-mobile.
الإصدار 1.0.0
- الإصدار الأول!
- يتوافق مع الإصدار 2.0.20.1 من محوّل Android للأجهزة الجوّالة.
- يتوافق مع الإصدار 2.0.29.0 من محوّل iOS من i-mobile.