يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض إعلانات من maio باستخدام التوسّط، التي تغطي عمليات دمج الشلال. فهو يتناول كيفية إضافة شبكة إعلانية إلى صفحة إعلان إعدادات التوسّط وكيفية دمج مهايئ وحزمة تطوير البرامج (SDK) لمنصة maio في Android التطبيق.
تستخدم واجهة لوحة المعلومات في maio النص الياباني للتسميات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة في هذا الدليل. في كل من الأوصاف والتعليمات الخاصة بهذا الدليل، تكون التسميات والأزرار المشار إليهما بمرادفاتها باللغة الإنجليزية. "URL 單元ーム," على سبيل المثال، هي "مخطط عنوان URL".
أشكال الإعلانات وعمليات الدمج المتوافقة
تتوفّر في محوّل التوسّط لنظام التشغيل maio الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
مدمجة مع المحتوى |
المتطلبات
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- الإصدار 1.0.7 من حزمة SDK لنظام التشغيل maio أو أحدث
أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
إكمال عملية التوسّط دليل البدء
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم maio
أولاً، اشترِك أو سجّل الدخول إلى حسابك في maio. انقر على زر إدارة التطبيقات في الشريط الجانبي الأيمن وانقر على تطبيق جديد.
اختَر علامة التبويب المقابلة لنوع الإعلان المفضّل لديك.
إعلان بيني
أدخِل اسم تطبيقك واختَر النظام الأساسي وأدخِل عنوان URL للتطبيق. اختَر إعلان فيديو بيني كنوع الإعلان، ثم انقر على تعديل.
تم منح المكافأة
أدخِل اسم تطبيقك واختَر النظام الأساسي وأدخِل عنوان URL للتطبيق. اختَر مكافآت الفيديو على أنّه نوع الإعلان، ثم انقر على تعديل.
في صفحة إدارة التطبيقات، دوِّن معرّف الوسائط. عليك إعداد وحدتك Ad Manager الإعلانية في القسم التالي.
في صفحة إدارة المنطقة، يمكنك تدوين رقم تعريف المنطقة. سيُطلب منك أيضًا إعداد Ad Manager وحدتك الإعلانية في القسم التالي.
بالإضافة إلى معرّف الوسائط ومعرّف المنطقة، ستحتاج إلى معرّف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات لإعداد رقم تعريف وحدتك الإعلانية للتوسّط. في صفحة Reporting API، دوِّن معرّف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات.الخطوة 2: إعداد البيانات الشخصية في واجهة مستخدم Ad Manager
ضبط إعدادات التوسّط لوحدتك الإعلانية
سجِّل الدخول إلى حسابك على "مدير الإعلانات".
انتقِل إلى عرض الإعلانات > مجموعات الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة الشبكات الإعلانية المدِرّة للأرباح جديدة.
أدخِل اسمًا فريدًا لمجموعة الشبكات الإعلانية المدِرّة للأرباح، واضبط الحالة على نشط، واختَر شكل الإعلان، واضبط نوع المستودع على تطبيق متوافق مع الأجهزة الجوّالة. ضمن قسم الاستهداف > المستودع، اختَر الوحدة الإعلانية ضمن المستودع وتطبيق الأجهزة الجوّالة التي تريد إضافة توسّط إليها.
بعد ذلك، انقر على الزر إضافة شريك أرباح.
إذا كان لديك شريك أرباح في maio، يمكنك اختياره. إذا لم يكن لديك حساب، اختَر إنشاء شريك جديد لتحقيق الأرباح.
اختَر maio باعتبارها شبكة الإعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط.
فعِّل الجمع التلقائي للبيانات، وأدخِل API ID and API KEY الذي تم الحصول عليه في القسم السابق.
بعد اختيار الشريك المحقِّق للأرباح، اختر توسّط حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وAndroid باعتبارها النظام الأساسي، ونشط كالحالة. أدخِل Media ID and Zone ID الذي تم الحصول عليه في القسم السابق. ثم أدخِل قيمة التكلفة التلقائية لكل ألف ظهور.
انقر على حفظ في أسفل الصفحة عند الانتهاء.
الخطوة 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 | السياق المستخدَم لتحميل إعلان ليس حالة "نشاط". |
سجلّ تغييرات محوّل توسّط Android من maio
الإصدار 1.1.16.3
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 23.0.0.
- تم التحقّق من التوافق مع الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) لمنصة maio.
تم التصميم والاختبار باستخدام:
- الإصدار 23.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.16 من حزمة تطوير البرامج Maio
الإصدار 1.1.16.2
- تم تعديل المحوّل لاستخدام فئة
VersionInfo
جديدة. - تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.0.0.
تم التصميم والاختبار باستخدام:
- الإصدار 22.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.16 من حزمة تطوير البرامج Maio
الإصدار 1.1.16.1
- تم تعديل
compileSdkVersion
وtargetSdkVersion
إلى واجهة برمجة التطبيقات 31. - تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 21.0.0.
- تم تعديل الحد الأدنى المطلوب لمستوى واجهة برمجة تطبيقات Android إلى 19.
تم التصميم والاختبار باستخدام:
- الإصدار 21.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.16 من حزمة تطوير البرامج Maio
الإصدار 1.1.16.0
- تم تعديل رموز الخطأ لتسجيل أخطاء maio إضافية.
- تم التحقّق من التوافق مع الإصدار 1.1.16 من حزمة تطوير البرامج (SDK) لمنصة maio.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.4.0.
تم التصميم والاختبار باستخدام:
- الإصدار 20.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.16 من حزمة تطوير البرامج Maio
الإصدار 1.1.15.0
- تم التحقّق من التوافق مع الإصدار 1.1.15 من حزمة تطوير البرامج (SDK) لمنصة maio.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 20.0.0.
تم التصميم والاختبار باستخدام:
- الإصدار 20.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.15 من حزمة تطوير البرامج Maio
الإصدار 1.1.14.0
- تمت إضافة رموز ورسائل خطأ المحوّل الموحّد.
- تم التحقّق من التوافق مع الإصدار 1.1.14 من حزمة تطوير البرامج (SDK) لمنصة maio.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.8.0.
تم التصميم والاختبار باستخدام:
- الإصدار 19.8.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.14 من حزمة تطوير البرامج Maio
الإصدار 1.1.13.0
- تم التحقّق من التوافق مع الإصدار 1.1.13 من حزمة تطوير البرامج (SDK) لمنصة maio.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.5.0.
تم التصميم والاختبار باستخدام:
- الإصدار 19.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.13 من حزمة تطوير البرامج Maio
الإصدار 1.1.12.0
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.4.0.
تم التصميم والاختبار باستخدام:
- الإصدار 19.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.12 من حزمة تطوير البرامج Maio
الإصدار 1.1.11.1
- للحد من القوالب، ستفشل طلبات الإعلان الآن على الفور إذا لم يكن لدى maio إعلان جاهز للعرض.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.1.0.
تم التصميم والاختبار باستخدام:
- الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.11 من حزمة تطوير البرامج Maio
الإصدار 1.1.11.0
- تم التحقّق من التوافق مع الإصدار 1.1.11 من حزمة تطوير البرامج (SDK) لمنصة maio.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.3.0.
تم التصميم والاختبار باستخدام:
- الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.11 من حزمة تطوير البرامج 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
- تم تحديث المحوّل لإتاحة استخدام واجهة برمجة التطبيقات Awarded API الجديدة.
- تم تحديث الحد الأدنى المطلوب لإصدار حزمة "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 عند تعذُّر الإعلانات للتحميل.
الإصدار 1.0.7.0
- تمت إضافة إمكانية تفعيل وضع الاختبار من خلال إضافة رقم تعريف جهاز الاختبار إلى
AdRequest
. - تم التحقّق من التوافق مع الإصدار 1.0.7 من حزمة تطوير البرامج (SDK) لمنصة maio.
الإصدار 1.0.6.0
- الإصدار الأول!
- تمت إضافة دعم للإعلانات البينية وإعلانات الفيديو التي تضم مكافأة.