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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يوضّح لك هذا الدليل كيفية استخدام حزمة تطوير البرامج (SDK) لـ "إعلانات Google" على الأجهزة الجوّالة لتحميل الإعلانات من i-mobile وعرضها، وذلك باستخدام التوسط، والذي يتناول عمليات التكامل مع العرض الإعلاني بدون انقطاع. يتناول هذا الدليل كيفية إضافة خدمة i-mobile إلى إعدادات ضبط وحدة إعلانية وكيفية دمج حزمة تطوير البرامج (SDK) للأجهزة الجوّالة وi-mobile في تطبيق Android .

تستخدم واجهة لوحة البيانات لـ i-mobile نصًا يابانيًا للتصنيفات والأزرار والأوصاف. لم تتم ترجمة لقطات الشاشة في هذا الدليل. في أوصاف هذا الدليل والتعليمات الخاصة به، تتم ترجمة التصنيفات والأزرار مع ما يعادلها من اللغة الإنجليزية بين قوسين.

عمليات التكامل وأشكال الإعلانات المتاحة

يوفّر AdMob محوّل التوسّط لأجهزة i-mobile الإمكانيات التالية:

الدمج
عروض الأسعار
الشلال
التنسيقات
"بانر"
إعلان بيني
تم منح المكافأة
مدمجة مع المحتوى

المتطلّبات

  • مستوى واجهة برمجة تطبيقات Android 19 أو أعلى
  • أحدث SDK لإعلانات Google على الأجهزة الجوّالة

الخطوة الأولى: إعداد خدمة i-mobile

اشترِك أو سجِّل الدخول إلى حسابك على i-mobile.

أضِف تطبيقك إلى لوحة بيانات نظام التشغيل i-mobile عن طريق النقر على علامة التبويب サ英語/アプん管ა (إدارة الموقع/التطبيق) والنقر على زر 新規Androidアプん (تطبيق Android جديد) .

سجِّل تطبيقك من خلال توفير 名称 (الاسم) و マーケッURL (عنوان URL للسوق). بعد ذلك، انقر على الزر 新規登録 (الاشتراك) بعد ملء بقية النموذج.

لإنشاء منصّة إعلانية جديدة، اختَر تطبيقك ضمن علامة التبويب サ英語/アプん管キ (إدارة الموقع/التطبيق).

انتقِل إلى علامة التبويب 広告일чッ管ა (إدارة موضع الإعلان) وانقر على الزر 新規広告英ッ (نقطة الإعلان الجديدة).

إنشاء_إعلان_معيّن

وبعد ذلك، املأ النموذج عن طريق توفير 広告ц英ッ名 (اسم موضع الإعلان) و広告ц英ッサイズ حجم التفاصيل الأخرى. وبعد ذلك، انقر على الزر 新規登録 (الاشتراك).

new_ad_spot_form

أصبحت نقطة الإعلان الجديدة جاهزة. ولعرض تفاصيل الدمج، انقر على الزر アプ英號定取得 (الحصول على إعدادات التطبيقات).

ad_spot_list

دوِّن المعرّف 일일籍ッャーID (رقم تعريف الناشر) وÀデ英アID (رقم تعريف الوسائط) و일PubッID (رقم تعريف الموضع). ستحتاج هذه المعلمات لاحقًا عند ضبط i-mobile للتوسط في AdMob واجهة المستخدم.

الخطوة الثانية: ضبط إعدادات التوسّط للوحدة الإعلانية AdMob

ستحتاج الآن إلى إضافة i-mobile إلى إعداد التوسّط لوحدتك الإعلانية. ولإجراء ذلك، عليك أولاً تسجيل الدخول إلى حسابك على AdMob.

بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسط حالية تريد تعديلها، انقر على اسم مجموعة التوسط هذه لتعديلها، وتخطّ ذلك إلى إضافة i-mobile كمصدر إعلان.

لإنشاء مجموعة توسط جديدة، اختَر إنشاء مجموعة توسط.

علامة التبويب "التوسّط" في AdMob

أدخِل شكل الإعلان والنظام الأساسي، ثم انقر على متابعة.

أدخِل اسمًا لمجموعة التوسط، واختَر مواقع جغرافية لاستهدافها. اضبط حالة مجموعة التوسط على مفعّلة. بعد ذلك، انقر على إضافة وحدات إعلانية.

