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

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

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

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

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

المتطلبات

• المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى

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

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

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

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

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

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

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

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

بعد ذلك، املأ النموذج من خلال تقديم اسم موضع الإعلان (Ad Spot name) وحجم موضع الإعلان (Ad Spot size) وغير ذلك من التفاصيل. بعد ذلك، انقر على الزر 新規登録 (اشتراك).

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

دوِّن パブリッシャーID (Publisher ID) وメディアID (Media ID) وスポットID (Spot 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")
    }
  }
}

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

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

الدمج اليدوي

1. نزِّل أحدث إصدار من i-mobile SDK واستخرِج 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.

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

رموز الخطأ

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

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

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

الإصدار 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 على الأجهزة الجوّالة"
• ‫IMobile SDK الإصدار 2.3.1

الإصدار 2.3.1.1

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

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

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

الإصدار 2.3.1.0

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

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

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

الإصدار 2.3.0.0

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

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

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

الإصدار 2.0.23.1

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

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

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

الإصدار 2.0.23.0

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

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

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

الإصدار 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

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