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

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

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

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

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

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

• مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث

• أحدث إصدار من Google Mobile Ads SDK (Legacy)

• إعداد التوسّط

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

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

أضِف تطبيقك إلى لوحة بيانات i-mobile من خلال النقر على علامة التبويب サイト／アプリ管理 (إدارة الموقع الإلكتروني/التطبيق) والزر الخاص بمنصة تطبيقك.

املأ النموذج وانقر على الزر 新規登録 (اشتراك).

لإنشاء موضع إعلاني جديد، اختَر تطبيقك ضمن علامة التبويب サイト／アプリ管理 (إدارة المواقع الإلكترونية/التطبيقات).

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

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

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

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

تعديل ملف app-ads.txt

مبادرة البائعون المعتمَدون للتطبيقات app-ads.txt هي مبادرة يقدّمها مختبر IAB التقني للمساعدة في ضمان عدم بيع مساحات إعلانية متاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم تكن قد فعلت ذلك، أنشئ ملف app-ads.txt في "إدارة إعلانات Google".

لتنفيذ app-ads.txt في i-mobile، يُرجى الاطّلاع على الأسئلة الشائعة.

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

ضبط إعدادات التوسّط لوحدتك الإعلانية

سجِّل الدخول إلى حسابك على "مدير إعلانات Google".

انتقِل إلى التسليم > مجموعة الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة شبكات إعلانية مدِرّة للأرباح جديدة.

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

بعد ذلك، انقر على الزر إضافة شريك إعلاني مدِّر للأرباح.

إذا كان لديك شريك إعلاني مدِّر للأرباح في i-mobile، يمكنك اختياره. بخلاف ذلك، اختَر إنشاء شريك جديد إعلاني مدِّر للأرباح.

اختَر i-mobile كـ شبكة إعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط.

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

بعد اختيار شريك إعلاني مدِّر للأرباح، اختَر التوسّط في حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وAndroid كـ النظام الأساسي، ونشط كـ الحالة. أدخِل الرقم التعريفي للناشر ومعرّف الوسائط ومعرّف الموضع الذي حصلت عليها في القسم السابق. بعد ذلك، أدخِل قيمة تكلفة تلقائية لكل ألف ظهور.

انقر على حفظ في أسفل الصفحة عند الانتهاء.

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) والمحوِّل الخاصَين بشبكة i-mobile

الدمج مع "استوديو Android" (يُنصح به)

في ملف settings.gradle.kts على مستوى المشروع، أضِف المستودعات التالية:

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

في ملف gradle على مستوى التطبيق، أضِف تبعيات التنفيذ التالية:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.5")
}

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

الدمج اليدوي

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

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

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

تحميل الإعلان مع سياق النشاط

يجب تمرير سياق Activity عند تحميل أشكال "إعلانات البانر" و"الإعلانات البينية" و"الإعلانات مقابل مكافأة" و"الإعلانات المدمجة مع المحتوى". بدون سياق النشاط، سيتعذّر تحميل الإعلان.

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

تفعيل الإعلانات الاختبارية

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

التحقّق من الإعلانات الاختبارية

للتأكّد من تلقّي إعلانات اختبارية من i-mobile، يجب تفعيل اختبار مصدر إعلان واحد في "أداة فحص الإعلانات" باستخدام مصادر إعلانات i-mobile (العرض بدون انقطاع).

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

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

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

يملأ محوّل i-mobile الحقول التالية لـ NativeAd.

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

رموز الخطأ

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

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

سجلّ تغييرات "محوّل التوسّط" في Android من i-mobile

الإصدار 2.3.2.5

• ثبِّت إصدار 1.9.0 من تبعية Kotlin الخاصة بالمحوّل (وهو الحد الأدنى من إصدار Kotlin المتوافق مع الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة).
• تم إصلاح سلوك التجاوز في فروع الفشل المحظورة على فئات عمرية معيّنة أثناء طلبات بدء الإعلانات وتحميلها.

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.4.0 من "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫IMobile SDK الإصدار 2.3.2

الإصدار 2.3.2.4

• فلترة الطلبات المحظورة على الفئات العمرية في حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile عند ضبط AgeRestrictedTreatment الجديدة على CHILD

تم التصميم والاختبار باستخدام:

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.2.0 من الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة
• ‫IMobile SDK الإصدار 2.3.2

الإصدار 2.3.2.3

• فلترة الطلبات المحظورة على فئات عمرية معيّنة لحزمة i-mobile SDK لأنّها لا يمكنها تلقّي إشارات محظورة على فئات عمرية معيّنة

تم التصميم والاختبار باستخدام:

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

الإصدار 2.3.2.2

• تمت إضافة سمة لإنشاء المحوّل مع مصدر الاعتمادية الخاص بـ "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة".
• تم نقل عمليات تنفيذ "إعلانات البانر" و"الإعلانات البينية" و"الإعلانات المدمجة مع المحتوى" من واجهة برمجة التطبيقات القديمة إلى واجهة برمجة التطبيقات الجديدة.

تم التصميم والاختبار باستخدام:

• الإصدار 25.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫IMobile SDK الإصدار 2.3.2

الإصدار 2.3.2.1

• تم تعديل الحد الأدنى المطلوب لمستوى واجهة برمجة تطبيقات Android إلى 23.
• تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 24.0.0.

تم التصميم والاختبار باستخدام:

• الإصدار 24.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫IMobile SDK الإصدار 2.3.2

الإصدار 2.3.2.0

• تم التأكّد من التوافق مع الإصدار 2.3.2 من حزمة تطوير البرامج (SDK) الخاصة بمنصة i-mobile.

تم إنشاؤه واختباره باستخدام:

• الإصدار 23.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫IMobile SDK الإصدار 2.3.2

الإصدار 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 من حزمة تطوير البرامج (SDK) لـ IMobile

الإصدار 2.3.1.0

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

تم التصميم والاختبار باستخدام:

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

الإصدار 2.3.0.0

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

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

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

الإصدار 2.0.21.0

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

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