يوضّح لك هذا الدليل كيفية استخدام "حزمة SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات من maio وعرضها باستخدام AdMob Mediation، وذلك في ما يتعلّق بدمج الإعلانات بدون انقطاع. ويتناول هذا الدليل كيفية إضافة maio إلى إعدادات التوسّط في الوحدة الإعلانية، وكيفية دمج حزمة SDK ومحوِّل maio في Android تطبيق.
تستخدم واجهة لوحة بيانات maio النص الياباني في التصنيفات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة الواردة في هذا الدليل. في أوصاف هذا الدليل وتعليماته، تتم الإشارة إلى التصنيفات والأزرار باستخدام نظائرها باللغة الإنجليزية. على سبيل المثال، "URL スキーム" يعني "مخطّط URL".
عمليات الدمج وأشكال الإعلانات المتوافقة
تتوفر للمحوِّل التوسّط في maio الإمكانات التالية:
التكامل | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
مدمجة مع المحتوى |
المتطلبات
- المستوى 21 أو إصدار أحدث لواجهة برمجة التطبيقات Android
- mai SDK 1.0.7 أو إصدار أحدث
أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
إكمال التوسّط دليل البدء
الخطوة 1: إعداد الإعدادات في واجهة مستخدم maio
أولاً، عليك الاشتراك أو تسجيل الدخول إلى حسابك على maio. انقر على زر إدارة التطبيقات في الشريط الجانبي الأيمن، ثم انقر على تطبيق جديد.
اختَر علامة التبويب التي تتوافق مع نوع الإعلان المفضّل لديك.
إعلان بيني
أدخِل اسم تطبيقك، واختَر النظام الأساسي وقدِّم عنوان URL للتطبيق. اختَر إعلان بيني في الفيديو كـ نوع الإعلان، ثمّ انقر على تعديل.
تم منح المكافأة
أدخِل اسم تطبيقك، واختَر النظام الأساسي وقدِّم عنوان URL للتطبيق. اختَر المكافآت في الفيديو كـ نوع الإعلان، ثم انقر على تعديل.
في صفحة إدارة التطبيقات، دوِّن معرّف الوسائط. يجب إعداد وحدتك الإعلانية على AdMob في القسم التالي.
في صفحة إدارة المنطقة، دوِّن رقم تعريف المنطقة. سيكون عليك أيضًا إعداد وحدتك الإعلانية على AdMob في القسم التالي.
بالإضافة إلى معرّف الوسائط ومعرّف المنطقة، ستحتاج إلى معرّف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات لإعداد رقم تعريف الوحدة الإعلانية للتوسّط. في صفحة Reporting API، دوِّن معرّف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات.الخطوة 2: إعداد طلب مايو في AdMob واجهة المستخدِم
ضبط إعدادات التوسّط لوحدتك الإعلانية
عليك إضافة maio إلى إعدادات التوسّط لوحدتك الإعلانية.
أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، وانتقِل إلى إضافة maio كمصدر إعلان.
لإنشاء مجموعة توسّط جديدة، اختَر إنشاء مجموعة توسّط.
أدخِل تنسيق الإعلان والمنصّة، ثم انقر على متابعة.
أدخِل اسمًا لمجموعة التوسّط، واختَر المواقع الجغرافية التي تريد استهدافها. بعد ذلك، اضبط حالة مجموعة التوسّط على مفعّلة، ثمّ انقر على إضافة وحدات إعلانية.
اربط مجموعة التوسّط هذه بوحدة إعلانية واحدة أو أكثر من وحدات AdMob الإعلانية الحالية. بعد ذلك، انقر على تم.
من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:
إضافة maio كمصدر إعلان
ضمن بطاقة العرض بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، اختَر maio.
اختَر maio وفعِّل مفتاح التبديل تحسين. أدخِل رقم تعريف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات اللذين حصلت عليهما في القسم السابق لإعداد ميزة تحسين مصدر الإعلانات في maio. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور ل maio وانقر على متابعة.
إذا كان لديك تعيين لعلامة maio، يمكنك اختياره. بخلاف ذلك، انقر على إضافة تعيين.
بعد ذلك، أدخِل رقم تعريف الوسائط ورقم تعريف المنطقة اللذين حصلت عليهما في القسم السابق. بعد ذلك، انقر على تم.
الخطوة 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.6.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
الدمج اليدوي
- نزِّل أحدث إصدار من حزمة SDK لنظام التشغيل Android من maio وأضِفه إلى مشروعك.
- انتقِل إلى عناصر محوِّل maio في مستودع Maven من Google. اختَر أحدث إصدار، ثم نزِّل ملف .aar الخاص بمحوِّل maio وأضِفه إلى مشروعك.
الخطوة 4: إضافة الرمز المطلوب
لا يلزم استخدام رمز إضافي لدمج maio مع Android.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob.
سيتلقّى الناشرون الذين يستخدمون الإصدار 11.6.0 أو إصدارًا أحدث من حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" تلقائيًا إعلانات اختبارية من maio على الهواتف والأجهزة اللوحية المسجّلة على أنّها أجهزة اختبارية عند تقديم الطلبات.
إثبات صحة الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من maio، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات maio (العرض بدون انقطاع).
رموز الخطأ
إذا تعذّر على المُحوِّل تلقّي إعلان من 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 | لم يكن السياق المستخدَم لتحميل إعلان مثيلًا لـ "نشاط". |
سجلّ التغييرات في محوِّل التوسّط في إعلانات Android من maio
الإصدار 1.1.16.3
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 23.0.0.
- تم التحقّق من التوافق مع الإصدار 1.1.16 من حزمة SDK الخاصة بمنصة maio.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 23.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
الإصدار 1.1.16.2
- تم تعديل المُحوِّل لاستخدام فئة
VersionInfo
الجديدة. - تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.0.0.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 22.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
الإصدار 1.1.16.1
- تم تعديل
compileSdkVersion
وtargetSdkVersion
إلى واجهة برمجة التطبيقات 31. - تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.0.0.
- تم تعديل الحد الأدنى المطلوب لمستوى واجهة برمجة تطبيقات Android إلى 19.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 21.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
الإصدار 1.1.16.0
- تم تعديل رموز الخطأ لتسجيل أخطاء إضافية في مايو.
- تم التحقّق من التوافق مع الإصدار 1.1.16 من حزمة SDK الخاصة بمنصة maio.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.4.0.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 20.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
الإصدار 1.1.15.0
- تم التحقّق من التوافق مع الإصدار 1.1.15 من حزمة SDK الخاصة بمنصة maio.
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.0.0.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 20.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.1.15 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
الإصدار 1.1.14.0
- تمت إضافة رموز ورسائل خطأ مُعَدَّلة للمحوِّل.
- تم التحقّق من التوافق مع الإصدار 1.1.14 من حزمة SDK الخاصة بمنصة maio.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.8.0.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 19.8.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.1.14 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
الإصدار 1.1.13.0
- تم التحقّق من التوافق مع الإصدار 1.1.13 من حزمة SDK الخاصة بمنصة maio.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.5.0.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 19.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.1.13 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
الإصدار 1.1.12.0
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.4.0.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 19.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.1.12 من حزمة SDK لنظام التشغيل Maio
الإصدار 1.1.11.1
- للحدّ من حالات انتهاء مهلة الانتظار، ستتعذّر الآن طلبات الإعلانات على الفور إذا لم يكن لدى Maia إعلان جاهز للعرض.
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.1.0.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.1.11 من حزمة SDK لنظام التشغيل Maio
الإصدار 1.1.11.0
- تم التحقّق من التوافق مع الإصدار 1.1.11 من حزمة SDK الخاصة بمنصة maio.
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.3.0.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.1.11 من حزمة SDK لنظام التشغيل Maio
الإصدار 1.1.10.0
- تم التحقّق من التوافق مع الإصدار 1.1.10 من حزمة SDK الخاصة بمنصة maio.
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.2.0.
الإصدار 1.1.8.0
- تم التحقّق من التوافق مع الإصدار 1.1.8 من حزمة SDK الخاصة بمنصة maio.
- تم تعديل الحدّ الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.1.0.
الإصدار 1.1.7.0
- إصلاح الأخطاء.
- تم التحقّق من التوافق مع الإصدار 1.1.7 من حزمة SDK الخاصة بمنصة maio.
الإصدار 1.1.6.1
- تم تعديل المحوِّل لتتوافق مع واجهة برمجة التطبيقات الجديدة لميزة "الإعلانات التي تضم مكافآت".
- تم تعديل الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 17.2.0.
الإصدار 1.1.6.0
- تم التحقّق من التوافق مع الإصدار 1.1.6 من حزمة SDK الخاصة بمنصة maio.
الإصدار 1.1.5.0
- تم التحقّق من التوافق مع الإصدار 1.1.5 من حزمة SDK الخاصة بمنصة maio.
الإصدار 1.1.4.0
- تم التحقّق من التوافق مع الإصدار 1.1.4 من حزمة تطوير البرامج (SDK) من maio.
الإصدار 1.1.3.1
- تم تعديل المحوِّل للعمل مع فئة العنصر بدلاً من العنصر الفردي.
الإصدار 1.1.3.0
- تم التحقّق من التوافق مع الإصدار 1.1.3 من حزمة SDK الخاصة بمنصة maio.
الإصدار 1.1.2.1
- تم تعديل المحوِّل باستخدام وظائف الإعداد المعدَّلة.
الإصدار 1.1.2.0
- تم التحقّق من التوافق مع الإصدار 1.1.2 من حزمة SDK الخاصة بمنصة maio.
الإصدار 1.1.1.1
- تم تعديل المُحوِّل لتشغيل حدث الإعلان
onRewardedVideoComplete()
.
الإصدار 1.1.1.0
- تم التحقّق من التوافق مع الإصدار 1.1.1 من حزمة SDK الخاصة بمنصة maio.
الإصدار 1.1.0.0
- تم التحقّق من التوافق مع الإصدار 1.1.0 من حزمة SDK الخاصة بمنصة maio.
الإصدار 1.0.8.0
- تم التحقّق من التوافق مع الإصدار 1.0.8 من حزمة SDK الخاصة بمنصة maio.
الإصدار 1.0.7.1
- تم إصلاح مشكلة يمكن أن تؤدي إلى حدوث NullPointerExceptions عند تعذُّر loading الإعلانات.
الإصدار 1.0.7.0
- تمت إضافة إمكانية تفعيل وضع الاختبار من خلال إضافة رقم تعريف الجهاز الاختباري إلى
AdRequest
. - تم التحقّق من التوافق مع الإصدار 1.0.7 من حزمة SDK الخاصة بمنصة maio.
الإصدار 1.0.6.0
- الإصدار الأول
- تمت إضافة ميزة الإعلانات البينية وإعلانات الفيديو التي تضم مكافأة.