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

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

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

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

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

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

المتطلبات

• Unity 4 أو إصدار أحدث
• أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
• للنشر على Android
  • المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
• للنشر على iOS
  • الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
• مشروع Unity قيد التشغيل تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". عرض البدء لمعرفة التفاصيل.
• إكمال عملية التوسّط دليل البدء

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

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

اختَر علامة التبويب المقابلة لنوع الإعلان المفضّل لديك.

إعلان بيني

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

Android

iOS

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

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

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

Android

iOS

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

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

Android

iOS

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

Android

iOS

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

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

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

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

Android

للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

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

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

تنزيل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في شبكة الجوّال من رابط التنزيل في سجلّ التغييرات بالنسبة إلى مايو واستخراج GoogleMobileAdsMaioMediation.unitypackage من ملف ZIP.

في محرِّر مشروعات Unity، اختَر مواد العرض >. استيراد الحزمة > مخصَّص الحزمة والعثور على ملف GoogleMobileAdsMaioMediation.unitypackage الذي تريد تم تنزيله. تأكَّد من اختيار كل الملفات وانقر على استيراد.

بعد ذلك، اختَر مواد العرض >. محلل خدمات Play > محلل Android > فرض الحل. ستنفّذ مكتبة محلل خدمات Unity Play Services تحليل التبعية من البداية ونسخ التبعيات المعلنة إلى الدليل Assets/Plugins/Android لتطبيق Unity

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

Android

ولن يُطلب منك استخدام رمز إضافي لدمج شبكة maio.

iOS

دمج SKAdNetwork

متابعة مستندات maio لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

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

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

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

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

ملاحظة مهمة: يجب إيقاف وضع الاختبار لـ AdMob و maio قبل إصدار تطبيقك.

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

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

رموز الخطأ

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

Android

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

iOS

التنسيق	اسم الصف
إعلان بيني	GADMMaioInterstitialAdapter
تم منح المكافأة	GADMMaioRewardedAdapter

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

Android

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

iOS

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

سجلّ تغييرات المكوّن الإضافي لتوسّط Unity في maio

الإصدار 2.0.3

• يتوافق مع الإصدار 1.1.16.3 من محوّل نظام التشغيل maio.
• يتوافق مع الإصدار 2.1.5.0 من محوّل maio iOS.
• تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 2.0.2

• يتوافق مع الإصدار 1.1.16.3 من محوّل نظام التشغيل maio.
• يتوافق مع الإصدار 2.1.4.0 من محوّل maio iOS.
• تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 2.0.1

• يتوافق مع الإصدار 1.1.16.2 من محوّل Android maio.
• يتوافق مع الإصدار 2.1.3.0 من محوّل maio iOS.
• تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 2.0.0

• يتوافق مع الإصدار 1.1.16.2 من محوّل Android maio.
• يتوافق مع الإصدار 2.1.1.0 من محوّل maio iOS.
• تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.6.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.4.3

• تم نقل محتوى المحوّل إلى GoogleMobileAds/Mediation/Maio/.
• يتوافق مع الإصدار 1.1.16.2 من محوّل Android maio.
• يتوافق مع الإصدار 1.6.3.1 من محوّل maio iOS.
• تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.4.2

• يتوافق مع الإصدار 1.1.16.1 من محوّل نظام التشغيل maio.
• يتوافق مع الإصدار 1.6.3.0 من محوّل maio iOS.
• تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.4.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.4.1

• يتوافق مع الإصدار 1.1.16.1 من محوّل نظام التشغيل maio.
• يتوافق مع الإصدار 1.6.2.0 من محوّل maio iOS.
• تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.4.0

• يتوافق مع الإصدار 1.1.16.0 من مهايئ Android maio.
• يتوافق مع الإصدار 1.6.0.1 من محوّل maio iOS.
• تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.3.6

• يتوافق مع الإصدار 1.1.16.0 من مهايئ Android maio.
• يتوافق مع الإصدار 1.5.8.0 من محوّل maio iOS.

