دمج Mintegral مع التوسّط

يوضّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من Mintegral باستخدام التوسّط، ويشمل ذلك دمج كلّ من العرض الإعلاني بدون انقطاع وعروض الأسعار. ويتناول هذا الدليل كيفية إضافة Mintegral إلى إعدادات التوسّط للوحدة الإعلانية، وكيفية دمج IDE وملف التثبيت لأجل Mintegral في تطبيق Unity.

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

يتضمّن محوِّل توسّط AdMob لخدمة Mintegral الإمكانات التالية:

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

المتطلبات

• أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.6 من Unity أو إصدار أحدث
  • [لعرض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عرض الأسعار، استخدِم مكوّن إضافي للتوسّط في "إعلانات Google على الأجهزة الجوّالة" لإصدار Mintegral 1.4.0 أو إصدار أحدث (ننصح باستخدام أحدث إصدار).
  • للنشر على Android
    • المستوى 23 من واجهة برمجة التطبيقات لنظام التشغيل Android أو مستوى أعلى
  • للنشر على أجهزة iOS
    • إصدار 12.0 من نظام التشغيل iOS أو إصدار أحدث مستهدف للنشر
  • مشروع Unity صالح تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" اطّلِع على البدء لمعرفة التفاصيل.
  • إكمال التوسّط دليل البدء

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

اشترِك أو سجِّل الدخول إلى حسابك على Mintegral.

تحديد مكان مفتاح التطبيق

انتقِل إلى علامة التبويب إعدادات التطبيق ودوِّن مفتاح التطبيق.

إضافة تطبيق جديد

من علامة التبويب إعدادات التطبيق، انقر على الزر إضافة تطبيق.

اختَر النظام الأساسي واملأ بقية النموذج. بعد ذلك، انقر على حفظ.

Android

iOS

دوِّن رقم تعريف التطبيق.

Android

iOS

إنشاء موضع إعلان

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

Android

iOS

أدخِل اسم موضع الإعلان وتنسيق الإعلان.

ملاحظة مهمة: بالنسبة إلى شكل الإعلان المدمج مع المحتوى، اختَر مدمَج مع المحتوى (عرض مخصّص) كأحد أشكال الإعلان.

عروض الأسعار

اختَر عروض الأسعار في العنوان كـ نوع عروض الأسعار. املأ بقية النموذج وانقر على حفظ.

شلال

اختَر العرض الإعلاني بدون انقطاع كـ نوع عروض الأسعار. املأ بقية النموذج وانقر على حفظ.

بعد إنشاء موضع إعلانك، دوِّن معرّف موضع الإعلان.

Android

iOS

انقر على القائمة المنسدلة وحدة إعلانية واحدة ودوِّن رقم تعريف الوحدة الإعلانية.

Android

iOS

تحديد مكان مفتاح Reporting API في Mintegral

عروض الأسعار

هذه الخطوة غير مطلوبة لدمج عروض الأسعار.

شلال

ستحتاج إلى مفتاح واجهة برمجة التطبيقات لإعداد تقارير Mintegral رقم تعريف الوحدة الإعلانية في AdMob. انتقِل إلى الحساب > أدوات واجهة برمجة التطبيقات. دوِّن Skey وSecret.

تعديل ملف app-ads.txt

ملف app-ads.txt الخاص بمبادرة "البائعون المعتمَدون للتطبيقات" هو مبادرة من "مختبر IAB التقني" تساعد على ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك إلا من خلال القنوات التي حدّدتها على أنّها مخوّلة. للحيلولة دون حدوث خسارة كبيرة في أرباح الإعلانات، عليك استخدام ملفّ app-ads.txt. في حال عدم إجراء ذلك من قبل، إعداد ملف app-ads.txt لتطبيقك

لتنفيذ app-ads.txt في Mintegral، اطّلِع على كيفية مساعدة ملف app-ads.txt في مكافحة الاحتيال الإعلاني.

الخطوة 2: إعداد طلب Mintegral في واجهة مستخدم AdMob

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

Android

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل استخدام iOS.

إضافة Mobvista/Mintegral إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" (GDPR) واللوائح التنظيمية في الولايات الأمريكية

ملاحظة مهمة: تأكّد من حصولك على إذن إدارة الحساب لإكمال عملية الإعداد لموافقة المستخدم في الاتحاد الأوروبي واللوائح العامة لحماية البيانات ولوائح الولايات الأمريكية ومنصة مراسلة المستخدمين. اطّلِع على مقالة إدارة وصول المستخدمين إلى حسابك للاطّلاع على التفاصيل.

اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Mobvista/Mintegral إلى قائمة شركاء الإعلانات بموجب اللوائح التنظيمية الأوروبية وتلك في الولايات الأمريكية في واجهة مستخدِم AdMob.

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

ملاحظة: قد يؤدي عدم دمج الإصدارَين المتوافقَين من Mintegral وحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى حدوث مشاكل في الإصدار.

OpenUPM-CLI

ملاحظة مهمة: في حال كنت بصدد نقل البيانات من استخدام .unitypackage إلى استخدام OpenUPM-CLI، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم من خلال حذف جميع الملفات من المجلد Assets/GoogleMobileAds/Mediation/Mintegral.

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت "مكوّن إضافي لتوسّط Mintegral" لأجل Unity في "إعلانات Google للأجهزة الجوّالة" في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

openupm add com.google.ads.mobile.mediation.mintegral

OpenUPM

ملاحظة مهمة: في حال نقل البيانات من استخدام .unitypackage إلى استخدام OpenUPM، عليك إلغاء تثبيت مواد العرض يدويًا من الموقع القديم من خلال حذف جميع الملفات من المجلد Assets/GoogleMobileAds/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 وانقر على تثبيت.

حزمة Unity

نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google للأجهزة الجوّالة لأجل Mintegral من رابط التنزيل في سجلّ التغييرات واستخرِج GoogleMobileAdsMintegralMediation.unitypackage منملف zip.

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

بعد ذلك، اختَر مواد العرض > مدير التبعيات الخارجية > Android Resolver > Force Resolve (فرض الحلّ). ستُجري مكتبة "مدير التبعية الخارجية" عملية حلّ التبعية من البداية وستنسخ التبعيات المعلَن عنها إلى الدليل Assets/Plugins/Android في تطبيق Unity.

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

Android

لا يلزم استخدام رمز إضافي لدمج Mintegral.

iOS

دمج SKAdNetwork

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

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

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

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

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

ملاحظة مهمة: يجب إيقاف وضع الاختبار في AdMob و Mintegral قبل إصدار تطبيقك.

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

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

رموز الخطأ

إذا تعذّر على المُحوِّل تلقّي إعلان من 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	عرَضت حزمة SDK من Mintegral خطأً يفيد بأنّه لم تتم التعبئة.

iOS

رمز الخطأ	النطاق	السبب
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.9.3

• متوافق مع الإصدار 16.9.71.0 من محوِّل Mintegral لنظام التشغيل Android.
• يتوافق مع الإصدار 7.7.8.0 من محوِّل Mintegral لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 10.2.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".

الإصدار 1.9.2

• متوافق مع الإصدار 16.9.71.0 من محوِّل Mintegral لنظام التشغيل Android.
• متوافق مع الإصدار 7.7.7.0 من محوِّل Mintegral لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 10.1.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".

الإصدار 1.9.1

• متوافق مع الإصدار 16.9.61.0 من محوِّل Mintegral لنظام التشغيل Android.
• متوافق مع الإصدار 7.7.7.0 من محوِّل Mintegral لنظام التشغيل iOS.
• تم إنشاؤها واختبارها باستخدام الإصدار 10.0.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".

الإصدار 1.9.0

• يتوافق مع الإصدار 16.9.51.0 من محوِّل Mintegral لنظام التشغيل Android.
• متوافق مع الإصدار 7.7.7.0 من محوِّل Mintegral لنظام التشغيل iOS.
• تم إنشاؤها واختبارها باستخدام الإصدار 10.0.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".

الإصدار 1.8.4

• يتوافق مع الإصدار 16.8.61.0 من محوِّل Mintegral لنظام التشغيل Android.
• متوافق مع الإصدار 7.7.5.0 من محوِّل Mintegral لنظام التشغيل iOS.
• تم إنشاؤها واختبارها باستخدام الإصدار 9.5.0 من "مكوّن إعلانات Google على الأجهزة الجوّالة في Unity".

الإصدار 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".