يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض إعلانات من Mintegral باستخدام التوسّط، التي تغطي عمليات دمج كلّ من العرض الإعلاني بدون انقطاع وعروض الأسعار يتناول كيفية إضافة الحد الأدنى لتكوين توسّط إحدى الوحدات الإعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل Mintegral في Unity تطبيق.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمن AdMob محوِّل التوسط في Mintegral الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
فتح التطبيق | 1 |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
إعلان بيني يضم مكافأة |
1 عروض الأسعار والعرض الإعلاني بدون انقطاع عمليات الدمج لشكل الإعلانات على شاشة فتح التطبيق في إصدار تجريبي مغلق.
المتطلبات
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- Unity 5.6 أو إصدار أحدث
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Unity عامل تم إعداده باستخدام SDK لإعلانات Google على الأجهزة الجوّالة. عرض البدء لمعرفة التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم Mintegral
اشترِك أو سجِّل الدخول إلى حسابك على Mintegral.
تحديد موقع مفتاح التطبيق
انتقِل إلى علامة التبويب إعدادات التطبيق ودوِّن مفتاح التطبيق.
إضافة تطبيق جديد
من علامة التبويب إعدادات التطبيق، انقر على زر إضافة تطبيق.
اختَر النظام الأساسي واملأ بقية النموذج. انقر بعد ذلك على حفظ.
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/new_application_Android.png?authuser=19&hl=ar)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/new_application_iOS.png?authuser=19&hl=ar)
دوِّن APP ID لتطبيقك.
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/app_id_Android.png?authuser=19&hl=ar)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/app_id_iOS.png?authuser=19&hl=ar)
إنشاء موضع إعلان
بعد إنشاء طلبك، انتقِل إلى علامة التبويب مواضع الإعلانات والوحدات وانقر على الزر إضافة موضع إعلان كما هو موضّح أدناه لإنشاء موضع إعلانك.
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/create_placement_Android.png?authuser=19&hl=ar)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/create_placement_iOS.png?authuser=19&hl=ar)
أدخِل اسم موضع الإعلان وشكل الإعلان.
عروض الأسعار
اختَر عرض الأسعار مسبقًا باعتباره نوع عرض السعر. املأ باقي النموذج وانقر على حفظ
شلال
اختَر تقليدي باعتباره نوع عرض السعر. املأ ما تبقّى من النموذج وانقر على حفظ.
بعد إنشاء موضع الإعلان، دوِّن رقم تعريف موضع الإعلان.
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=19&hl=ar)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/ad_placement_id_iOS.png?authuser=19&hl=ar)
انقر على القائمة المنسدلة وحدة إعلانية واحدة ودوِّن رقم تعريف الوحدة الإعلانية.
Android
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=19&hl=ar)
iOS
![](https://developers-dot-devsite-v2-prod.appspot.com/static/admob/images/mediation/mintegral/add_ad_unit_id_iOS.png?authuser=19&hl=ar)
تحديد موقع مفتاح واجهة برمجة التطبيقات Mintegral Reporting API
عروض الأسعار
هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
ستحتاج إلى مفتاح واجهة برمجة التطبيقات Mintegral Reporting API لإعداد AdMob رقم تعريف الوحدة الإعلانية. انتقل إلى الحساب > أدوات واجهة برمجة التطبيقات. دوِّن المفتاح والسر.
الخطوة 2: إعداد Mintegral مطلوب في واجهة مستخدم AdMob
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة Mintegral إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة Mintegral إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في AdMob واجهة المستخدم.
الخطوة 3: استيراد ملف SDK ومحوّل Mintegral
تنزيل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في Mintegral
من رابط التنزيل في
سجلّ التغييرات واستخراج
GoogleMobileAdsMintegralMediation.unitypackage
من ملف ZIP.
في محرِّر مشروعات Unity، اختَر مواد العرض >. استيراد حزمة >مخصص
الحزمة والعثور على GoogleMobileAdsMintegralMediation.unitypackage
الملف الذي قمت بتنزيله. تأكد من تحديد كل الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض >. محلل خدمات Play > محلل Android > القوة
حلّ المشكلة ستنفّذ مكتبة "أداة حل خدمات Unity Play" الاعتمادية
من البداية ونسخ التبعيات المعلنة إلى
الدليل Assets/Plugins/Android
لتطبيق Unity
الخطوة 4: إضافة الرمز المطلوب
Android
ما مِن رمز إضافي مطلوب لدمج Mintegral.
iOS
دمج SKAdNetwork
اتّباع مستندات Mintegral
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist
الخاص بمشروعك.
الخطوة 5: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل AdMob.
للحصول على إعلانات Mintegral التجريبية لإعلانات البانر والإعلانات البينية وأشكال الإعلانات التي تضم مكافأة والإعلانات المدمجة مع المحتوى، تنصح Mintegral باستخدام مفاتيح التطبيقات وأرقام تعريف التطبيقات وأرقام تعريف مواضع الإعلانات وأرقام تعريف الوحدات الإعلانية المقدَّمة في صفحة رقم تعريف Mintegral Test:
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من Mintegral، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام Mintegral (Bidding) and Mintegral (Waterfall) مصادر الإعلانات.
رموز الخطأ
في حال تعذّر على المحوّل استلام إعلان من Mintegral، يمكن للناشرين التحقّق من
خطأ أساسي من استجابة الإعلان باستخدام
ResponseInfo
ضمن الفئات التالية:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل Mintegral عند تعذّر تحميل إعلان:
Android
رمز الخطأ | النطاق | السبب |
---|---|---|
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 | عرَضَ Mintegral SDK خطأ "بلا تعبئة". |
iOS
رمز الخطأ | النطاق | السبب |
---|---|---|
101 | com.google.mediation.mintegral | مَعلمات الخادم غير صالحة (على سبيل المثال، رقم تعريف التطبيق أو رقم تعريف موضع الإعلان غير متوفّر) |
102 | com.google.mediation.mintegral | عرَضَ Mintegral SDK خطأ "بلا تعبئة". |
103 | com.google.mediation.mintegral | تعذّر على Mintegral SDK عرض إعلان. |
104 | com.google.mediation.mintegral | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق من Mintegral. |
سجلّ تغييرات المكوّن الإضافي لـ Mintegral Unity Mediation
الإصدار 1.7.0
- تمت إعادة تسمية "
DummyClient
" إلى "PlaceholderClient
". - يتوافق مع الإصدار 16.8.11.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.6.9.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.2.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.6.5
- يتوافق مع الإصدار 16.7.81.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.6.8.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.2.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.6.4
- يتوافق مع الإصدار 16.7.61.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.6.7.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.6.3
- يتوافق مع الإصدار 16.7.41.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.6.6.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.6.2
- يتوافق مع الإصدار 16.7.41.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.6.4.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.6.1
- يتوافق مع الإصدار 16.7.21.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.6.3.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.6.0
- يتوافق مع الإصدار 16.7.11.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.6.2.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.5.0
- يتوافق مع الإصدار 16.6.71.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.6.0.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.4.0
- يتوافق مع الإصدار 16.6.34.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.5.6.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.7.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.3.0
- يتوافق مع الإصدار 16.5.91.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.5.3.0 من محوّل Mintegral iOS.
- تمّت إضافة الطرق التالية إلى الفئة
Mintegral
:SetConsentStatus(bool)
SetDoNotTrackStatus(bool)
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.6.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.2.1
- يتوافق مع الإصدار 16.4.61.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.3.8.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.3.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.2.0
- تم نقل محتوى المحوّل إلى
GoogleMobileAds/Mediation/Mintegral/
. - يتوافق مع الإصدار 16.4.41.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.3.6.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.3.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.1.0
- يتوافق مع الإصدار 16.3.61.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.2.9.1 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.4.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 1.0.0
- الإصدار الأولي
- يتوافق مع الإصدار 16.2.61.0 من محوّل Mintegral.
- يتوافق مع الإصدار 7.2.6.0 من محوّل Mintegral iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.3.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.