يوضّح لك هذا الدليل كيفية استخدام 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.0 أو إصدار أحدث
- مشروع 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
تحديد موقع مفتاح Reporting API في Mintegral
عروض الأسعار
هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
عرض إعلاني بدون انقطاع
ستحتاج إلى مفتاح Reporting API في Mintegral لإعداد رقم تعريف الوحدة الإعلانية في 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: استيراد حزمة 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: اختبار عملية الإعداد
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في 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 | عرضت حزمة SDK من Mintegral خطأ تعذُّر عرض الإعلان. |
iOS
| رمز الخطأ | النطاق | السبب |
|---|---|---|
| 101 | com.google.mediation.mintegral | معلّمات الخادم غير صالحة (مثل رقم تعريف التطبيق أو رقم تعريف موضع الإعلان غير متوفّرَين) |
| 102 | com.google.mediation.mintegral | عرضت حزمة SDK من Mintegral خطأ تعذُّر عرض الإعلان. |
| 103 | com.google.mediation.mintegral | تعذّر على حزمة SDK من Mintegral عرض إعلان. |
| 104 | com.google.mediation.mintegral | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع Mintegral. |
سجلّ التغييرات في محوّل التوسّط في Mintegral Flutter
الإصدار 2.1.0
- تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1.
- تم التعديل لدعم مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 8.0.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 17.1.41.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 8.1.1.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 8.0.0.
الإصدار 2.0.3
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 17.0.61.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 8.0.5.1.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 7.0.0.
الإصدار 2.0.2
- تم تعديل الحد الأدنى لإصدار Flutter إلى 3.35.1
- تم التعديل لدعم مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 7.0.0
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 17.0.41.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 8.0.4.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 6.0.0.
الإصدار 2.0.1
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 17.0.31.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 8.0.3.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 6.0.0.
الإصدار 2.0.0
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 17.0.21.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 8.0.2.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 6.0.0.
الإصدار 1.2.6
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 16.9.91.1.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 7.7.9.1.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 6.0.0.
الإصدار 1.2.5
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 16.9.91.1.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 7.7.9.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 6.0.0.
الإصدار 1.2.4
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 16.9.91.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 7.7.9.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 6.0.0.
الإصدار 1.2.3
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 16.9.71.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 7.7.8.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 6.0.0.
الإصدار 1.2.2
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 16.9.71.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 7.7.7.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 6.0.0.
الإصدار 1.2.1
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 16.9.61.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 7.7.7.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 6.0.0.
الإصدار 1.2.0
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 16.9.41.1.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 7.7.7.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 5.3.1.
الإصدار 1.1.0
- المكوّن الإضافي لنظام التشغيل iOS هو الآن إطار عمل ثابت.
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 16.8.61.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 7.7.5.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 5.3.1.
الإصدار 1.0.0
- الإصدار الأوّلي.
- يتوافق مع محوّل Mintegral لنظام التشغيل Android الإصدار 16.7.21.0.
- يتوافق مع محوّل Mintegral لنظام التشغيل iOS الإصدار 7.6.3.0.
- تمت عملية الإنشاء والاختبار باستخدام مكوّن Flutter الإضافي لـ Google Mobile Ads الإصدار 5.1.0.