يوضِّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل إعلانات من i-mobile وعرضها باستخدام التوسّط، وتغطي عمليات دمج العرض الإعلاني بدون انقطاع. كما يتناول كيفية إضافة i-mobile إلى تهيئة توسط الوحدة الإعلانية، وكيفية دمج i-mobile SDK ومحوّل في أحد Android التطبيقات.
تستخدم واجهة لوحة المعلومات في i-mobile النص الياباني للتسميات والأزرار والأوصاف. لم تتم ترجمة لقطات الشاشة في هذا الدليل. في المقابل، في أوصاف هذا الدليل وإرشاداته، تتم ترجمة التسميات والأزرار مع ما يعادلها باللغة الإنجليزية بين قوسين.
عمليات الدمج وأشكال الإعلانات المتوافقة
يوفّر Ad Manager محوِّل التوسط لخدمة i-mobile الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
مدمجة مع المحتوى |
المتطلّبات
- المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android
أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
إكمال عملية التوسّط دليل البدء
الخطوة 1: ضبط عمليات الضبط في واجهة مستخدم i-mobile
سجّل الدخول أو سجّل الدخول إلى حسابك في i-mobile.
أضف تطبيقك إلى لوحة بيانات i-mobile عن طريق النقر على علامة التبويب サイポ/アプっ管っ (إدارة المواقع/التطبيقات) والزر الخاص بالنظام الأساسي لتطبيقك.
املأ النموذج وانقُر على الزر أردت 規登録 (الاشتراك).
لإنشاء موضع إعلاني جديد، اختَر تطبيقك ضمن علامة التبويب サイ明/アプっ管元 (إدارة المواقع الإلكترونية/التطبيقات).
انتقِل إلى علامة التبويب 広告 Join ッ社管っ (إدارة مواضع الإعلانات)وانقر على علامة التبويب أردت規広告明ッ بالتحديد (موضع إعلان جديد).
بعد ذلك، املأ النموذج من خلال إدخال كلّ من 広告スポッ بالتحديد名 (اسم موضع الإعلان) و広告ห社ッ بالتحديدサイズ (حجم منطقة الإعلان) والتفاصيل الأخرى. بعد ذلك، انقر على الزر أردت(規登録) (الاشتراك).
مكان الإعلان الجديد جاهز. وللاطّلاع على تفاصيل عملية الدمج، انقر على الزر アプ設定取得 (الحصول على إعدادات التطبيق).
حاوِل استخدام ッッポーID (الرقم التعريفي للناشر) و名デっアID (معرّف الوسائط) و إيقافグッ بالتحديدID (رقم تعريف الموقع الجغرافي). ستحتاج إلى هذه المعلمات لاحقًا عند تهيئة i-mobile للتوسط في واجهة مستخدم Ad Manager .
الخطوة 2: إعداد طلب i-mobile في واجهة مستخدم Ad Manager
ضبط إعدادات التوسّط لوحدتك الإعلانية
سجِّل الدخول إلى حسابك على "مدير الإعلانات".
انتقِل إلى عرض الإعلانات > مجموعات الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة الشبكات الإعلانية المدِرّة للأرباح جديدة.
أدخِل اسمًا فريدًا لمجموعة الشبكات الإعلانية المدِرّة للأرباح، واضبط الحالة على نشط، واختَر شكل الإعلان، واضبط نوع المستودع على تطبيق متوافق مع الأجهزة الجوّالة. ضمن قسم الاستهداف > المستودع، اختَر الوحدة الإعلانية ضمن المستودع وتطبيق الأجهزة الجوّالة التي تريد إضافة توسّط إليها.
بعد ذلك، انقر على الزر إضافة شريك أرباح.
إذا كان لديك شريك أرباح في i-mobile، يمكنك اختياره. إذا لم يكن لديك حساب، اختَر إنشاء شريك جديد لتحقيق الأرباح.
اختَر i-mobile باعتبارها شبكة الإعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط.
فعِّل الجمع التلقائي للبيانات، وأدخِل Login name and API Password
بعد اختيار الشريك المحقِّق للأرباح، اختر توسّط حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وAndroid باعتبارها النظام الأساسي، ونشط كالحالة. أدخِل Publisher ID, Media ID and Spot ID الذي تم الحصول عليه في القسم السابق. ثم أدخِل قيمة التكلفة التلقائية لكل ألف ظهور.
انقر على حفظ في أسفل الصفحة عند الانتهاء.
الخطوة 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
على مستوى التطبيق، أضِف
تبعيات التنفيذ وإعداداته التالية. استخدم أحدث إصدارات من
حزمة i-mobile SDK والمحوّل:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:imobile:2.3.1.1")
}
الدمج اليدوي
يمكنك تنزيل أحدث إصدار من حزمة تطوير البرامج (SDK) لخدمة i-mobile، واستخراج
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.getAdapterResponse()
ضمن الفئات التالية:
التنسيق | اسم الصف |
---|---|
بانر | 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، تم عرض قائمة فارغة من الإعلانات المدمجة مع المحتوى. |
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 نفسه. |
سجلّ تغييرات مهايئ توسّط Android على i-mobile
الإصدار التالي
- تم تحديث الحد الأدنى المطلوب لإصدار "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.4.0.
الإصدار 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 من i-mobile SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار "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 من حزمة i-mobile SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار "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
- الإصدار الأولي.
- تمت إضافة دعم إعلانات البانر والإعلانات البينية والإعلانات المدمجة مع المحتوى.