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

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

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

يتضمّن محوّل التوسّط في "مدير إعلانات Google" لشبكة Mintegral الميزات التالية:

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

• أحدث إصدار من Google Mobile Ads Flutter Plugin
• الإصدار 3.7.0 أو إصدار أحدث من إطار عمل Flutter
• للنشر على Android
  • المستوى 24 من واجهة برمجة التطبيقات Android أو الإصدارات الأحدث
• للنشر على أجهزة iOS
  • الإصدار 13.0 من نظام التشغيل iOS أو إصدار أحدث
• مشروع Flutter يعمل وتم ضبط إعداداته باستخدام Google Mobile Ads Flutter Plugin. لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Flutter Plugin.

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

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

العثور على مفتاح التطبيق

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

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

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

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

Android

iOS

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

Android

iOS

العثور على مفتاح واجهة برمجة التطبيقات لإعداد التقارير في Mintegral

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

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

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

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

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

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

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

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

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

(على Android فقط) أضِف المستودعات التالية إلى ملف build.gradle داخل دليل android الخاص بمشروعك:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
      }
  }

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

dependencies:
  gma_mediation_mintegral: ^2.1.5

عملية الدمج اليدوية

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

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

الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) من Mintegral

موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامة لحماية البيانات"

للالتزام بسياسة موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google، عليك الإفصاح عن معلومات محدّدة للمستخدمين في المنطقة الاقتصادية الأوروبية والمملكة المتحدة وسويسرا، والحصول على موافقتهم على استخدام ملفات تعريف الارتباط أو غير ذلك من البيانات المحفوظة على أجهزتهم المحلية وفقًا للمتطلبات القانونية، وكذلك موافقتهم على جمع البيانات الشخصية ومشاركتها واستخدامها في تخصيص الإعلانات. تعكس هذه السياسة شروط "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR). أنت مسؤول عن التحقّق من نشر الموافقة على كل مصدر إعلان في سلسلة التوسّط.

يتيح الإصدار 2.1.1 من محوّل Mintegral Flutter والإصدارات الأحدث تمرير إشارات الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) من منصّات إدارة الموافقة التي تتكامل مع "إطار الشفافية والموافقة" (TCF) الصادر عن مكتب IAB إلى حزمة تطوير البرامج (SDK) لمنصّة Mintegral. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات بيان الامتثال للخصوصية في حزمة تطوير البرامج (SDK) لنظامَي التشغيل Android وiOS من Mintegral.

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

الخطوة 6: اختبار عملية الإعداد

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

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

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

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

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

رموز الخطأ

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

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

GADMediationAdapterMintegral

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

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

الإصدار 2.1.5

• يتوافق مع الإصدار 17.1.81.1 من محوّل Mintegral لنظام التشغيل Android.
• يتوافق مع الإصدار 8.1.7.0 من محوّل Mintegral لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.1.4

• يتوافق مع الإصدار 17.1.81.0 من محوّل Mintegral لنظام التشغيل Android.
• متوافق مع الإصدار 8.1.7.0 من محوّل Mintegral لنظام التشغيل iOS
• تم إنشاء هذا الدليل واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.1.3

• تم تعديل هذا الإصدار ليتوافق مع الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• إضافة إمكانية استخدام Swift Package Manager
• يتوافق مع الإصدار 17.1.71.0 من محوّل Mintegral لنظام التشغيل Android.
• يتوافق مع الإصدار 8.1.6.0 من محوّل Mintegral لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.1.2

• يتوافق مع الإصدار 17.1.71.0 من محوّل Mintegral لنظام التشغيل Android.
• يتوافق مع الإصدار 8.1.6.0 من محوّل Mintegral لنظام التشغيل iOS.
• تم إنشاء هذا الدليل واختباره باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.1.1

• يتوافق مع الإصدار 17.1.61.1 من محوّل Mintegral Android.
• يتوافق مع الإصدار 8.1.5.0 من محوّل Mintegral iOS.
• تم إنشاء هذا الدليل واختباره باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.1.0

• تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1.
• تم تعديل هذا الإصدار ليتوافق مع الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• متوافق مع الإصدار 17.1.41.0 من برنامج Mintegral Android الإضافي
• يتوافق مع الإصدار 8.1.1.0 من محوّل Mintegral iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.0.3

• يتوافق مع الإصدار 17.0.61.0 من محوّل Mintegral لنظام التشغيل Android.
• يتوافق مع الإصدار 8.0.5.1 من محوِّل Mintegral لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.0.2

• تم تعديل الحد الأدنى لإصدار Flutter إلى 3.35.1
• تم تعديل هذا الإصدار ليتوافق مع الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
• متوافق مع الإصدار 17.0.41.0 من محوِّل Mintegral لنظام التشغيل Android.
• متوافق مع الإصدار 8.0.4.0 من محوّل Mintegral لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.0.1

• متوافق مع الإصدار 17.0.31.0 من محوّل Mintegral Android
• يتوافق مع الإصدار 8.0.3.0 من محوّل Mintegral iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.0.0

• يتوافق مع الإصدار 17.0.21.0 من محوِّل Mintegral لنظام التشغيل Android.
• متوافق مع الإصدار 8.0.2.0 من محوّل Mintegral لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.2.6

• يتوافق مع الإصدار 16.9.91.1 من محوِّل Mintegral لنظام التشغيل Android.
• يتوافق مع الإصدار 7.7.9.1 من محوّل Mintegral لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.2.5

• يتوافق مع الإصدار 16.9.91.1 من محوِّل Mintegral لنظام التشغيل Android.
• متوافق مع الإصدار 7.7.9.0 من محوّل Mintegral لنظام التشغيل iOS
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.2.4

• يتوافق مع الإصدار 16.9.91.0 من محوّل Mintegral لنظام التشغيل Android.
• يتوافق مع الإصدار 7.7.9.0 من محوّل Mintegral لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.2.3

• يتوافق مع الإصدار 16.9.71.0 من محوّل Mintegral لنظام التشغيل Android.
• متوافق مع الإصدار 7.7.8.0 من محوّل Mintegral لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.2.2

• متوافق مع الإصدار 16.9.71.0 من محوّل Mintegral لنظام التشغيل Android.
• يتوافق مع الإصدار 7.7.7.0 من محوّل Mintegral iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.2.1

• يتوافق مع الإصدار 16.9.61.0 من محوّل Mintegral لنظام التشغيل Android.
• يتوافق مع الإصدار 7.7.7.0 من محوّل Mintegral iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.2.0

• يتوافق مع الإصدار 16.9.41.1 من محوّل Mintegral لنظام التشغيل Android.
• يتوافق مع الإصدار 7.7.7.0 من محوّل Mintegral iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.1.0

• أصبح المكوّن الإضافي لنظام التشغيل iOS إطارًا ثابتًا.
• يتوافق مع الإصدار 16.8.61.0 من محوّل Mintegral لنظام التشغيل Android.
• يتوافق مع الإصدار 7.7.5.0 من محوّل Mintegral iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.0

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