اربط مجموعة التوسط هذه بوحداتك الإعلانية الحالية في AdMob. انقر على تم.

من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية التي تمت تعبئتها بالوحدات الإعلانية التي اخترتها.

إضافة i-mobile كمصدر إعلان

في بطاقة مصادر الإعلانات، اختَر إضافة شبكة مواقع إعلانية.

اختَر i-mobile وفعِّل ميزة التحسين. أدخل اسم تسجيل الدخول وكلمة مرور واجهة برمجة التطبيقات لحسابك على i-mobile لإعداد تحسين مصدر الإعلان i-mobile. وبعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور لأجهزة i-mobile، ثم انقر على متابعة.

أدخِل الرقم التعريفي للناشر ورقم تعريف الوسائط ورقم تعريف المساحة، الذي تم الحصول عليه قبل ذلك.

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) للأجهزة الجوّالة وi

أضِف تبعيات التنفيذ التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) للأجهزة الجوّالة ومحوّلات i-mobile في ملف build.gradle على مستوى التطبيق:

repositories {
    google()
    mavenCentral()
    maven {
      url  "https://imobile.github.io/adnw-sdk-android"
    }
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:21.3.0'
    implementation 'com.google.ads.mediation:imobile:2.0.23.1'
}
...

الدمج اليدوي

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

  2. انتقِل إلى عناصر محوّلات i-mobile في "مستودع Maven" من Google. اختَر أحدث إصدار، ونزِّل ملف .aar لأجهزة i-mobile للأجهزة الجوّالة، ثم أضِفه إلى مشروعك.

الخطوة 4: طلب رمز إضافي

ولا حاجة إلى استخدام رمز إضافي لدمج نظام التشغيل i-mobile.

الخطوة 5: اختبار عملية التنفيذ

لاختبار عملية الدمج، توفّر خدمة i-mobile رقم تعريف Spot ورقم تعريف الوسائط والرقم التعريفي للناشر التجريبي لجميع أشكال الإعلانات. ويمكنك العثور عليها هنا.

خطوات اختيارية

استخدام الإعلانات المدمجة مع المحتوى

عرض الإعلانات

يملأ محوّل i-mobile ما يلي: أوصاف الحقول المتقدمة للإعلانات المدمجة مع المحتوى لل NativeAd.

الحقل مواد العرض المضمّنة دائمًا بواسطة محوّل i-mobile
العنوان
صورة
النص الأساسي
رمز التطبيق 1
الحث على اتخاذ إجراء
التقييم النجمي
المتجر
السعر

1 بالنسبة إلى الإعلانات المدمجة مع المحتوى، لا تقدّم حزمة تطوير البرامج (SDK) للأجهزة الجوّالة من i-mobile مادة عرض لرمز التطبيق. وبدلاً من ذلك، يملأ محوّل i-mobile رمز التطبيق بصورة شفافة.

رموز الخطأ

في حال تعذّر على محوّل تلقّي إعلان من i-mobile، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo.getAdapterResponse() ضمن الفئات التالية:

الشكل اسم الصف
"بانر" com.google.ads.وساطة.imobile.IMobileAdaptiveer
إعلان بيني com.google.ads.وساطة.imobile.IMobileAdaptiveer
مدمجة مع المحتوى com.google.ads.وساطة.imobile.IMobileMediationAdaptiveer

فيما يلي الرموز والرسائل المرافقة التي يعرضها محول i-mobile عندما يتعذّر تحميل إعلان:

رمز الخطأ السبب
0-99 عرضت حزمة i-mobile SDK خطأ. ولمزيد من التفاصيل، يُرجى الاطّلاع على الرمز.
101 يتطلب i-mobile سياق Activity لتحميل الإعلانات.
102 معلمات خادم i-mobile التي تم إعدادها في AdMob واجهة المستخدم مفقودة/غير صالحة.
103 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر المتوافق مع الأجهزة الجوّالة.
104 عرض معاودة الاتصال بنجاح تحميل الإعلان المدمج مع المحتوى i-mobile قائمة إعلانات مدمجة مع المحتوى فارغة.
0-10 عرضت حزمة i-mobile SDK خطأ. ولمزيد من التفاصيل، يُرجى الاطّلاع على الرمز.
101 معلمات خادم i-mobile التي تم إعدادها في AdMob واجهة المستخدم مفقودة/غير صالحة.
102 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر المتوافق مع الأجهزة الجوّالة.
103 تعذّر على i-mobile تقديم إعلان.
104 عرضت i-mobile مصفوفة إعلانية مدمجة مع المحتوى فارغة.
105 تعذّر على خدمة i-mobile تنزيل مواد عرض الإعلانات المدمجة مع المحتوى.
106 لا يتيح i-mobile طلب عدة إعلانات بينية باستخدام رقم تعريف Spot نفسه.

