تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

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

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

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

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

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

أن يكون الإصدار المستهدَف لنشر iOS هو 15.0 أو إصدار أحدث

أحدث إصدار من Google Mobile Ads SDK
إعداد التوسّط

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

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

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

إعلان بيني

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

مقابل مكافأة

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

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

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

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

الخطوة 2: إعداد طلب maio في واجهة مستخدم "إدارة الإعلانات"

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

سجِّل الدخول إلى حسابك على "إدارة إعلانات Google".

انتقِل إلى التسليم > مجموعة الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة شبكات إعلانية مدِرّة للأرباح جديدة.

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

بعد ذلك، انقر على الزر إضافة شريك إعلاني مدِّر للأرباح.

إذا كان لديك شريك إعلاني مدِّر للأرباح في maio، يمكنك اختياره. بخلاف ذلك، اختَر إنشاء شريك جديد إعلاني مدِّر للأرباح.

اختَر maio كـ شبكة الإعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط.

فعِّل جمع البيانات تلقائيًا، وأدخِل معرّف واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات الذي حصلت عليهما في القسم السابق.

بعد اختيار شريك إعلاني مدِّر للأرباح، اختَر التوسّط في حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وiOS كـ النظام الأساسي، ونشط كـ الحالة. أدخِل معرّف الوسائط ومعرّف المنطقة الذي حصلت عليهما في القسم السابق. بعد ذلك، أدخِل قيمة تكلفة تلقائية لكل ألف ظهور.

انقر على حفظ في أسفل الصفحة عند الانتهاء.

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

استخدام Swift Package Manager

قبل المتابعة، يجب أن يكون لديك الحد الأدنى من إصدار المحوّل المتوافق 2.2.0.0.

لإضافة حزمة تابعة إلى مشروعك، اتّبِع الخطوات التالية:

في Xcode، انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة... (File > Add Package Dependencies...).
في الطلب الذي يظهر، ابحث عن عنوان URL للحزمة التالية:
```
https://github.com/googleads/googleads-mobile-ios-mediation-maio.git
```
في قاعدة التبعية، اختَر الفرع.
في حقل النص، أدخِل main.

استخدام CocoaPods

أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:
```
pod 'GoogleMobileAdsMediationMaio'
```
من سطر الأوامر، شغِّل:
```
pod install --repo-update
```

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) لمنصة maio.
نزِّل أحدث إصدار من محوّل maio من رابط التنزيل في سجلّ التغييرات، واربط maioAdapter.framework في مشروعك.

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

تنفيذ SKAdNetwork

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

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

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

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

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

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

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

رموز الخطأ

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

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

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

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