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

اختيار النظام الأساسي: Android جديد Android iOS Unity Flutter

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

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

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

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

المتطلبات

  • أحدث Google Mobile Ads Flutter Plugin
  • ‫Flutter 3.7.0 أو إصدار أحدث
  • [بالنسبة إلى عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم مكوّن التوسّط الإضافي لـ Google Mobile Ads من أجل Mintegral 1.4.0 أو إصدار أحدث (يُنصح بأحدث إصدار)
  • للنشر على Android
    • مستوى واجهة برمجة التطبيقات 23 من Android أو إصدار أحدث
  • للنشر على iOS
    • هدف النشر على iOS هو الإصدار 13.3 أو إصدار أحدث
  • مشروع Flutter قيد التشغيل تم ضبطه باستخدام الـ Google Mobile Ads Flutter Plugin. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads Flutter Plugin
  • إعداد ميزة "توسّط AdMob"

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

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

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

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

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

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

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

Android

iOS

سجِّل رقم تعريف التطبيق.

Android

iOS

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

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

Android

iOS

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

عروض الأسعار

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

عرض إعلاني بدون انقطاع

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

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

Android

iOS

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

Android

iOS

تحديد موقع مفتاح Mintegral Reporting API

عروض الأسعار

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

عرض إعلاني بدون انقطاع

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

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

تشكّل مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt مبادرة "للمختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنها مخوّلة. للحيلولة دون حدوث خسارة كبيرة في أرباح الإعلانات، عليك تنفيذ ملف 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: استيراد حزمة Mintegral SDK والمحوّل

التكامل من خلال pub.dev

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

dependencies:
  gma_mediation_mintegral: ^2.1.0

الدمج اليدوي

نزِّل أحدث إصدار من مكوّن التوسّط الإضافي لـ Google Mobile Ads من أجل 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 الاختبارية.

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

للتحقّق من أنّك تتلقّى إعلانات اختبارية من 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 عرضت حزمة Mintegral SDK خطأ تعذُّر عرض الإعلان.
103 com.google.mediation.mintegral تعذّر على حزمة Mintegral SDK عرض إعلان.
104 com.google.mediation.mintegral لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع Mintegral.

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

الإصدار 2.1.1 (قيد التطوير)

الإصدار 2.1.0

الإصدار 2.0.3

الإصدار 2.0.2

الإصدار 2.0.1

الإصدار 2.0.0

الإصدار 1.2.6

الإصدار 1.2.5

الإصدار 1.2.4

الإصدار 1.2.3

الإصدار 1.2.2

الإصدار 1.2.1

الإصدار 1.2.0

الإصدار 1.1.0

الإصدار 1.0.0