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

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

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

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

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

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

المتطلبات

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

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

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

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

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

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

Android

iOS

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

Android

iOS

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

عروض الأسعار

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

شلال

ستحتاج إلى مفتاح Reporting API في Mintegral لإعداد رقم تعريف الوحدة الإعلانية في "إدارة الإعلانات". انتقِل إلى الحساب > أدوات واجهة برمجة التطبيقات. سجِّل 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 في واجهة مستخدم "إدارة الإعلانات"

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

Android

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

iOS

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

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

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

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

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

أضِف التبعية التالية مع أحدث إصدارَين من حزمة تطوير البرامج (SDK) ومحوّل Mintegral في ملف 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: اختبار عملية الإعداد

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

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

للحصول على إعلانات 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.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