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

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

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

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

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

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

المتطلبات

  • إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

  • إكمال التوسّط دليل البدء

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

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

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

إعلان بيني

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

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

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

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

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

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

الخطوة 2: إعداد طلب مايو في Ad Manager واجهة المستخدِم

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

  • أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:

    pod 'GoogleMobileAdsMediationMaio'

  • من سطر الأوامر، شغِّل:

    pod install --repo-update

الدمج اليدوي

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

دمج SKAdNetwork

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

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

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

تأكَّد من تسجيل جهازك الاختباري في AdMob.

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

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

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

رموز الخطأ

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

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

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

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

سجلّ التغييرات في محوِّل التوسّط في maio لنظام التشغيل iOS

الإصدار 2.1.5.1

  • تم تعديل CFBundleShortVersionString ليصبح يتضمّن ثلاثة مكوّنات بدلاً من أربعة.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 11.10.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.1.5 من حزمة تطوير البرامج Maio

الإصدار 2.1.5.0

  • تم التحقّق من التوافق مع الإصدار 2.1.5 من حزمة SDK الخاصة بمنصة maio.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 11.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.1.5 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 2.1.4.0

  • تم التحقّق من التوافق مع الإصدار 2.1.4 من حزمة SDK الخاصة بمنصة maio.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 11.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.1.4 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 2.1.3.0

  • تم التحقّق من التوافق مع الإصدار 2.1.3 من حزمة SDK الخاصة بمنصة maio.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 11.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 2.1.3 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 2.1.2.1

  • تتطلب الآن الإصدار 11.0 أو إصدار أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • تم تضمين Info.plist في الأطر ضمن MaioAdapter.xcframework.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 11.0.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.1.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 2.1.2.0

  • تم التحقّق من التوافق مع الإصدار 2.1.2 من حزمة SDK الخاصة بمنصة maio.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 10.14.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.1.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 2.1.1.0

  • تم التحقّق من التوافق مع الإصدار 2.1.1 من حزمة تطوير البرامج (SDK) لمنصة maio.

تم التصميم والاختبار باستخدام:

  • الإصدار 10.12.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.1.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 2.0.0.0

  • تم التحقّق من التوافق مع الإصدار 2.0.0 من حزمة تطوير البرامج (SDK) لمنصة maio.
  • تمت إزالة الاعتمادية على MaioOB SDK.
  • تمت إزالة التوافق مع بنية armv7.
  • يتطلب الآن الحد الأدنى لإصدار iOS 12.0.
  • تتطلب الآن الإصدار 10.4.0 أو إصدار أحدث من "SDK لإعلانات Google على الأجهزة الجوّالة".

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 10.10.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 2.0.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 1.6.3.1

  • تتطلب الآن حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، الإصدار 10.0.0 أو إصدار أحدث.

تم التصميم والاختبار باستخدام:

  • الإصدار 10.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 1.6.3 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
  • الإصدار 2.0.0-alpha من حزمة تطوير البرامج (SDK) لبرنامج MaioOB

الإصدار 1.6.3.0

  • تم تعديل المحوِّل لاستخدام واجهة برمجة التطبيقات didRewardUser.
  • يتطلب الآن استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الإصدار 9.8.0 أو إصدار أحدث.
  • تم التحقّق من التوافق مع الإصدار 1.6.3 من حزمة تطوير البرامج (SDK) maio وحزمة تطوير البرامج (SDK) maioOB الإصدار 2.0.0-alpha.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 9.12.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.6.3 من حزمة تطوير البرامج Maio
  • الإصدار 2.0.0-alpha من حزمة MaioOB SDK

الإصدار 1.6.2.0

  • تم التحقّق من التوافق مع الإصدار 1.6.2 من حزمة SDK الخاصة بمنصة maio والإصدار 2.0.0-alpha من حزمة SDK الخاصة بمنصة maioOB.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 9.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.6.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
  • الإصدار 2.0.0-alpha من حزمة تطوير البرامج (SDK) لبرنامج MaioOB

الإصدار 1.6.1.0

  • تم التحقّق من التوافق مع الإصدار 1.6.1 من حزمة SDK الخاصة بمنصة maio والإصدار 2.0.0-alpha من حزمة SDK الخاصة بمنصة maioOB.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 9.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 1.6.1 من حزمة تطوير البرامج Maio
  • الإصدار 2.0.0-alpha من حزمة تطوير البرامج (SDK) لبرنامج MaioOB

الإصدار 1.6.0.1

  • تم التحقّق من التوافق مع الإصدار 9.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • تتطلب الآن الإصدار 9.0.0 أو إصدار أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 9.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
  • الإصدار 1.6.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
  • الإصدار 2.0.0-alpha من حزمة تطوير البرامج (SDK) لبرنامج MaioOB

الإصدار 1.6.0.0

  • تم التحقّق من التوافق مع الإصدار 1.6.0 من حزمة SDK الخاصة بمنصة maio والإصدار 2.0.0-alpha من حزمة SDK الخاصة بمنصة maioOB.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 8.13.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • يتطلب الآن الحد الأدنى لإصدار iOS هو 10.0.
  • الإصدار 1.6.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
  • الإصدار 2.0.0-alpha من حزمة تطوير البرامج (SDK) لبرنامج MaioOB

