يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل إعلانات من Mintegral وعرضها باستخدام التوسّط، بما في ذلك عمليات دمج عروض الأسعار والعرض الإعلاني بدون انقطاع. كما تتناول كيفية إضافة Mintegral إلى إعدادات توسّط الوحدة الإعلانية، وكيفية دمج حزمة Mintegral SDK ومحوّلها في Flutter تطبيق.
عمليات الدمج وأشكال الإعلانات المتوافقة
يوفّر AdMob محوّل التوسّط لـ Mintegral الإمكانات التالية:
الدمج | ||
---|---|---|
عروض الأسعار | 1 | |
شلال | 2 | |
التنسيقات | ||
فتح التطبيق | 1 2 | |
بانر | ||
إعلان بيني | ||
تم منح المكافأة | ||
الإعلانات البينية التي تضم مكافأة | ||
مدمجة مع المحتوى | 1 3 |
1 تتوفّر عملية دمج عروض الأسعار لهذا الشكل في إصدار تجريبي مغلق.
2 تكون عملية دمج العرض الإعلاني بدون انقطاع لهذا التنسيق في الإصدار التجريبي المغلق.
3 تكون عملية دمج العرض الإعلاني بدون انقطاع لهذا التنسيق في إصدار تجريبي مفتوح.
المتطلّبات
- أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android:
- المستوى 21 من واجهة برمجة تطبيقات Android أو أعلى
- للنشر على iOS:
- هدف نشر iOS هو 12.0 أو إصدار أحدث
- مشروع Flutter قيد العمل تمت تهيئته باستخدام حزمة SDK لإعلانات Google على الأجهزة الجوّالة. يمكنك الاطّلاع على البدء للحصول على مزيد من التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: ضبط الإعدادات في واجهة مستخدم Mintegral
اشترِك أو سجِّل الدخول إلى حسابك على Mintegral.
تحديد موقع مفتاح التطبيق
انتقِل إلى علامة التبويب إعدادات التطبيق ودوِّن مفتاح التطبيق.
إضافة تطبيق جديد
من علامة التبويب إعدادات التطبيق، انقر على زر إضافة تطبيق.
اختَر النظام الأساسي واملأ بقية النموذج. انقر بعد ذلك على حفظ.
Android
iOS
دوِّن APP ID لتطبيقك.
Android
iOS
إنشاء موضع إعلان
بعد إنشاء طلبك، انتقِل إلى علامة التبويب مواضع الإعلانات والوحدات وانقر على الزر إضافة موضع إعلان كما هو موضّح أدناه لإنشاء موضع إعلانك.
Android
iOS
أدخِل اسم موضع الإعلان وشكل الإعلان.
عروض الأسعار
اختَر عرض الأسعار مسبقًا باعتباره نوع عرض السعر. املأ باقي النموذج وانقر على حفظ
شلال
اختَر تقليدي باعتباره نوع عرض السعر. املأ ما تبقّى من النموذج وانقر على حفظ.
بعد إنشاء موضع الإعلان، دوِّن رقم تعريف موضع الإعلان.
Android
iOS
انقر على القائمة المنسدلة وحدة إعلانية واحدة ودوِّن رقم تعريف الوحدة الإعلانية.
Android
iOS
تحديد موقع مفتاح واجهة برمجة التطبيقات Mintegral Reporting API
عروض الأسعار
هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
ستحتاج إلى مفتاح واجهة برمجة التطبيقات Mintegral Reporting API لإعداد AdMob رقم تعريف الوحدة الإعلانية. انتقل إلى الحساب > أدوات واجهة برمجة التطبيقات. دوِّن المفتاح والسر.
الخطوة 2: إعداد طلب Mintegral في AdMob واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة Mintegral إلى قائمة شركاء الإعلانات الذين يخضعون للّائحة العامة لحماية البيانات (GDPR) ولوائح الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة Mintegral إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في 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 (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 على الأجهزة الجوّالة واختباره باستخدام الإصدار 5.1.0.