يوضِّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات وعرضها من شبكة maio باستخدام التوسّط، وتغطي عمليات دمج العرض الإعلاني بدون انقطاع. كما يتناول كيفية إضافة بروتوكول maio إلى إعدادات التوسّط في وحدة إعلانية، وكيفية دمج المحوّل وحزمة تطوير البرامج maio في أحدAndroid التطبيقات.
تستخدم واجهة لوحة المعلومات في maio النص الياباني للتسميات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة في هذا الدليل. في المقابل، في أوصاف هذا الدليل وإرشاداته، تتم الإشارة إلى التسميات والأزرار بما يعادلها باللغة الإنجليزية. على سبيل المثال، "عنوان URL شكرًا ーム" يشير إلى "مخطط عنوان URL"، وما إلى ذلك.
عمليات الدمج وأشكال الإعلانات المتوافقة
ويمتاز Ad Manager محوِّل التوسط لنظام maio بالإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
مدمجة مع المحتوى |
المتطلّبات
- المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android
- إصدار maio SDK 1.0.7 أو إصدار أحدث
أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
إكمال عملية التوسّط دليل البدء
الخطوة 1: ضبط الإعدادات في واجهة مستخدم maio
أولاً، اشترِك أو سجّل الدخول إلى حسابك في maio. انقر على زر إدارة التطبيقات في الشريط الجانبي الأيمن وانقر على تطبيق جديد.
اختَر علامة التبويب المقابلة لنوع الإعلان المفضّل لديك.
إعلان بيني
أدخِل اسم تطبيقك واختَر النظام الأساسي وأدخِل عنوان URL للتطبيق. اختَر إعلان فيديو بيني كنوع الإعلان، ثم انقر على تعديل.
تم منح المكافأة
أدخِل اسم تطبيقك واختَر النظام الأساسي وأدخِل عنوان URL للتطبيق. اختَر مكافآت الفيديو على أنّه نوع الإعلان، ثم انقر على تعديل.
في صفحة إدارة التطبيقات، دوِّن معرّف الوسائط. عليك إعداد وحدتك Ad Manager الإعلانية في القسم التالي.
في صفحة إدارة المنطقة، يمكنك تدوين رقم تعريف المنطقة. سيُطلب منك أيضًا إعداد Ad Manager وحدتك الإعلانية في القسم التالي.
بالإضافة إلى معرّف الوسائط ومعرّف المنطقة، ستحتاج إلى معرّف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات لإعداد رقم تعريف وحدتك الإعلانية للتوسّط. في صفحة Reporting API، دوِّن معرّف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات.الخطوة 2: إعداد الطلب في شبكة maio في 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
على مستوى التطبيق، أضِف
تبعيات التنفيذ وإعداداته التالية. استخدم أحدث إصدارات من حزمة
maio SDK والمحوّل:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:maio:1.1.16.2")
}
الدمج اليدوي
- نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) لنظام التشغيل Android في maio وأضِفه إلى مشروعك.
- انتقِل إلى عناصر محوّل 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. يمكنك الاطّلاع على code ووثائق في maio لمعرفة المزيد من التفاصيل. |
101 | لا يتوفّر إعلان في Maio. |
102 | معلمات خادم غير صالحة (على سبيل المثال، رقم تعريف موضع الإعلان غير موجود). |
103 | السياق المستخدَم لتحميل إعلان لم يكن مثيلاً لـ "النشاط". |
0-10 | عرضت maio خطأ متعلقًا بحزمة SDK. يمكنك الاطّلاع على الرمز البرمجي لـ maio للحصول على مزيد من التفاصيل. |
101 | لا يتوفّر إعلان في maio بعد. |
102 | معلمات خادم غير صالحة (على سبيل المثال، رقم تعريف موضع الإعلان غير موجود). |
103 | محوّل maio غير متوافق مع شكل الإعلان المطلوب. |
104 | سبق أن تم تحميل إعلان لإعداد الشبكة هذه. |
سجلّ تغييرات مهايئ توسّط Android في شبكة maio
الإصدار التالي
- تم تحديث الحد الأدنى المطلوب لإصدار "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 22.4.0.
الإصدار 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
- تم تعديل رموز الأخطاء لتسجيل أخطاء إضافية في شبكة maio.
- تم التحقّق من التوافق مع الإصدار 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 من حزمة maio SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار "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 من حزمة maio SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار "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
- للحدّ من الفواصل، ستتعذّر الآن طلبات الإعلان فورًا في حال لم يكن لدى شبكة maio إعلان جاهز للعرض.
- تم تحديث الحد الأدنى المطلوب لإصدار "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 19.1.0.
تم إنشاء التجربة واختبارها باستخدام:
- الإصدار 19.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.11 من حزمة تطوير البرامج (SDK) في Maio
الإصدار 1.1.11.0
- تم التحقّق من التوافق مع الإصدار 1.1.11 من حزمة maio SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.3.0.
تم إنشاء التجربة واختبارها باستخدام:
- الإصدار 18.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- الإصدار 1.1.11 من حزمة تطوير البرامج (SDK) في Maio
الإصدار 1.1.10.0
- تم التحقق من التوافق مع الإصدار 1.1.10 من حزمة maio SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.2.0.
الإصدار 1.1.8.0
- تم التحقّق من التوافق مع الإصدار 1.1.8 من حزمة maio SDK.
- تم تحديث الحد الأدنى المطلوب لإصدار "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 18.1.0.
الإصدار 1.1.7.0
- إصلاح الأخطاء.
- تم التحقّق من التوافق مع الإصدار 1.1.7 من حزمة maio SDK.
الإصدار 1.1.6.1
- تم تعديل المحوّل ليتوافق مع واجهة برمجة التطبيقات الجديدة التي تضمّ مكافأة.
- تم تحديث الحد الأدنى المطلوب لإصدار "SDK لإعلانات Google على الأجهزة الجوّالة" إلى 17.2.0.
الإصدار 1.1.6.0
- تم التحقّق من التوافق مع الإصدار 1.1.6 من حزمة maio SDK.
الإصدار 1.1.5.0
- تم التحقّق من التوافق مع الإصدار 1.1.5 من حزمة maio SDK.
الإصدار 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 من حزمة maio SDK.
الإصدار 1.1.1.1
- تم تعديل المحوّل لاستدعاء حدث الإعلان "
onRewardedVideoComplete()
".
الإصدار 1.1.1.0
- تم التحقق من التوافق مع الإصدار 1.1.1 من حزمة maio SDK.
الإصدار 1.1.0.0
- تم التحقق من التوافق مع الإصدار 1.1.0 من حزمة maio SDK.
الإصدار 1.0.8.0
- تم التحقّق من التوافق مع الإصدار 1.0.8 من حزمة maio SDK.
الإصدار 1.0.7.1
- تم إصلاح مشكلة يمكن أن تتسبب في حدوث NullPointerExceptions عند تعذُّر تحميل الإعلانات.
الإصدار 1.0.7.0
- تمت إضافة إمكانية تفعيل وضع الاختبار عن طريق إضافة رقم تعريف جهاز الاختبار إلى
AdRequest
. - تم التحقّق من التوافق مع الإصدار 1.0.7 من حزمة maio SDK.
الإصدار 1.0.6.0
- الإصدار الأول
- تم توفير دعم إضافي للإعلانات البينية وإعلانات الفيديو التي تضم مكافأة.