الإصدار 1.3.5

• يتوافق مع الإصدار 1.1.15.0 من محوّل Android maio.
• يتوافق مع الإصدار 1.5.6.1 من محوّل maio iOS.

الإصدار 1.3.4

• يتوافق مع الإصدار 1.1.11.1 من محوّل نظام التشغيل maio.
• يتوافق مع الإصدار 1.5.4.0 من محوّل maio iOS.

الإصدار 1.3.3

• يتوافق مع الإصدار 1.1.11.1 من محوّل نظام التشغيل maio.
• يتوافق مع الإصدار 1.5.3.1 من محوّل maio iOS.

الإصدار 1.3.2

• يتوافق مع الإصدار 1.1.11.0 من محول Android maio.
• يتوافق مع الإصدار 1.5.2.1 من محوّل maio iOS.

الإصدار 1.3.1

• يتوافق مع الإصدار 1.1.10.0 من محوّل نظام التشغيل maio.
• يتوافق مع الإصدار 1.5.1.0 من محوّل maio iOS.

الإصدار 1.3.0

• يتوافق مع الإصدار 1.1.10.0 من محوّل نظام التشغيل maio.
• يتوافق مع الإصدار 1.5.0.0 من محوّل maio iOS.

الإصدار 1.2.3

• تم تحديث المكوّن الإضافي لإتاحة Bonus API الجديدة.
• يتوافق مع الإصدار 1.1.7.0 من محول Android maio.
• يتوافق مع الإصدار 1.4.6.0 من محوّل iOS الذي يعمل بنظام التشغيل maio.

الإصدار 1.2.2

• يتوافق مع الإصدار 1.1.6.0 من محول Android maio.
• يتوافق مع الإصدار 1.4.2.0 من محوّل maio iOS.

الإصدار 1.2.1

• يتوافق مع الإصدار 1.1.6.0 من محول Android maio.
• يتوافق مع الإصدار 1.4.1.0 من محوّل iOS الذي يعمل بنظام التشغيل maio.

الإصدار 1.2.0

• يتوافق مع الإصدار 1.1.4.1 من محول Android maio.
• يتوافق مع الإصدار 1.4.0.0 من محوّل iOS الذي يعمل بنظام التشغيل maio.

الإصدار 1.1.3

• يتوافق مع الإصدار 1.1.3.1 من محول Android maio.
• يتوافق مع الإصدار 1.3.2.0 من محوّل maio iOS.

الإصدار 1.1.2

• يتوافق مع الإصدار 1.1.3.0 من محول Android maio.
• يتوافق مع الإصدار 1.3.2.0 من محوّل maio iOS.

الإصدار 1.1.1

• يتوافق مع الإصدار 1.1.1.0 من محول Android maio.
• يتوافق مع الإصدار 1.3.1.1 من محوّل iOS الذي يعمل بنظام التشغيل maio.

الإصدار 1.1.0

• يتوافق مع الإصدار 1.1.0.0 من محول Android maio.
• يتوافق مع الإصدار 1.3.0.0 من محوّل iOS الذي يعمل بنظام التشغيل maio.

الإصدار 1.0.2

• يتوافق مع الإصدار 1.0.8 من حزمة تطوير البرامج (SDK) لنظام التشغيل maio.
• يتوافق مع الإصدار 1.2.19 من حزمة تطوير البرامج لنظام التشغيل iOS من maio.

الإصدار 1.0.1

• يتوافق مع الإصدار 1.0.7 من حزمة تطوير البرامج (SDK) لنظام التشغيل maio.
• يتوافق مع الإصدار 1.2.19 من حزمة تطوير البرامج لنظام التشغيل iOS من maio.

الإصدار 1.0.0

• الإصدار الأول!
• يتوافق مع الإصدار 1.0.6 من حزمة تطوير البرامج (SDK) لنظام التشغيل maio.
• يتوافق مع الإصدار 1.2.18 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من maio.