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

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

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

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

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

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

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

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫Flutter 3.7.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

عروض الأسعار

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

شلال

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

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

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_mintegral: ^1.0.0

الدمج اليدوي

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

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

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

Android

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

iOS

دمج SKAdNetwork

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

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

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

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

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

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

للتأكّد من أنّك تتلقّى إعلانات اختبارية من 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 عرَضَ Mintegral SDK خطأ "بلا تعبئة".

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.

سجلّ التغييرات في "محوِّل التوسّط في 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 على الأجهزة الجوّالة.