سجلّ التغيير لمحوّل توسط Android على الأجهزة الجوّالة

الإصدار 2.3.0.0 (قيد التقدم)

  • تم التحقق من التوافق مع الإصدار 2.3.0 من حزمة تطوير البرامج (SDK) لأجهزة الجوّال.
  • تم تحديث الحد الأدنى المطلوب لحزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى 21.3.0.

تم الإنشاء والاختبار باستخدام:

  • الإصدار 21.3.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.3.0 من حزمة تطوير البرامج (SDK) IMobile

الإصدار 2.0.23.1

  • تم تحديث compileSdkVersion وtargetSdkVersion إلى واجهة برمجة التطبيقات 31.
  • تم تحديث الحد الأدنى المطلوب لحزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى 21.0.0.
  • تم تعديل الحد الأدنى المطلوب لواجهة برمجة تطبيقات Android إلى 19.

تم الإنشاء والاختبار باستخدام:

  • الإصدار 21.0.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.0.23 من حزمة تطوير البرامج (SDK) IMobile

الإصدار 2.0.23.0

  • تم التحقق من التوافق مع الإصدار 2.0.23 من حزمة تطوير البرامج (SDK) للأجهزة الجوّالة من i.
  • تم تحديث الحد الأدنى المطلوب لحزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى 20.5.0.

أجهزة تم اختبارها واختبارها باستخدام

  • الإصدار 20.5.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.0.23 من حزمة تطوير البرامج (SDK) IMobile

الإصدار 2.0.22.2

  • تمت إضافة رموز ورسائل الخطأ المتعلقة بالمحوّل الموحّد.
  • تم تحديث الحد الأدنى المطلوب لحزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى 20.1.0.

أجهزة تم اختبارها واختبارها باستخدام

  • الإصدار 20.1.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.0.22 من حزمة تطوير برامج IMobile

الإصدار 2.0.22.1

  • تم تحديث الحد الأدنى المطلوب لحزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى 20.0.0.

أجهزة تم اختبارها واختبارها باستخدام

  • الإصدار 20.0.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.0.22 من حزمة تطوير برامج IMobile

الإصدار 2.0.22.0

  • تم التحقق من التوافق مع الإصدار 2.0.22 من حزمة تطوير البرامج (SDK) لأجهزة الجوّال i.
  • تم تعديل المحوّل لإتاحة طلبات إعلانات البانر التكيُّفية المضمّنة.

أجهزة تم اختبارها واختبارها باستخدام

  • الإصدار 19.1.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.0.22 من حزمة تطوير برامج IMobile

الإصدار 2.0.21.0

  • تم التحقق من التوافق مع الإصدار 2.0.21 من حزمة تطوير البرامج (SDK) للأجهزة الجوّالة من i.
  • تم تحديث الحد الأدنى المطلوب لإصدارات حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة إلى 19.1.0.
  • تم توفير إمكانية توسيع نطاق إعلانات البانر التكيُّفية.

أجهزة تم اختبارها واختبارها باستخدام

  • الإصدار 19.1.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.0.21 من حزمة تطوير البرامج (SDK) IMobile

الإصدار 2.0.20.2

  • تم توفير دعم لأحجام إعلانات البانر المرنة.
  • تم تحديث الحد الأدنى المطلوب لحزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى 18.3.0.

أجهزة تم اختبارها واختبارها باستخدام

  • الإصدار 18.3.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.0.20 من حزمة تطوير البرامج (SDK) IMobile

الإصدار 2.0.20.1

  • يعرض المحوّل الآن نسبة عرض إلى ارتفاع تبلغ mediaContent غير صفر.

أجهزة تم اختبارها واختبارها باستخدام

  • الإصدار 18.2.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 2.0.20 من حزمة تطوير البرامج (SDK) IMobile

الإصدار 2.0.20.0

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