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

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

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

توفّر أداة توسّط "مدير إعلانات Google" لخدمة Mintegral الإمكانات التالية:

² يتوفّر دمج العرض الإعلاني بدون انقطاع في مرحلة الإصدار التجريبي المفتوح.

المتطلبات

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

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

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

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

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

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

Android

iOS

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

Android

iOS

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

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

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

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

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

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

الدمج من خلال pub.dev

أضِف التبعية التالية مع أحدث إصدارَين من حزمة SDK ومحوِّل Mintegral في ملفpubspec.yaml الحزمة:

dependencies:
  gma_mediation_mintegral: ^1.0.0

الدمج اليدوي

نزِّل أحدث إصدار من المكوّن الإضافي لوسيط إعلانات Google للأجهزة الجوّالة لأجل Mintegral، واستخلص الملف الذي تم تنزيله، وأضِف مجلد المكوّن الإضافي المستخرَج (ومحتوياته) إلى مشروع Flutter. بعد ذلك، يمكنك الإشارة إلى المكوّن الإضافي في ملف pubspec.yaml عن طريق إضافة التبعية التالية:

dependencies:
  gma_mediation_mintegral:
    path: path/to/local/package

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

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

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

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

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

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

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

رموز الخطأ

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

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

GADMediationAdapterMintegral

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

سجلّ التغييرات في "محوِّل التوسّط في Flutter" من Mintegral

النسخة التالية

• تم إنشاؤه واختباره باستخدام الإصدار 5.2.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".

1.1.0

• تم التحقّق من التوافق مع الإصدار 16.8.31.0 من محوِّل Mintegral لنظام التشغيل Android.
• تم التحقّق من التوافق مع الإصدار 7.7.1.0 من محوِّل Mintegral لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 5.1.0 من المكوّن الإضافي Flutter لإعلانات Google على الأجهزة الجوّالة.

1.0.0

• الإصدار الأولي
• تم التحقّق من التوافق مع الإصدار 16.7.21.0 من محوِّل Mintegral لنظام التشغيل Android.
• تم التحقّق من التوافق مع الإصدار 7.6.3.0 من محوِّل Mintegral لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 5.1.0 من المكوّن الإضافي Flutter لإعلانات Google على الأجهزة الجوّالة.