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

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

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

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

الدمج
عروض الأسعار  1
شلال  2
التنسيقات
فتح التطبيق  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

دوِّن APP ID لتطبيقك.

Android

iOS

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

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

Android

iOS

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

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

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

Android

iOS

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

Android

iOS

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

عروض الأسعار

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

شلال

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

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

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

Android

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

iOS

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

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

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

الخطوة 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: اختبار عملية التنفيذ

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

احرص على تسجيل جهاز الاختبار من أجل Ad Manager.

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

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

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

رموز الخطأ

في حال تعذّر على المحوّل استلام إعلان من 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

1.0.0

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