يوضّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" لتحميل الإعلانات من maio وعرضها باستخدام التوسّط، ويتناول عمليات دمج الإعلانات بدون انقطاع. ويتناول هذا الدليل كيفية إضافة maio إلى إعدادات التوسّط لوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) وبرنامج التتبُّع في maio في أحد تطبيقات iOS.
تستخدم واجهة لوحة بيانات maio النص الياباني في التصنيفات والأزرار والأوصاف، ولم تتم ترجمة لقطات الشاشة الواردة في هذا الدليل. في أوصاف هذا الدليل وتعليماته، تتم الإشارة إلى التصنيفات والأزرار باستخدام نظائرها باللغة الإنجليزية. على سبيل المثال، "URL スキーム" يعني "مخطّط URL".
عمليات الدمج وأشكال الإعلانات المتوافقة
تتوفر للمحوِّل التوسّط في maio الإمكانات التالية:
التكامل | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
مدمجة مع المحتوى |
المتطلبات
- إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
إكمال التوسّط دليل البدء
الخطوة 1: إعداد الإعدادات في واجهة مستخدم maio
أولاً، عليك الاشتراك أو تسجيل الدخول إلى حسابك على maio. انقر على زر إدارة التطبيقات في الشريط الجانبي الأيمن، ثم انقر على تطبيق جديد.
اختَر علامة التبويب التي تتوافق مع نوع الإعلان المفضّل لديك.
إعلان بيني
أدخِل اسم تطبيقك، واختَر النظام الأساسي وقدِّم عنوان URL للتطبيق. اختَر إعلان بيني في الفيديو كـ نوع الإعلان، ثمّ انقر على تعديل.
تم منح المكافأة
أدخِل اسم تطبيقك، واختَر النظام الأساسي وقدِّم عنوان URL للتطبيق. اختَر المكافآت في الفيديو كـ نوع الإعلان، ثم انقر على تعديل.
في صفحة إدارة التطبيقات، دوِّن معرّف الوسائط. يجب إعداد وحدتك الإعلانية في "مدير إعلانات Google" في القسم التالي.
في صفحة إدارة المنطقة، دوِّن رقم تعريف المنطقة. سيكون مطلوبًا أيضًا إعداد وحدتك الإعلانية في "مدير إعلانات Google" في القسم التالي.
(العرض الإعلاني بدون انقطاع فقط) بالإضافة إلى معرّف الوسائط ومعرّف المنطقة، ستحتاج إلى معرّف واجهة برمجة التطبيقات و مفتاح واجهة برمجة التطبيقات لإعداد رقم تعريف الوحدة الإعلانية للتوسّط. في صفحة Reporting API، دوِّن معرّف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات.الخطوة 2: إعداد الطلب في واجهة مستخدِم "مدير إعلانات Google"
ضبط إعدادات التوسّط لوحدتك الإعلانية
سجِّل الدخول إلى حسابك على "مدير إعلانات Google".
انتقِل إلى العرض > مجموعات الأرباح وانقر على الزر مجموعة أرباح جديدة.
أدخِل اسمًا فريدًا لمجموعة الأرباح، واضبط الحالة على نشط، واختَر تنسيق الإعلان، واضبط نوع المستودع على تطبيق جوّال. ضمن قسم الاستهداف > المستودع، اختَر الوحدة الإعلانية ضمن المستودع والتطبيق المتوافق مع الأجهزة الجوّالة الذي تريد إضافة التوسّط إليه.
بعد ذلك، انقر على الزر إضافة شريك عائد.
إذا كان لديك شريك تحقيق الربح في maio، يمكنك اختياره. بخلاف ذلك، اختَر إنشاء شريك أرباح جديد.
اختَر maio باعتبارها شبكة المواقع الإعلانية، وأدخِل اسمًا فريدًا وفعِّل التوسّط.
فعِّل جمع البيانات التلقائي، وأدخِل معرّف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات اللذين حصلت عليهما في القسم السابق.
بعد اختيار شريك الأرباح، اختَر توسّط حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كنوع الدمج وiOS كالنظام الأساسي ونشط كالحالة. أدخِل معرّف الوسائط ومعرّف المنطقة اللذَين حصلت عليهما في القسم السابق. بعد ذلك، أدخِل قيمة تكلفة ألف ظهور تلقائية.
انقر على حفظ في أسفل الصفحة عند الانتهاء.
الخطوة 3: استيراد حزمة SDK ومحوِّل maio
استخدام CocoaPods (إجراء يُنصح به)
أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:
pod 'GoogleMobileAdsMediationMaio'
من سطر الأوامر، شغِّل:
pod install --repo-update
الدمج اليدوي
- نزِّل أحدث إصدار من حزمة SDK الخاصة بمنصة maiO.
- نزِّل أحدث إصدار من محوِّل maio من رابط التنزيل في
سجلّ التغييرات،
ثم أدخِل الرابط
maioAdapter.framework
في مشروعك.
الخطوة 4: إضافة الرمز المطلوب
دمج SKAdNetwork
اتّبِع مستندات maio
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist
في مشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك التجريبي في "مدير إعلانات Google".
سيتلقّى الناشرون الذين يستخدمون الإصدار 7.26.0 أو إصدارًا أحدث من "مجموعة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" تلقائيًا إعلانات اختبارية من maio على الهواتف والأجهزة اللوحية المسجّلة على أنّها أجهزة اختبارية عند تقديم الطلبات.
إثبات صحة الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من maio، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات maio (العرض بدون انقطاع).
رموز الخطأ
إذا تعذّر على المُحوِّل تلقّي إعلان من maio،
يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام
GADResponseInfo.adNetworkInfoArray
ضمن الفئات التالية:
التنسيق | اسم الصف |
---|---|
إعلان بيني | GADMMaioInterstitialAdapter |
تم منح المكافأة | GADMMaioRewardedAdapter |
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل maio عند تعذُّر تحميل إعلان:
رمز الخطأ | السبب |
---|---|
0-10 | عرَضَ maio خطأً خاصًا بحزمة تطوير البرامج (SDK). اطّلِع على رمز ماييو للحصول على مزيد من التفاصيل. |
101 | لا يتوفّر إعلان في maio بعد. |
102 | مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف موضع الإعلان) |
103 | لا يتيح محوِّل maio استخدام تنسيق الإعلان المطلوب. |
104 | سبق أن تم تحميل إعلان لإعدادات الشبكة هذه. |
سجلّ التغييرات في محوِّل التوسّط في maio لنظام التشغيل iOS
الإصدار 2.1.5.1
- تم تعديل
CFBundleShortVersionString
ليصبح يتضمّن ثلاثة مكوّنات بدلاً من أربعة.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 11.10.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 2.1.5 من حزمة تطوير البرامج (SDK) لنظام التشغيل 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
. - تتطلب الآن الإصدار 9.8.0 أو إصدار أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".
- تم التحقّق من التوافق مع الإصدار 1.6.3 من حزمة SDK الخاصة بمنصة maio والإصدار 2.0.0-alpha من حزمة SDK الخاصة بمنصة maioOB.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 9.12.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.6.3 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
- الإصدار 2.0.0-alpha من حزمة تطوير البرامج (SDK) لبرنامج MaioOB
الإصدار 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 من حزمة تطوير البرامج (SDK) لنظام التشغيل 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 من حزمة تطوير البرامج (SDK) لبرنامج MaioOB
الإصدار 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 من حزمة تطوير البرامج (SDK) لنظام التشغيل Maio
الإصدار 1.5.3.1
- للحدّ من حالات انتهاء مهلة الانتظار، ستتعذّر الآن طلبات الإعلانات على الفور إذا لم يكن لدى Maia إعلان جاهز للعرض.
- تمت إزالة التوافق مع بنية i386.
تم إنشاؤها واختبارها باستخدام:
- الإصدار 7.58.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 1.5.3 من حزمة تطوير البرامج (SDK) لنظام التشغيل 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 من حزمة تطوير البرامج (SDK) لنظام التشغيل 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
- الإصدار الأول
- تمت إضافة إمكانية عرض الإعلانات البينية وإعلانات الفيديو التي تضم مكافأة.