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

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

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

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

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

المتطلبات

• المستوى 21 أو إصدار أحدث من واجهة برمجة التطبيقات لنظام التشغيل 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 على مستوى التطبيق لتبعيات وتكوينات التنفيذ. استخدم أحدث إصدارات حزمة SDK ومحوّل i-mobile:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.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. حدد أحدث إصدار، ونزِّل i-mobile .aar الخاص بالمحوّل، وإضافته إلى مشروعك.

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

وليس من المطلوب إدخال رمز إضافي لتكامل i-mobile.

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

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

احرص على تسجيل جهاز الاختبار من أجل Ad Manager. يوفّر تطبيق i-mobile بيانات اختبار Spot ID وMedia ID والرقم التعريفي للناشر للاختبار، يمكنك العثور عليها هنا.

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

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

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

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

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

يملأ محوِّل i-mobile ما يلي الحقول لمدة NativeAd

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

رموز الخطأ

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

في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل 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 من حزمة IMobile SDK.

الإصدار 2.3.1.1

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

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

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

الإصدار

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

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

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

الإصدار 2.0.21.0

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

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