تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

دمج maio مع التوسط

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

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

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

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

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

المتطلبات

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

الإصدار 1.0.7 من حزمة SDK لنظام التشغيل maio أو أحدث

أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
إكمال عملية التوسّط دليل البدء

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

الخطوة 2: إعداد البيانات الشخصية في واجهة مستخدم Ad Manager

الخطوة 3: استيراد مهايئ وحزمة تطوير البرامج (SDK) لمنصة maio

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

الدمج اليدوي

تنزيل أحدث إصدار من maio Android SDK وإضافة لمشروعك.
انتقِل إلى عناصر محوّلات Maio في مستودع Maven من Google. اختَر أحدث إصدار، ونزِّل ملف " .aar" لمحوّل maio. وإضافته إلى مشروعك.

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

ليس عليك استخدام رمز إضافي للتكامل مع شبكة maio Android.

الخطوة 5: اختبار عملية التنفيذ

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

احرص على تسجيل جهاز الاختبار من أجل Ad Manager.

بالنسبة إلى الناشرين الذين يستخدمون الإصدار 11.6.0 أو الإصدارات الأحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة، سيتلقّى الناشرون إعلانات اختبارية من شبكة maio على الهواتف والأجهزة اللوحية المسجَّلة كـ أجهزة اختبارية عند تقديم طلبات.

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

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

رموز الخطأ

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

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

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

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