دمج maio مع "توسّط AdMob"

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

تستخدم واجهة لوحة البيانات في maio نصًا يابانيًا للتصنيفات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة في هذا الدليل. في المقابل، تتم الإشارة إلى التصنيفات والأزرار في الأوصاف والتعليمات هنا باستخدام ما يعادلها باللغة الإنجليزية. "URL スキーム," على سبيل المثال، يعني "مخطّط URL".

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

يوفّر محوّل التوسّط لـ maio الإمكانات التالية:

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

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

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

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

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

أولاً، عليك الاشتراك أو تسجيل الدخول إلى حسابك على maio. انقر على زر إدارة التطبيقات في الشريط الجانبي الأيمن، ثم انقر على تطبيق جديد.

انقر على علامة التبويب التي تتوافق مع نوع الإعلان المفضّل لديك.

إعلان بيني

أدخِل اسم تطبيقك، واختَر النظام الأساسي وقدِّم عنوان URL للتطبيق. اختَر إعلان فيديو بيني كـ نوع الإعلان، ثمّ انقر على تعديل.

Android

iOS

مقابل مكافأة

أدخِل اسم تطبيقك، واختَر النظام الأساسي وقدِّم عنوان URL للتطبيق. اختَر مقابل مكافأة كـ نوع الإعلان، ثمّ انقر على تعديل.

Android

iOS

في صفحة إدارة التطبيقات، سجِّل معرّف الوسائط. ويجب توفُّرها لإعداد وحدتك الإعلانية في AdMob في القسم التالي.

Android

iOS

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

Android

iOS

(العرض الإعلاني بدون انقطاع فقط) بالإضافة إلى رقم تعريف الوسائط ورقم تعريف المنطقة، ستحتاج إلى رقم تعريف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات لإعداد رقم تعريف وحدتك الإعلانية من أجل التوسّط. في صفحة Reporting API، دوِّن رقم تعريف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات.

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

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

Android

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

iOS

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

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

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

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

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

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

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

    npm

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

    خيط غزل

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

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

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

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

Android

لا يلزم استخدام رمز إضافي لدمج maio.

iOS

تكامل SKAdNetwork

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

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

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

تأكَّد من تسجيل جهازك الاختباري في AdMob.

سيتلقّى الناشرون الذين يستخدمون الإصدار 7.26.0 أو إصدارًا أحدث من Google Mobile Ads SDK for React Native إعلانات اختبارية تلقائيًا من maio على الهواتف والأجهزة اللوحية المسجّلة على أنّها أجهزة اختبارية عند تقديم الطلبات.

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

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

رموز الخطأ

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

Android

التنسيق اسم الصف
إعلان بيني jp.maio.sdk.android.mediation.admob.adapter.Interstitial
تمت المكافأة jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

التنسيق اسم الصف
إعلان بيني GADMMaioInterstitialAdapter
مقابل مكافأة GADMMaioRewardedAdapter

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

Android

رمز الخطأ السبب
0-10 عرضت maio خطأً خاصًا بحزمة تطوير البرامج (SDK). يمكنك الاطّلاع على الرمز ومستندات maio لمزيد من التفاصيل.
101 لا يتوفّر إعلان من Maio.
102 معلَمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف موضع الإعلان).
103 لم يكن السياق المستخدَم لتحميل إعلان مثيلاً لـ `Activity`.

iOS

رمز الخطأ السبب
0-10 عرضت maio خطأً خاصًا بحزمة تطوير البرامج (SDK). لمزيد من التفاصيل، يُرجى الاطّلاع على رمز maio.
101 لا يتوفّر إعلان في maio بعد.
102 معلَمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف موضع الإعلان).
103 لا يتوافق محوّل maio مع شكل الإعلان المطلوب.
104 تم تحميل إعلان مسبقًا لإعدادات الشبكة هذه.

الإصدار 0.1.0

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