يوضّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من Mintegral باستخدام التوسّط، ويتناول كلّ من عمليات دمج العرض الإعلاني بدون انقطاع وعروض الأسعار. ويتناول هذا الدليل كيفية إضافة Mintegral إلى إعدادات التوسّط للوحدة الإعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوِّل Mintegral في تطبيق Unity.
عمليات الدمج وأشكال الإعلانات المتوافقة
يمتلك محوِّل توسّط AdMob لخدمة Mintegral الإمكانات التالية:
التكامل | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
إعلان على شاشة فتح التطبيق | 1 |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
إعلان بيني يضمّ مكافأة |
1 إنّ عمليات دمج عروض الأسعار والعرض الإعلاني بدون انقطاع لشكل الإعلان على شاشة فتح التطبيق متوفّرة في إصدار تجريبي مغلق.
المتطلبات
- أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- الإصدار 5.6 من Unity أو إصدار أحدث
- [لعرض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عرض الأسعار، استخدِم مكوّن إضافي لدمج "إعلانات Google على الأجهزة الجوّالة" في Mintegral 1.4.0 أو إصدار أحدث (ننصح باستخدام أحدث إصدار).
- للنشر على Android
- المستوى 21 من واجهة برمجة التطبيقات لنظام التشغيل Android أو إصدار أحدث
- للنشر على أجهزة iOS
- إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
- مشروع Unity صالح تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" اطّلِع على البدء لمعرفة التفاصيل.
- إكمال التوسّط دليل البدء
الخطوة 1: إعداد الإعدادات في واجهة مستخدم Mintegral
اشترِك أو سجِّل الدخول إلى حسابك على Mintegral.
تحديد مكان مفتاح التطبيق
انتقِل إلى علامة التبويب إعدادات التطبيق ودوِّن مفتاح التطبيق.
إضافة تطبيق جديد
من علامة التبويب إعدادات التطبيق، انقر على الزر إضافة تطبيق.
اختَر النظام الأساسي واملأ بقية النموذج. بعد ذلك، انقر على حفظ.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/new_application_Android.png?authuser=0000&hl=ar)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/new_application_iOS.png?authuser=0000&hl=ar)
دوِّن رقم تعريف التطبيق.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/app_id_Android.png?authuser=0000&hl=ar)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/app_id_iOS.png?authuser=0000&hl=ar)
إنشاء موضع إعلان
بعد إنشاء طلبك، انتقِل إلى علامة التبويب المواضع والوحدات وانقر على الزر إضافة موضع إعلان كما هو موضّح أدناه لإنشاء موضع إعلانك.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/create_placement_Android.png?authuser=0000&hl=ar)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/create_placement_iOS.png?authuser=0000&hl=ar)
أدخِل اسم موضع الإعلان وتنسيق الإعلان.
اختَر عروض الأسعار في العنوان كـ نوع عروض الأسعار. املأ بقية النموذج وانقر على حفظ.
اختَر تقليدي كـ نوع عروض الأسعار. املأ بقية النموذج وانقر على حفظ.
بعد إنشاء موضع إعلانك، دوِّن معرّف موضع الإعلان.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=0000&hl=ar)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/ad_placement_id_iOS.png?authuser=0000&hl=ar)
انقر على القائمة المنسدلة وحدة إعلانية واحدة ودوِّن رقم تعريف الوحدة الإعلانية.
![](https://developers.google.cn/static/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=0000&hl=ar)
![](https://developers.google.cn/static/admob/images/mediation/mintegral/add_ad_unit_id_iOS.png?authuser=0000&hl=ar)
تحديد موضع مفتاح واجهة برمجة التطبيقات Reporting API في Mintegral
هذه الخطوة غير مطلوبة لدمج عروض الأسعار.
ستحتاج إلى مفتاح واجهة برمجة التطبيقات لإعداد تقارير Mintegral رقم تعريف الوحدة الإعلانية في AdMob. انتقِل إلى الحساب > أدوات واجهة برمجة التطبيقات. دوِّن Skey وSecret.
الخطوة 2: إعداد طلب Mintegral في واجهة مستخدم AdMob
ضبط إعدادات التوسّط لوحدتك الإعلانية
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل استخدام iOS.
إضافة Mobvista/Mintegral إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" (GDPR) واللوائح التنظيمية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Mobvista/Mintegral إلى قائمة شركاء الإعلانات بموجب اللوائح التنظيمية الأوروبية وتلك السارية في الولايات الأمريكية في واجهة مستخدِم AdMob.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوِّل Mintegral
إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت "مكوّن إضافي لتوسّط Mintegral" لأجل Unity في "إعلانات Google للأجهزة الجوّالة" في مشروعك من خلال تنفيذ الأمر التالي من directory root لمشروعك:
openupm add com.google.ads.mobile.mediation.mintegral
في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > مدير الحِزم لفتح إعدادات "مدير حِزم Unity".
ضمن علامة التبويب السجلّات على مستوى النطاق، أضِف OpenUPM كسجلّ على مستوى النطاق باستخدام التفاصيل التالية:
- الاسم:
OpenUPM
- عنوان URL:
https://package.openupm.com
- النطاقات:
com.google
بعد ذلك، انتقِل إلى النافذة (Window) > مدير الحِزم (Package Manager) لفتح مدير حِزم Unity (Unity Package Manager) و اختَر السجلّات الخاصة بي (My Registries) من القائمة المنسدلة.
اختَر حزمة Google Mobile Ads Mintegral Mediation وانقر على تثبيت.
نزِّل أحدث إصدار من المكوّن الإضافي لدمج إعلانات Google للأجهزة الجوّالة لأجل
Mintegral من رابط التنزيل في
سجلّ التغييرات
واستخرِج ملف
GoogleMobileAdsMintegralMediation.unitypackage
من ملف zip.
في محرِّر مشروع Unity، اختَر مواد العرض > استيراد حزمة >
حزمة مخصّصة وابحث عن
GoogleMobileAdsMintegralMediation.unitypackage
الملف الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض > مدير التبعيات الخارجية >
Android Resolver > Force Resolve (حلّ المشاكل بالقوة). ستُجري مكتبة "مدير التبعية الخارجية"
عملية حلّ التبعية من البداية وستنسخ
التبعيات المعلَن عنها إلى الدليل Assets/Plugins/Android
في
تطبيق Unity.
الخطوة 4: إضافة الرمز المطلوب
لا يلزم استخدام رمز إضافي لدمج Mintegral.
دمج SKAdNetwork
اتّبِع مستندات Mintegral
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist
في مشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob.
للحصول على إعلانات تجريبية من Mintegral لأشكال إعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافآت والإعلانات المدمجة مع المحتوى، تنصح Mintegral باستخدام مفاتيح التطبيقات وأرقام تعريف التطبيقات وأرقام تعريف مواضع الإعلانات وأرقام تعريف الوحدات الإعلانية المتوفّرة في صفحة رقم التعريف التجريبي في Mintegral.
إثبات صحة الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من Mintegral، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصدرَي الإعلانات Mintegral (عروض الأسعار) وMintegral (العرض بدون انقطاع).
رموز الخطأ
إذا تعذّر على المُحوِّل تلقّي إعلان من Mintegral، يمكن للناشرين التحقّق من
الخطأ الأساسي من استجابة الإعلان باستخدام
ResponseInfo
ضمن الفئات التالية:
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
GADMediationAdapterMintegral
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل Mintegral عند تعذُّر تحميل إعلان:
رمز الخطأ | النطاق | السبب |
---|---|---|
101 | com.google.ads.mediation.mintegral | مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف التطبيق أو رقم تعريف موضع الإعلان) |
102 | com.google.ads.mediation.mintegral | لا يتطابق حجم الإعلان المطلوب مع حجم البانر المتوافق مع Mintegral. |
103 | com.google.ads.mediation.mintegral | استجابة عرض السعر غير متوفّرة أو غير صالحة |
104 | com.google.ads.mediation.mintegral | عرَضت حزمة SDK من Mintegral خطأً يفيد بأنّه لم تتم التعبئة. |
رمز الخطأ | النطاق | السبب |
---|---|---|
101 | com.google.mediation.mintegral | مَعلمات الخادم غير صالحة (مثل عدم توفّر رقم تعريف التطبيق أو رقم تعريف موضع الإعلان) |
102 | com.google.mediation.mintegral | عرَضت حزمة SDK من Mintegral خطأً يفيد بأنّه لم تتم التعبئة. |
103 | com.google.mediation.mintegral | تعذّر على حزمة تطوير البرامج (SDK) من Mintegral عرض إعلان. |
104 | com.google.mediation.mintegral | لا يتطابق حجم الإعلان المطلوب مع حجم البانر المتوافق مع Mintegral. |
سجلّ التغييرات في المكوّن الإضافي Mintegral Unity Mediation Plugin
الإصدار 1.8.3
- يتوافق مع الإصدار 16.8.61.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.7.3.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.3.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.8.2
- يتوافق مع الإصدار 16.8.61.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.7.2.1 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.2.1 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.8.1
- يتوافق مع الإصدار 16.8.51.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.7.2.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.2.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.8.0
- يتوافق مع الإصدار 16.8.31.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.7.0.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.2.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.7.0
- تمت إعادة تسمية
DummyClient
إلىPlaceholderClient
. - متوافق مع الإصدار 16.8.11.0 من محوِّل Mintegral لنظام التشغيل Android.
- يتوافق مع الإصدار 7.6.9.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.2.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.6.5
- متوافق مع الإصدار 16.7.81.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.6.8.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.2.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.6.4
- متوافق مع الإصدار 16.7.61.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.6.7.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.6.3
- متوافق مع الإصدار 16.7.41.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.6.6.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.6.2
- متوافق مع الإصدار 16.7.41.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.6.4.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.6.1
- متوافق مع الإصدار 16.7.21.0 من محوِّل Mintegral لنظام التشغيل Android.
- يتوافق مع الإصدار 7.6.3.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.6.0
- متوافق مع الإصدار 16.7.11.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.6.2.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.5.0
- متوافق مع الإصدار 16.6.71.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.6.0.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.4.0
- متوافق مع الإصدار 16.6.34.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.5.6.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 8.7.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.3.0
- يتوافق مع الإصدار 16.5.91.0 من محوِّل Mintegral لنظام التشغيل Android.
- يتوافق مع الإصدار 7.5.3.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تمت إضافة الطرق التالية إلى فئة
Mintegral
:SetConsentStatus(bool)
SetDoNotTrackStatus(bool)
- تم إنشاؤه واختباره باستخدام الإصدار 8.6.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.2.1
- يتوافق مع الإصدار 16.4.61.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.3.8.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤها واختبارها باستخدام الإصدار 8.3.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.2.0
- تم نقل محتوى المحوِّل إلى
GoogleMobileAds/Mediation/Mintegral/
. - يتوافق مع الإصدار 16.4.41.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.3.6.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤها واختبارها باستخدام الإصدار 8.3.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.1.0
- متوافق مع الإصدار 16.3.61.0 من محوِّل Mintegral لنظام التشغيل Android.
- يتوافق مع الإصدار 7.2.9.1 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 7.4.1 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".
الإصدار 1.0.0
- الإصدار الأولي
- متوافق مع الإصدار 16.2.61.0 من محوِّل Mintegral لنظام التشغيل Android.
- متوافق مع الإصدار 7.2.6.0 من محوِّل Mintegral لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 7.3.1 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".