يوضِّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل إعلانات من i-mobile وعرضها باستخدام التوسّط، وتغطي عمليات دمج العرض الإعلاني بدون انقطاع. كما يتناول كيفية إضافة i-mobile إلى تهيئة توسط الوحدة الإعلانية، وكيفية دمج i-mobile SDK ومحوّل في أحد تطبيقات Unity.
تستخدم واجهة لوحة المعلومات في i-mobile النص الياباني للتسميات والأزرار والأوصاف. لم تتم ترجمة لقطات الشاشة في هذا الدليل. في المقابل، في أوصاف هذا الدليل وإرشاداته، تتم ترجمة التسميات والأزرار مع ما يعادلها باللغة الإنجليزية بين قوسين.
عمليات الدمج وأشكال الإعلانات المتوافقة
يوفّر Ad Manager محوِّل التوسط لخدمة i-mobile الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة |
المتطلّبات
- Unity 5.6 أو إصدار أحدث
- أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
- للنشر على Android:
- المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android
- للنشر على iOS:
- هدف نشر iOS هو 12.0 أو إصدار أحدث
- مشروع Unity عملي تم إعداده باستخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: ضبط عمليات الضبط في واجهة مستخدم i-mobile
سجّل الدخول أو سجّل الدخول إلى حسابك في i-mobile.
أضف تطبيقك إلى لوحة بيانات i-mobile عن طريق النقر على علامة التبويب サイポ/アプっ管っ (إدارة المواقع/التطبيقات) والزر الخاص بالنظام الأساسي لتطبيقك.
Android
iOS
املأ النموذج وانقُر على الزر أردت 規登録 (الاشتراك).
Android
iOS
لإنشاء موضع إعلاني جديد، اختَر تطبيقك ضمن علامة التبويب サイ明/アプっ管元 (إدارة المواقع الإلكترونية/التطبيقات).
Android
iOS
انتقِل إلى علامة التبويب 広告 Join ッ社管っ (إدارة مواضع الإعلانات)وانقر على علامة التبويب أردت規広告明ッ بالتحديد (موضع إعلان جديد).
بعد ذلك، املأ النموذج من خلال إدخال كلّ من 広告スポッ بالتحديد名 (اسم موضع الإعلان) و広告ห社ッ بالتحديدサイズ (حجم منطقة الإعلان) والتفاصيل الأخرى. بعد ذلك، انقر على الزر أردت(規登録) (الاشتراك).
مكان الإعلان الجديد جاهز. وللاطّلاع على تفاصيل عملية الدمج، انقر على الزر アプ設定取得 (الحصول على إعدادات التطبيق).
حاوِل استخدام ッッポーID (الرقم التعريفي للناشر) و名デっアID (معرّف الوسائط) و إيقافグッ بالتحديدID (رقم تعريف الموقع الجغرافي). ستحتاج إلى هذه المعلمات لاحقًا عند تهيئة i-mobile للتوسط في واجهة مستخدم Ad Manager .
Android
iOS
الخطوة 2: إعداد طلب i-mobile في واجهة مستخدم Ad Manager
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) الخاصة بخدمة 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 طلب إنشاء إعلانات بينية متعددة تستخدم رقم تعريف Spot نفسه. |
سجلّ التغييرات في المكوّن الإضافي i-mobile Unity Mediation
الإصدار 1.3.2
- تم نقل محتوى المحوّل إلى
GoogleMobileAds/Mediation/IMobile/
. - يتوافق مع الإصدار 2.3.1.1 من محوّل i-mobile يعمل بنظام التشغيل Android.
- يتوافق مع الإصدار 2.3.2.0 من محوّل i-mobile لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.1.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.3.1
- يتوافق مع الإصدار 2.3.0.0 من محوّل Android لأجهزة i-mobile.
- يتوافق مع الإصدار 2.3.0.1 من محوّل i-mobile لنظام التشغيل iOS.
- تم إنشاء الإصدار 7.4.1 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.4.1.
الإصدار 1.3.0
- يتوافق مع الإصدار 2.3.0.0 من محوّل Android لأجهزة i-mobile.
- يتوافق مع الإصدار 2.3.0.0 من محوّل i-mobile لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.3.1 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.2.2
- يتوافق مع الإصدار 2.0.23.1 من محوّل i-mobile يعمل بنظام التشغيل Android.
- يتوافق مع الإصدار 2.2.0.1 من محوّل i-mobile لنظام التشغيل iOS.
- تم إنشاء الإصدار 7.0.2 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.0.2.
الإصدار 1.2.1
- يتوافق مع الإصدار 2.0.23.0 من محوّل i-mobile يعمل بنظام التشغيل Android.
- يتوافق مع الإصدار 2.2.0.1 من محوّل i-mobile لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.0.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 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 من محوّل Android لأجهزة i-mobile.
- يتوافق مع الإصدار 2.0.31.0 من محوّل i-mobile لنظام التشغيل iOS.
الإصدار 1.0.0
- الإصدار الأول
- يتوافق مع الإصدار 2.0.20.1 من محوّل i-mobile يعمل بنظام التشغيل Android.
- يتوافق مع الإصدار 2.0.29.0 من محوّل i-mobile لنظام التشغيل iOS.