دمج i-mobile مع التوسط

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

انتقِل إلى علامة التبويب 広告スポット管理 (إدارة مساحة الإعلان) وانقر على الزر 新規広告スポット (مساحة إعلان جديدة).

create_ad_spot

بعد ذلك، املأ النموذج عن طريق تقديم 広告보ُولْッち名 (اسم الموضع الإعلاني)، 広告ُولْッタイズ (حجم المساحة الإعلانية) وتفاصيل أخرى. بعد ذلك، انقر على زر زر ENT規登録 (الاشتراك)

new_ad_spot_form

المساحة الإعلانية الجديدة جاهزة. للاطّلاع على تفاصيل الدمج، انقر على زر プล定取得 (الحصول على إعدادات التطبيق)

ad_spot_list

يُرجى تدوين パブリッシャーID (رقم تعريف الناشر) وメディアID (رقم تعريف الوسائط) وスポットID (رقم تعريف الإعلان). ستحتاج إلى هذه المعلمات لاحقًا عند الضبط i-mobile للتوسّط في واجهة مستخدم AdMob.

Android

iOS

الخطوة 2: إعداد طلب i-mobile في Ad Manager واجهة المستخدم

الخطوة 3: استيراد حزمة i-mobile SDK ومحوِّل i-mobile

في ملف 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")
}

الدمج اليدوي

  1. نزِّل أحدث إصدار من i-mobile SDK واستخرِجملف android-ad-sdk.aar ضمن مجلد sdk وأضِفه إلى مشروعك.

  2. انتقِل إلى عناصر محوِّل 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

  • الإصدار الأولي.
  • تمت إضافة دعم لإعلانات البانر والإعلانات البينية والإعلانات المدمجة مع المحتوى.