يوضِّح لك هذا الدليل كيفية استخدام حزمة "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.