دمج i-mobile مع ميزة "التوسّط"

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

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

عمليات الدمج وأشكال الإعلانات المتوافقة

يتضمّن AdMob محوِّل التوسّط لخدمة i-mobile الإمكانيات التالية:

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

المتطلّبات

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

  • إكمال التوسّط دليل البدء

الخطوة 1: إعداد i-mobile

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

أضِف تطبيقك إلى لوحة بيانات i-mobile من خلال النقر على علامة التبويب サ تمتلكها/アプ I管 (إدارة الموقع الإلكتروني/التطبيق) والنقر على إليهم規Androidアプ (تطبيق Android جديد) .

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

لإنشاء موضع إعلاني جديد، حدّد تطبيقك ضمن علامة التبويب サイナ/アプリ管روعة (إدارة الموقع/التطبيق).

انتقل إلى علامة التبويب 広告人ッ مؤشرات管く (إدارة مواضع الإعلانات) وانقر على الزر جون 規広告 بِال الميلاد ッأقصى (مقطع إعلان جديد).

إنشاء_إعلان_نقطة

بعد ذلك، املأ النموذج من خلال توفير 広告นHeader ッ مؤشرات名 (اسم موضع الإعلان) و広告人ッツサイズ (حجم موضع الإعلان) والتفاصيل الأخرى. بعد ذلك، انقر على الزر visible登録 (الاشتراك).

نموذج_إعلان_نقطة_إعلان جديد

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

ad_spot_list

دوِّن المعلومات لكل من グッ يشاهدون ーID (الرقم التعريفي للناشر) وグデルアID (معرّف الوسائط)، وÀندو ッID (معرّف الشبكة الإعلانية). ستحتاج إلى هذه المعلمات لاحقًا عند تهيئة i-mobile للتوسط في واجهة AdMob .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الدمج اليدوي

  1. نزِّل أحدث إصدار من SDK i-mobile واستخرِج 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.troubleshooter.imobile.IMobileAdapter
إعلان بيني com.google.ads.troubleshooter.imobile.IMobileAdapter
مدمجة مع المحتوى com.google.ads.initiative.imobile.IMobileMediationAdapter

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

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

سجلّ التغييرات في محوِّل توسّط Android لخدمة i-mobile

الإصدار 2.3.1.1

  • تم تعديل المحوِّل لاستخدام فئة VersionInfo الجديدة.
  • تم تحديث الحد الأدنى المطلوب لإصدار "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.0.0.

تم إنشاء هذه التطبيقات واختبارها باستخدام:

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

الإصدار 2.3.1.0

  • تم التحقق من التوافق مع الإصدار 2.3.1 من حزمة i-mobile SDK.
  • تم تحديث الحد الأدنى المطلوب لإصدار "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.5.0.

تم إنشاء هذه التطبيقات واختبارها باستخدام:

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

الإصدار 2.3.0.0

  • تم التحقق من التوافق مع الإصدار 2.3.0 من حزمة i-mobile 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 من حزمة i-mobile SDK.
  • تم تحديث الحد الأدنى المطلوب لإصدار "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 من حزمة تطوير البرامج (SDK) لخدمة IMobile.

الإصدار 2.0.22.1

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

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

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

الإصدار 2.0.22.0

  • تم التحقق من التوافق مع الإصدار 2.0.22 من حزمة i-mobile SDK.
  • تم تعديل المحوِّل ليتوافق مع طلبات البانر التكيُّفية المضمَّنة.

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

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

الإصدار 2.0.21.0

  • تم التحقق من التوافق مع الإصدار 2.0.21 من حزمة i-mobile SDK.
  • تم تحديث الحد الأدنى المطلوب لإصدار "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.

الإصدار

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