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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

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

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

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

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

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

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

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

• أحدث إصدار من GMA Next-Gen SDK

• إعداد ميزة "توسّط AdMob"

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

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

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

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

ملاحظة: يجب أن توافق i-mobile على تسجيلك. بعد الموافقة على طلبك، يمكنك إنشاء مساحة إعلانية.

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

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

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

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

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

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

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

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

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

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

عليك إضافة i-mobile إلى إعدادات التوسّط لوحدتك الإعلانية.

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

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

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

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

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

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

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

ضمن بطاقة العرض الإعلاني بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان.

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

ملاحظة: عليك إعداد ميزة "تحسين مصدر الإعلان" مرّة واحدة فقط لكلّ شبكة.

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



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

ملاحظة: يستغرق تحسين مصدر الإعلان بضعة أيام لجمع بيانات كافية من أجل احتساب التكلفة الفعلية لكل ألف ظهور بدقة لشبكة توسط. في الوقت نفسه، تكون حالة تحسين مصدر الإعلان هي PENDING، لذا عليك ضبط قيمة التكلفة الفعلية لكل ألف ظهور يدويًا للشبكة. بعد احتساب التكلفة الفعلية لكل ألف ظهور، يبدأ مصدر الإعلان تلقائيًا بتعديل التكلفة الفعلية لكل ألف ظهور نيابةً عنك.

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

ملاحظة: قد يؤدي عدم دمج إصدارات i-mobile وGMA Next-Gen SDK المتوافقة إلى حدوث مشاكل في عملية الإنشاء.

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

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

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

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.5")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.5'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

الدمج اليدوي

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

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

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

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

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

الخطوة 5: اختبار عملية الإعداد

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

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

ملاحظة مهمة: عليك إيقاف وضع الاختبار في AdMob وi-mobile قبل إصدار تطبيقك.

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

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

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

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

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

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

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

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

رموز الخطأ

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

التنسيق	اسم الصف
بانر	com.google.ads.mediation.imobile.IMobileAdapter
إعلان بيني	com.google.ads.mediation.imobile.IMobileAdapter
مدمج مع المحتوى	com.google.ads.mediation.imobile.IMobileMediationAdapter

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

رمز الخطأ	السبب
0-99	عرضت حزمة تطوير البرامج (SDK) لـ i-mobile خطأً. يمكنك الاطّلاع على الرمز لمزيد من التفاصيل.
101	تتطلّب i-mobile سياق Activity لتحميل الإعلانات.
102	مَعلمات خادم i-mobile التي تم ضبطها في واجهة مستخدم AdMob غير متوفّرة أو غير صالحة.
103	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع i-mobile.
104	أرجعت دالة الاستدعاء المتعلّقة بنجاح تحميل الإعلانات المدمجة مع المحتوى في i-mobile قائمة إعلانات مدمجة مع المحتوى فارغة.
105	تم تطبيق معالجة الحظر على فئات عمرية معيّنة على الطلب، ولكن لا يمكن لحزمة i-mobile SDK تلقّي إشارات الحظر على فئات عمرية معيّنة

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

الإصدار التالي

• تم تعديل المحوّل لاستخدام واجهة برمجة التطبيقات InitializationCompleteCallback.onInitializationFailed(AdError).
• تم تعديل الحد الأدنى المطلوب لمستوى واجهة برمجة تطبيقات Android إلى 24.
• تم إصلاح مشكلة عدم إعادة توجيه عمليات استدعاء تحميل الإعلانات البينية وعرضها بسبب تسجيل مستمع فارغ في حزمة تطوير البرامج (SDK) من i-mobile.

الإصدار 2.3.2.5

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

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

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

الإصدار 2.3.2.4

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

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

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

الإصدار 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 على الأجهزة الجوّالة"
• الإصدار 2.3.2 من حزمة SDK لتطبيق IMobile

الإصدار 2.3.2.1

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

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

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

الإصدار 2.3.2.0

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

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

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

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

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