دمج i-mobile مع "توسّط AdMob"

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

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

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

يوفّر محوّل "توسّط AdMob" لخدمة i-mobile الميزات التالية:

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

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

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

  • أحدث إصدار من Google Mobile Ads SDK for React Native
  • الإصدار 0.85.0 أو إصدار أحدث من إطار عمل React Native
  • للنشر على أجهزة Android
    • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
  • للنشر على أجهزة iOS
    • أن يكون هدف نشر iOS هو الإصدار 13.0 أو إصدار أحدث
  • مشروع React Native يعمل بشكل صحيح وتم ضبطه باستخدام Google Mobile Ads SDK for React Native يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads SDK for React Native لمزيد من التفاصيل.
  • إعداد ميزة "توسّط AdMob"

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

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

Android

iOS

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

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

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

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

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

Android

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

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

في الدليل الجذري لمشروعك، ثبِّت محوِّل التوسّط Google Mobile Ads SDK for React Native الخاص بـ i-mobile. يُرجى إكمال الخطوات التالية:

  1. انسخ ملف tar الخاص بمحوّل Google Mobile Ads SDK for React Native من دليل gma-sdk-react-native/adapters/imobile/ إلى دليل local_packages/ في مشروعك. إذا لم يكن لديك المجلد adapters، يُرجى الاطّلاع على المتطلبات الأساسية.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/imobile/gma-mediation-imobile-0.1.0.tgz local_packages/

    استبدِل EXTRACT_DIR بالمسار إلى الدليل الذي استخرجت الأرشيف فيه.

  2. ثبِّت حزمة المحوّل باستخدام أداة إدارة الحِزم المفضّلة لديك:

    npm

    npm install ./local_packages/gma-mediation-imobile-0.1.0.tgz

    خيط غزل

    yarn add ./local_packages/gma-mediation-imobile-0.1.0.tgz

  3. إذا كنت تنشئ تطبيقًا لنظام التشغيل Android، أضِف المستودع التالي إلى ملف build.gradle في دليل android الخاص بمشروعك:

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

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

Android

لا يتطلّب دمج i-mobile أي رمز إضافي.

iOS

تكامل SKAdNetwork

اتّبِع مستندات i-mobile لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

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

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

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

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

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

رموز الخطأ

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

Android

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

iOS

التنسيق اسم الصف
بانر IMobileAdapter
إعلان بيني IMobileAdapter
مدمج مع المحتوى GADMediationAdapterIMobile

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

Android

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

iOS

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

الإصدار 0.1.0

  • الإصدار الأوّلي