يوضّح لك هذا الدليل كيفية استخدام "حزمة SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات من i-mobile وعرضها باستخدام التوسّط، والذي يشمل عمليات دمج العرض الإعلاني بدون انقطاع. ويتناول هذا الدليل كيفية إضافة i-mobile إلى إعدادات التوسّط لوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوِّل i-mobile في Android تطبيق.
تستخدم واجهة لوحة البيانات في i-mobile النص الياباني لتصنيفاتها buttons وأوصافها. لم يتم الاحتفاظ بلقطات الشاشة في هذا الدليل مترجمة. في أوصاف هذا الدليل وتعليماته، يتمّ ترجمة التصنيفات والأزرار مع إدراج نظائرها باللغة الإنجليزية بين قوسين.
عمليات الدمج وأشكال الإعلانات المتوافقة
يوفّر محوّل التوسّط في i-mobile الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
مدمجة مع المحتوى |
المتطلبات
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
إكمال التوسّط دليل البدء
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم i-mobile
الاشتراك أو التسجيل إلى حسابك على i-mobile.
أضف تطبيقك إلى لوحة معلومات i-mobile من خلال النقر على علامة التبويب 「イプー㮡っ (إدارة المواقع الإلكترونية/إدارة التطبيقات) والزر الخاص بـ التطبيق.
Android
iOS
املأ النموذج وانقر على الزر ENT規登録 (الاشتراك).
Android
iOS
لإنشاء موضع إعلاني جديد، حدد تطبيقك ضمن علامة التبويب 여イƒ/ بخطوتين プー管 المتوفّرة (إدارة المواقع الإلكترونية/التطبيقات)
Android
iOS
انتقِل إلى علامة التبويب 広告スポット管理 (إدارة مساحة الإعلان) وانقر على الزر 新規広告スポット (مساحة إعلان جديدة).
بعد ذلك، املأ النموذج عن طريق تقديم 広告보ُولْッち名 (اسم الموضع الإعلاني)، 広告ُولْッタイズ (حجم المساحة الإعلانية) وتفاصيل أخرى. بعد ذلك، انقر على زر زر ENT規登録 (الاشتراك)
المساحة الإعلانية الجديدة جاهزة. للاطّلاع على تفاصيل الدمج، انقر على زر プล定取得 (الحصول على إعدادات التطبيق)
يُرجى تدوين パブリッシャーID (رقم تعريف الناشر) وメディアID (رقم تعريف الوسائط) وスポットID (رقم تعريف الإعلان). ستحتاج إلى هذه المعلمات لاحقًا عند الضبط i-mobile للتوسّط في واجهة مستخدم AdMob.
Android
iOS
الخطوة 2: إعداد طلب i-mobile في Ad Manager واجهة المستخدم
الخطوة 3: استيراد حزمة i-mobile SDK ومحوِّل i-mobile
الدمج مع "استوديو Android" (يُنصح به)
في ملف settings.gradle.kts
على مستوى المشروع، أضِف موارد الالتقاط التالية:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
بعد ذلك، أضِف في ملف build.gradle.kts
على مستوى التطبيق
الإعدادات وتبعيات التنفيذ التالية. استخدِم أحدث إصدارات من
حزمة تطوير البرامج (SDK) ومحوّل i-mobile:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.4.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
الدمج اليدوي
نزِّل أحدث إصدار من i-mobile SDK واستخرِجملف
android-ad-sdk.aar
ضمن مجلدsdk
وأضِفه إلى مشروعك.انتقِل إلى عناصر محوِّل i-mobile في مستودع Maven من Google. اختَر أحدث إصدار، ونزِّل ملف
.aar
الخاص بمحوِّل i-mobile ، وأضِفه إلى مشروعك.
الخطوة 4: إضافة الرمز المطلوب
ولا يلزم إدخال رمز إضافي لتكامل i-mobile.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل Ad Manager. يوفّر تطبيق i-mobile بيانات اختبار Spot ID وMedia ID والرقم التعريفي للناشر للاختبار، يمكنك العثور عليها هنا.
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من i-mobile، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام i-mobile (Waterfall) مصادر الإعلانات.
خطوات اختيارية
استخدام الإعلانات المدمجة مع المحتوى
عرض الإعلانات
يعبّئ محوِّل i-mobile
لملف شخصي على
NativeAd
.
الحقل | يتم تضمين مواد العرض دائمًا بواسطة محوّل i-mobile |
---|---|
العنوان | |
صورة | |
النص الأساسي | |
رمز التطبيق | 1 |
الحث على اتخاذ إجراء | |
التقييم النجمي | |
المتجر | |
السعر |
1 بالنسبة إلى الإعلانات المدمجة مع المحتوى، لا توفّر حزمة تطوير البرامج (SDK) لـ i-mobile مادة عرض لرمز التطبيق. بدلاً من ذلك، يملأ محوِّل i-mobile رمز التطبيق بصورة شفافة.
رموز الخطأ
إذا تعذّر على المُحوِّل تلقّي إعلان من i-mobile،
يمكن للناشرين التحقّق من الخطأ الأساسي من خلال استجابة الإعلان باستخدام
ResponseInfo.getAdapterResponses()
ضمن الفئات التالية:
التنسيق | اسم الصف |
---|---|
بانر | com.google.ads.mediation.imobile.IMobileAdapter |
إعلان بيني | com.google.ads.mediation.imobile.IMobileAdapter |
مدمجة مع المحتوى | com.google.ads.mediation.imobile.IMobileMediationAdapter |
في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل i-mobile عند تعذّر تحميل إعلان:
رمز الخطأ | السبب |
---|---|
0-99 | ظهرت رسالة خطأ في حزمة تطوير البرامج (SDK) i-mobile. الاطّلاع على الرمز لمزيد من التفاصيل. |
101 | تتطلّب i-mobile سياق Activity لتحميل الإعلانات. |
102 | عدم توفّر/عدم صلاحية مَعلمات خادم i-mobile التي تم ضبطها في واجهة مستخدم Ad Manager |
103 | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع i-mobile. |
104 | عرض معاودة الاتصال بنجاح في تحميل الإعلانات المدمجة مع المحتوى لـ i-mobile قائمة فارغة للإعلانات المدمجة مع المحتوى. |
سجلّ التغييرات في i-mobile Android Mediation Adapter
الإصدار 2.3.2.0
- تم التحقق من التوافق مع الإصدار 2.3.2 من حزمة تطوير البرامج (SDK) لـ i-mobile.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 23.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 2.3.2 من حزمة IMobile SDK.
الإصدار 2.3.1.2
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 23.0.0.
- تم التحقق من التوافق مع الإصدار 2.3.1 من حزمة تطوير البرامج (SDK) لـ i-mobile.
تم التصميم والاختبار باستخدام:
- الإصدار 23.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 2.3.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل IMobile
الإصدار 2.3.1.1
- تم تعديل المُحوِّل لاستخدام فئة
VersionInfo
الجديدة. - تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.0.0.
تم التصميم والاختبار باستخدام:
- الإصدار 22.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 2.3.1 من حزمة IMobile SDK.
الإصدار 2.3.1.0
- تم التحقق من التوافق مع الإصدار 2.3.1 من حزمة تطوير البرامج (SDK) لـ i-mobile.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.5.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 21.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 2.3.1 من حزمة IMobile SDK.
الإصدار 2.3.0.0
- تم التحقّق من التوافق مع الإصدار 2.3.0 من حزمة i-mobile SDK.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.3.0.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 21.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 2.3.0 من حزمة IMobile SDK.
الإصدار 2.0.23.1
- تم تعديل
compileSdkVersion
وtargetSdkVersion
إلى واجهة برمجة التطبيقات 31. - تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.0.0.
- تم تعديل الحد الأدنى المطلوب لمستوى واجهة برمجة تطبيقات Android إلى 19.
تمّ تصميمها واختبارها باستخدام:
- الإصدار 21.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 2.0.23 من حزمة IMobile SDK
الإصدار 2.0.23.0
- تم التحقق من التوافق مع الإصدار 2.0.23 من حزمة تطوير البرامج (SDK) i-mobile.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.5.0.
تم التصميم والاختبار باستخدام
- الإصدار 20.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 2.0.23 من حزمة IMobile SDK
الإصدار 2.0.22.2
- تمت إضافة رموز ورسائل خطأ مُعَدَّلة للمحوِّل.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.1.0.
تم إنشاؤها واختبارها باستخدام
- الإصدار 20.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 2.0.22 من حزمة IMobile SDK
الإصدار 2.0.22.1
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.0.0.
تم التصميم والاختبار باستخدام
- الإصدار 20.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 2.0.22 من حزمة IMobile SDK
الإصدار 2.0.22.0
- تم التحقّق من التوافق مع الإصدار 2.0.22 من حزمة i-mobile SDK.
- تم تعديل المُحوِّل لتلبية طلبات إعلانات البانر التكيُّفية المضمّنة.
تم التصميم والاختبار باستخدام
- الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 2.0.22 من حزمة IMobile SDK
الإصدار 2.0.21.0
- تم التحقّق من التوافق مع الإصدار 2.0.21 من حزمة i-mobile SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.1.0.
- تمّت إضافة إمكانية تكبير إعلانات البانر التكيُّفية.
تم التصميم والاختبار باستخدام
- الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 2.0.21 من حزمة IMobile SDK
الإصدار 2.0.20.2
- دعم إضافي لأحجام إعلانات البانر المرنة.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.3.0.
تم التصميم والاختبار باستخدام
- الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 2.0.20 من حزمة IMobile SDK
الإصدار 2.0.20.1
- يعرض المُحوِّل الآن نسبة عرض إلى ارتفاع
mediaContent
غير صفرية.
تم التصميم والاختبار باستخدام
- الإصدار 18.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 2.0.20 من حزمة IMobile SDK
الإصدار 2.0.20.0
- الإصدار الأولي.
- تمت إضافة دعم لإعلانات البانر والإعلانات البينية والإعلانات المدمجة مع المحتوى.