يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من i-mobile باستخدام التوسّط، التي تغطي عمليات دمج الشلال. يتناول كيفية إضافة i-mobile إلى تهيئة التوسط، وكيفية دمج i-mobile SDK والمحوّل في تطبيق Android
تستخدم واجهة لوحة التحكم لـ i-mobile النص الياباني في تصنيفاته، والأزرار والأوصاف. لم يتم الاحتفاظ بلقطات الشاشة في هذا الدليل مترجمة. في أوصاف هذا الدليل وتعليماته، يتمّ ترجمة التصنيفات والأزرار مع إدراج نظائرها باللغة الإنجليزية بين قوسين.
أشكال الإعلانات وعمليات الدمج المتوافقة
يوفّر محوّل التوسّط في i-mobile الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
مدمجة مع المحتوى |
المتطلبات
- المستوى 21 أو إصدار أحدث من واجهة برمجة التطبيقات لنظام التشغيل Android
أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
إكمال عملية التوسّط دليل البدء
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم i-mobile
الخطوة 2: إعداد الطلب على i-mobile في واجهة مستخدم Ad Manager
الخطوة 3: استيراد المحوّل وحزمة تطوير البرامج (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.3.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
الدمج اليدوي
نزِّل أحدث إصدار من i-mobile SDK واستخراج
android-ad-sdk.aar
ضمن مجلدsdk
وإضافته إلى مشروعكانتقِل إلى عناصر محوّل i-mobile. على مستودع Maven الخاص بـ Google. حدد أحدث إصدار، ونزِّل i-mobile
.aar
الخاص بالمحوّل، وإضافته إلى مشروعك.
الخطوة 4: إضافة الرمز المطلوب
وليس من المطلوب إدخال رمز إضافي لتكامل i-mobile.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل Ad Manager. يوفّر تطبيق i-mobile بيانات اختبار Spot ID وMedia ID والرقم التعريفي للناشر للاختبار، يمكنك العثور عليها هنا.
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من i-mobile، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام i-mobile (Waterfall) مصادر الإعلانات.
خطوات اختيارية
استخدام الإعلانات المدمجة مع المحتوى
عرض الإعلانات
يملأ محوِّل i-mobile ما يلي
الحقول
لمدة
NativeAd
الحقل | يتم تضمين مواد العرض دائمًا بواسطة محوّل i-mobile |
---|---|
العنوان | |
صورة | |
النص الأساسي | |
رمز التطبيق | 1 |
الحث على اتخاذ إجراء | |
التقييم النجمي | |
المتجر | |
السعر |
1 بالنسبة إلى الإعلانات المدمجة مع المحتوى، لا توفّر حزمة i-mobile SDK مادة عرض رمز التطبيق. بدلاً من ذلك، يملأ محوِّل 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 | حدث خطأ في حزمة i-mobile SDK. الاطّلاع على الرمز لمزيد من التفاصيل. |
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 من حزمة IMobile SDK.
الإصدار 2.3.1.1
- تم تعديل المحوِّل لاستخدام فئة
VersionInfo
الجديدة. - تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.0.0.
تم التصميم والاختبار باستخدام:
- الإصدار 22.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 2.3.1 من حزمة IMobile SDK
الإصدار
- تم التحقق من التوافق مع الإصدار 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 من حزمة تطوير البرامج (SDK) i-mobile.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "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 من حزمة تطوير البرامج (SDK) i-mobile.
- تم تعديل المحوّل لإتاحة طلبات إعلانات البانر التكيُّفية المضمّنة.
تم التصميم والاختبار باستخدام
- الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 2.0.22 من حزمة IMobile SDK
الإصدار 2.0.21.0
- تم التحقق من التوافق مع الإصدار 2.0.21 من حزمة تطوير البرامج (SDK) i-mobile.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "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
- الإصدار الأولي.
- تمت إضافة دعم لإعلانات البانر والإعلانات البينية والإعلانات المدمجة مع المحتوى.