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

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

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

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

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

¹ دمج العرض الإعلاني بدون انقطاع لهذا الشكل في إصدار تجريبي مغلق.

² تتوفّر عملية دمج عروض الأسعار لهذا الشكل في إصدار تجريبي مغلق.

المتطلّبات

• Unity 5.6 أو إصدار أحدث
• أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
• للنشر على Android:
  • المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android
• للنشر على iOS:
  • هدف نشر iOS هو 12.0 أو إصدار أحدث
• مشروع Unity عملي تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على التفاصيل.
• إكمال عملية التوسّط دليل البدء

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

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

تحديد موقع مفتاح التطبيق

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

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

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

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

Android

iOS

دوِّن APP ID لتطبيقك.

Android

iOS

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

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

Android

iOS

أدخِل اسم موضع الإعلان وشكل الإعلان.

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

عروض الأسعار

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

شلال

اختَر تقليدي باعتباره نوع عرض السعر. املأ ما تبقّى من النموذج وانقر على حفظ.

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

Android

iOS

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

Android

iOS

تحديد موقع مفتاح واجهة برمجة التطبيقات Mintegral Reporting API

عروض الأسعار

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

شلال

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

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

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

Android

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

iOS

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

إضافة Mintegral إلى قائمة شركاء الإعلانات الذين يخضعون للّائحة العامة لحماية البيانات (GDPR) ولوائح الولايات الأمريكية

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

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

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

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

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

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

بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android > فرض الحل. ستنفِّذ مكتبة أداة حلّ المشاكل في Unity Play Services حل التبعية من البداية، وتنسخ التبعيات المُعلَن عنها إلى دليل Assets/Plugins/Android في تطبيق Unity.

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

Android

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

iOS

دمج SKAdNetwork

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

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

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

احرص على تسجيل جهاز الاختبار من أجل AdMob.

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

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

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

للتأكّد من أنّك تتلقّى إعلانات اختبارية من 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

الإصدار 1.4.0

• يتوافق مع الإصدار 16.6.34.0 من محوّل Mintegral Android.
• يتوافق مع الإصدار 7.5.6.0 من محوّل Mintegral iOS.
• تم إنشاء البرنامج واختباره باستخدام الإصدار 8.7.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.3.0

• يتوافق مع الإصدار 16.5.91.0 من محوّل Mintegral Android.
• يتوافق مع الإصدار 7.5.3.0 من محوّل Mintegral iOS.
• تمت إضافة الطرق التالية إلى الفئة Mintegral:
  • SetConsentStatus(bool)
  • SetDoNotTrackStatus(bool)
• تم إنشاء البرنامج واختباره باستخدام الإصدار 8.6.0 من المكوّن الإضافي لبرنامج Unity إضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.2.1

• يتوافق مع الإصدار 16.4.61.0 من محوّل Mintegral Android.
• يتوافق مع الإصدار 7.3.8.0 من محوّل Mintegral iOS.
• تم إنشاء البرنامج واختباره باستخدام الإصدار 8.3.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.2.0

• تم نقل محتوى المحوّل إلى GoogleMobileAds/Mediation/Mintegral/.
• يتوافق مع الإصدار 16.4.41.0 من محوّل Mintegral Android.
• يتوافق مع الإصدار 7.3.6.0 من محوّل Mintegral iOS.
• تم إنشاء البرنامج واختباره باستخدام الإصدار 8.3.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.1.0

• يتوافق مع الإصدار 16.3.61.0 من محوّل Mintegral Android.
• يتوافق مع الإصدار 7.2.9.1 من محوّل Mintegral iOS.
• تم إنشاء الإصدار 7.4.1 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.4.1.

الإصدار 1.0.0

• الإصدار الأولي!
• يتوافق مع الإصدار 16.2.61.0 من محوّل Mintegral Android.
• يتوافق مع الإصدار 7.2.6.0 من محوّل Mintegral iOS.
• تم إنشاء البرنامج واختباره باستخدام الإصدار 7.3.1 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.