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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مبادرة البائعون المعتمَدون للتطبيقات (app-ads.txt) هي مبادرة من المختبَر التقني لمكتب الإعلانات التفاعلية (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقك إلا من خلال القنوات التي حدَّدت أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف 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.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")
}

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: اختبار عملية الإعداد

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

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

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

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

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

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

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

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

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

رموز الخطأ

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

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

سجلّ التغييرات في محوّل التوسّط في 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

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