دمج شبكة Maio مع ميزة التوسّط

يوضّح لك هذا الدليل كيفية استخدام "حزمة 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 للتطبيق. اختَر إعلان بيني في الفيديو كـ نوع الإعلان، ثمّ انقر على تعديل.

ملاحظة: تكون الإعلانات البينية من maio قابلة للتخطّي تلقائيًا.

تم منح المكافأة

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

ملاحظة: إعلانات الفيديو التي تضم مكافآت من maio لا يمكن تخطّيها تلقائيًا.

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

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

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

ملاحظة: إذا كانت هذه هي المرة الأولى التي تُنشئ فيها حسابك على maio، قد تحتاج إلى التواصل مع فريق دعم maio للحصول على رقم تعريف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات.

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

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

عليك إضافة maio إلى إعداد التوسّط لوحدتك الإعلانية.

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

لإنشاء مجموعة توسّط جديدة، اختَر إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصّة، ثمّ انقر على متابعة.

أدخِل اسمًا لمجموعة التوسّط، واختَر مواقع جغرافية لاستهدافها. بعد ذلك، اضبط حالة مجموعة التوسّط على مفعَّلة، ثمّ انقر على إضافة وحدات إعلانية.

اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية AdMob الحالية. بعد ذلك، انقر على تمّ.

من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية التي تمت تعبئتها بالوحدات الإعلانية التي حدّدتها:

إضافة maio كمصدر إعلان

ضمن بطاقة منهجية الشلال في قسم مصادر الإعلانات، اختَر إضافة مصدر الإعلان. بعد ذلك، اختَر maio.

اختَر maio وفعِّل مفتاح تبديل تحسين. أدخِل API ID and API KEY الذي تم الحصول عليه في القسم السابق من أجل إعداد تحسين مصدر الإعلان للحملة maio. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور للسمةmaio وانقر على متابعة.

ملاحظة: عليك إعداد تحسين مصدر الإعلان مرة واحدة فقط لكل شبكة.

إذا كان لديك تعيين بالفعل لـ maio، يمكنك تحديده. بخلاف ذلك، انقر على إضافة تعيين.

بعد ذلك، أدخِل Media ID and Zone ID التي تم الحصول عليها في القسم السابق. بعد ذلك، انقر على تمّ.

ملاحظة مهمة: يجب Media ID ربط التطبيق المستهدَف بالتطبيق كما هو الحال في maio واجهة المستخدم.

ملاحظة: يستغرق تحسين مصدر الإعلانات بضعة أيام لجمع بيانات كافية من أجل احتساب التكلفة الفعلية لكل ألف ظهور بشكل دقيق لشبكة التوسّط. في الوقت الحالي، حالة تحسين مصدر الإعلان هي PENDING، لذا يجب تحديد قيمة التكلفة الفعلية لكل ألف ظهور للشبكة يدويًا. بعد احتساب التكلفة الفعلية لكلّ ألف ظهور، يبدأ مصدر الإعلان تلقائيًا في تعديل التكلفة الفعلية لكلّ ألف ظهور نيابةً عنك.

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

ملاحظة: قد يؤدي عدم دمج الإصدارات المتوافقة مع حزمة maio وSDK لإعلانات Google على الأجهزة الجوّالة إلى حدوث مشاكل في الإصدار.

دمج "استوديو 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.5.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 على الهواتف والأجهزة اللوحية المسجّلة على أنّها أجهزة اختبارية عند تقديم الطلبات.

ملاحظة مهمة: أوقِف وضع الاختبار في AdMob وشبكة معيّنة قبل إصدار التطبيق.

إثبات صحة الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من شبكة 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. يمكنك الاطّلاع على مستندات code وmaio لمزيد من التفاصيل.
101	لا يتوفّر إعلان لـ "مايو".
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

• للحد من القوالب، ستفشل طلبات الإعلان الآن على الفور إذا لم يكن لدى maio إعلان جاهز للعرض.
• تم تعديل الحد الأدنى المطلوب لإصدار حزمة "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

• الإصدار الأول
• تمت إضافة ميزة الإعلانات البينية وإعلانات الفيديو التي تضم مكافأة.