الإصدار 1.5.8.0

  • تم التحقّق من التوافق مع الإصدار 1.5.8 من حزمة SDK الخاصة بمنصة maio والإصدار 2.0.0-alpha من حزمة SDK الخاصة بمنصة maioOB.
  • تمت إضافة ميزة عروض الأسعار إلى المحوِّل لأشكال الإعلانات البينية والإعلانات التي تضم مكافآت.
  • تم تخفيف الاعتماد على الإصدار 8.0.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 8.7.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.5.8 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
  • الإصدار 2.0.0-alpha من حزمة MaioOB SDK

الإصدار 1.5.6.1

  • تمت إضافة رموز ورسائل خطأ المحوّل الموحّد.
  • تم تعديل المحوِّل لاستخدام التنسيق .xcframework.
  • تم إصلاح خطأ عدم توجيه أحداث الإعلانات التي تضم مكافأة في بعض الأحيان.
  • تتطلب الآن الإصدار 8.3.0 أو إصدار أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 8.3.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.5.6 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 1.5.6.0

  • تم التحقّق من التوافق مع الإصدار 1.5.6 من حزمة تطوير البرامج (SDK) لمنصة maio.
  • تتطلب الآن الإصدار 7.68.0 أو إصدار أحدث من حزمة تطوير برامج "SDK لإعلانات Google على الأجهزة الجوّالة".

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 7.68.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.5.6 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 1.5.5.0

  • تم التحقّق من التوافق مع الإصدار 1.5.5 من حزمة SDK الخاصة بمنصة maio.
  • تتطلب الآن الإصدار 7.64.0 أو إصدار أحدث من حزمة SDK لإعلانات Google على الأجهزة الجوّالة.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 7.64.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.5.5 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 1.5.4.0

  • تم التحقّق من التوافق مع الإصدار 1.5.4 من حزمة تطوير البرامج (SDK) من maio.
  • تتطلّب الآن حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الإصدار 7.60.0 أو إصدار أحدث.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 7.60.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.5.4 من حزمة تطوير البرامج Maio

الإصدار 1.5.3.1

  • للحدّ من حالات انتهاء مهلة الانتظار، ستتعذّر الآن طلبات الإعلانات على الفور إذا لم يكن لدى Maia إعلان جاهز للعرض.
  • تمت إزالة التوافق مع بنية i386.

تم التصميم والاختبار باستخدام:

  • الإصدار 7.58.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.5.3 من حزمة تطوير البرامج Maio

الإصدار 1.5.3.0

  • تم التحقّق من التوافق مع الإصدار 1.5.3 من حزمة SDK الخاصة بمنصة maio.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 7.55.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.5.3 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 1.5.2.1

  • تم إصلاح مشكلة عدم استدعاء المكوّن الإضافي لطريقة الاستدعاء -rewardedAdDidPresent:.

تم التصميم والاختبار باستخدام:

  • الإصدار 7.53.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.5.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 1.5.2.0

  • تم التحقّق من التوافق مع الإصدار 1.5.2 من حزمة SDK الخاصة بمنصة maio.

تم التصميم والاختبار باستخدام:

  • الإصدار 7.53.1 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.5.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio

الإصدار 1.5.1.0

  • تم التحقّق من التوافق مع الإصدار 1.5.1 من حزمة تطوير البرامج (SDK) لمنصة maio.

تمّ تصميمها واختبارها باستخدام:

  • الإصدار 7.52.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.5.1 من حزمة تطوير البرامج Maio

الإصدار 1.5.0.0

  • تم التحقّق من التوافق مع الإصدار 1.5.0 من حزمة تطوير البرامج (SDK) لمنصة maio.

تم إنشاؤها واختبارها باستخدام

  • الإصدار 7.51.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.5.0 من حزمة تطوير البرامج (SDK) لعرض الإعلانات Maio

الإصدار 1.4.8.0

  • تم التحقّق من التوافق مع الإصدار 1.4.8 من حزمة تطوير البرامج (SDK) من maio.

الإصدار 1.4.6.0

  • تم التحقّق من التوافق مع الإصدار 1.4.6 من حزمة تطوير البرامج (SDK) لمنصة maio.
  • تم تعديل المحوِّل لاستخدام واجهة برمجة التطبيقات الجديدة لنظام المكافآت.
  • تتطلّب الآن حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" الإصدار 7.42.2 أو إصدارًا أحدث.

الإصدار 1.4.2.0

  • تم التحقّق من التوافق مع الإصدار 1.4.2 من حزمة تطوير البرامج (SDK) لمنصة maio.

الإصدار 1.4.1.0

  • تم التحقّق من التوافق مع الإصدار 1.4.1 من حزمة تطوير البرامج (SDK) من maio.
  • تم إصلاح مشكلة قد تؤدي إلى تعذُّر استخدام محوِّل maio في حال توفُّر أرقام MediaId متعددة من AdMob.

الإصدار 1.4.0.0

  • تم التحقّق من التوافق مع الإصدار 1.4.0 من حزمة SDK الخاصة بمنصة maio.

الإصدار 1.3.2.0

  • تم التحقّق من التوافق مع الإصدار 1.3.2 من حزمة SDK الخاصة بمنصة maio.

الإصدار 1.3.1.1

  • تمت إضافة طلب إعادة الاتصال adapterDidCompletePlayingRewardBasedVideoAd: إلى المحوِّل.

الإصدار 1.3.1.0

  • تم التحقّق من التوافق مع الإصدار 1.3.1 من حزمة تطوير البرامج (SDK) من maio.

الإصدار 1.3.0.0

  • تم التحقّق من التوافق مع الإصدار 1.3.0 من حزمة SDK الخاصة بمنصة maio.

الإصدار 1.2.19.0

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

الإصدار 1.2.18.0

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