يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads Flutter Plugin من أجل تحميل الإعلانات وعرضها من myTarget باستخدام التوسّط، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة myTarget إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل myTarget في تطبيق Flutter.
عمليات الدمج وأشكال الإعلانات المتوافقة
| التكامل | |
|---|---|
| عروض الأسعار | |
| عرض إعلاني بدون انقطاع | |
| التنسيقات | |
| بانر | |
| إعلان بيني | |
| تمت المكافأة | |
| إعلان بيني مقابل مكافأة | |
| مدمج مع المحتوى | |
المتطلبات الأساسية
قبل المتابعة، يُرجى التأكّد ممّا يلي:
- أحدث إصدار من Google Mobile Ads Flutter Plugin
- الإصدار 3.7.0 أو إصدار أحدث من إطار عمل Flutter
- للنشر على Android
- المستوى 23 من واجهة برمجة التطبيقات في Android أو الإصدارات الأحدث
- للنشر على أجهزة iOS
- الإصدار 13.0 من نظام التشغيل iOS أو إصدار أحدث
- مشروع Flutter يعمل تم إعداده باستخدام Google Mobile Ads Flutter Plugin لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Flutter Plugin.
- إعداد ميزة "توسّط AdMob"
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم myTarget
سجِّل الدخول إلى حسابك على myTarget. انتقِل إلى صفحة "التطبيقات" من خلال النقر على التطبيقات في العنوان. أضِف تطبيقك من خلال النقر على إضافة تطبيق.
إذا كان تطبيقك متوافقًا مع نظامَي التشغيل Android وiOS، عليك إعداد كل نظام على حدة.
Android
بعد ذلك، قدِّم عنوان URL على Google Play لتطبيقك.
iOS
بعد ذلك، أدخِل عنوان URL على iTunes** لتطبيقك.
عند إضافة تطبيق، يطلب منك myTarget إنشاء وحدة إعلانية قبل إكمال العملية.
بانر
اختَر إعلان بانر من أشكال الإعلانات المتاحة، ثم انقر على زر إضافة وحدة إعلانية.
إعلان بيني
اختَر إعلان بيني من أشكال الإعلانات المتاحة، ثم انقر على زر إضافة وحدة إعلانية.
تمت المكافأة
اختَر فيديو مقابل مكافأة من أشكال الإعلانات المتاحة، ثمّ انقر على زر إضافة وحدة إعلانية.
مدمج مع المحتوى
اختَر مدمج مع المحتوى من أشكال الإعلانات المتاحة، ثم انقر على إضافة وحدة إعلانية.
في صفحة تفاصيل الوحدة الإعلانية، سجِّل رقم تعريف الخانة الذي يمكن العثور عليه ضمن إعدادات الوحدة الإعلانية باسم slot_id. سيتم استخدام معرّف الخانة هذا لإعداد الوحدة الإعلانية في AdMob في القسم التالي.
بالإضافة إلى slot_id، ستحتاج أيضًا إلى رمز الدخول الدائم الخاص بمنصة myTarget لإعداد رقم تعريف الوحدة الإعلانية على AdMob. انتقِل إلى علامة التبويب الملف الشخصي واختَر رموز الدخول. انقر على إنشاء رمز مميّز أو إظهار الرمز المميز لعرض رمز الدخول الدائم الخاص بك في myTarget.
تعديل ملف app-ads.txt
مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع مساحات إعلانية متاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt.
إذا لم يسبق لك إجراء ذلك، عليك إعداد ملف app-ads.txt لتطبيقك.
لتنفيذ app-ads.txt في myTarget، يُرجى الاطّلاع على
كيفية إنشاء ملف ونشره.
تفعيل وضع الاختبار
اتّبِع التعليمات الواردة في مستندات myTarget لإضافة جهاز اختبار وضبطه في واجهة مستخدم myTarget.
الخطوة 2: إعداد طلب myTarget في واجهة مستخدم AdMob
ضبط إعدادات التوسّط للوحدة الإعلانية
Android
للحصول على التعليمات، راجِع الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة Mail.ru إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح التنظيمية السارية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية وإعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Mail.ru إلى قائمة الشركاء الإعلانيين بموجب اللوائح التنظيمية الأوروبية ولوائح الولايات الأمريكية في واجهة مستخدم AdMob.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) والمحوّل الخاصَّين بمنصة myTarget
التكامل من خلال pub.dev
أضِف الاعتمادية التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) ومحوّل myTarget في ملف pubspec.yaml الخاص بالحزمة:
dependencies:
gma_mediation_mytarget: ^1.12.0
الدمج اليدوي
نزِّل أحدث إصدار من مكوّن التوسّط الإضافي لخدمة Google Mobile Ads
myTarget،
واستخرِج الملف الذي تم تنزيله، وأضِف مجلد المكوّن الإضافي الذي تم استخراجه
(ومحتوياته) إلى مشروع Flutter. بعد ذلك، أشِر إلى المكوّن الإضافي في ملف pubspec.yaml من خلال إضافة التبعية التالية:
dependencies:
gma_mediation_mytarget:
path: path/to/local/package
الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) الخاصة بمنصة myTarget
للاطّلاع على التعليمات، يُرجى الرجوع إلى الخطوة 4 في الدليل الخاص بنظامَي التشغيل Android وiOS.
الخطوة 5: إضافة الرمز المطلوب
Android
لا يلزم استخدام رمز إضافي لدمج myTarget.
iOS
تكامل SKAdNetwork
اتّبِع مستندات
myTarget
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist في مشروعك.
الخطوة 6: اختبار عملية الإعداد
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم myTarget.
تأكيد الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من myTarget، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات myTarget (نظام العرض بدون انقطاع).
رموز الخطأ
إذا لم يتمكّن المحوّل البرمجي من تلقّي إعلان من myTarget، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام
ResponseInfo ضمن الفئات التالية:
Android
com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter
iOS
GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded
في ما يلي الرموز والرسائل المصاحبة التي يعرضها برنامج myTarget عند تعذُّر تحميل إعلان:
Android
| رمز الخطأ | السبب |
|---|---|
| 100 | عرَضت حزمة تطوير البرامج (SDK) الخاصة بمنصة myTarget خطأً. |
| 101 | مَعلمات خادم myTarget التي تم ضبطها في واجهة مستخدم AdMob غير متوفّرة أو غير صالحة. |
| 102 | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع myTarget. |
| 103 | طلب الإعلان ليس طلب عرض "إعلان مدمج مع المحتوى" موحّد. |
| 104 | يختلف الإعلان المدمج مع المحتوى الذي تم تحميله من myTarget عن الإعلان المدمج مع المحتوى المطلوب. |
| 105 | لا يتضمّن الإعلان المدمج مع المحتوى الذي تم تحميله من myTarget بعض مواد العرض المطلوبة (مثل الصورة أو الرمز). |
iOS
| رمز الخطأ | السبب |
|---|---|
| 100 | لا تتوفّر إعلانات في حزمة تطوير البرامج (SDK) الخاصة بمنصة myTarget حتى الآن. |
| 101 | مَعلمات خادم myTarget التي تم ضبطها في واجهة مستخدم AdMob غير متوفّرة أو غير صالحة. |
| 102 | لا يتوافق myTarget Adapter مع شكل الإعلان المطلوب. |
| 103 | محاولة عرض إعلان myTarget لم يتم تحميله |
| 104 | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع myTarget. |
| 105 | مواد عرض الإعلانات المدمجة مع المحتوى المطلوبة غير متوفّرة. |
سجلّ التغييرات في محوّل التوسّط لمنصة myTarget على Flutter
الإصدار 1.12.0
- يتوافق مع الإصدار 5.47.1.1 من محوّل myTarget Android.
- يتوافق مع الإصدار 5.45.0.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.11.0
- تم تعديلها لتتوافق مع الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
- يتوافق مع الإصدار 5.47.1.0 من محوّل myTarget لنظام التشغيل Android.
- يتوافق مع الإصدار 5.43.0.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.10.0
- يتوافق مع الإصدار 5.47.1.0 من محوّل myTarget لنظام التشغيل Android.
- يتوافق مع الإصدار 5.42.1.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.9.0
- تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1.
- تم التحديث لدعم الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
- يتوافق مع الإصدار 5.27.4.1 من محوّل myTarget لنظام التشغيل Android.
- يتوافق مع الإصدار 5.39.1.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.8.0
- يتوافق مع الإصدار 5.27.4.1 من محوّل myTarget لنظام التشغيل Android.
- يتوافق مع الإصدار 5.39.1.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.7.1
- تم تعديل الحد الأدنى لإصدار Flutter إلى 3.35.1
- تم تعديلها لتتوافق مع الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
- يتوافق مع الإصدار 5.27.4.0 من محوّل myTarget لنظام التشغيل Android.
- يتوافق مع الإصدار 5.38.0.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.7.0
- يتوافق مع الإصدار 5.27.4.0 من محوّل myTarget لنظام التشغيل Android.
- يتوافق مع الإصدار 5.38.0.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.6.0
- يتوافق مع الإصدار 5.27.4.0 من محوّل myTarget لنظام التشغيل Android.
- يتوافق مع الإصدار 5.37.1.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.5.0
- يتوافق مع الإصدار 5.27.3.0 من محوّل myTarget لنظام التشغيل Android.
- يتوافق مع الإصدار 5.36.0.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.4.0
- يتوافق مع الإصدار 5.27.2.0 من محوّل myTarget لنظام التشغيل Android.
- يتوافق مع الإصدار 5.33.0.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.3.0
- يتوافق مع الإصدار 5.27.1.1 من برنامج myTarget Android الإضافي.
- يتوافق مع الإصدار 5.31.1.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.2.0
- يتوافق مع الإصدار 5.27.1.1 من برنامج myTarget Android الإضافي.
- يتوافق مع الإصدار 5.29.1.0 من برنامج myTarget iOS الإضافي.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.1.0
- يتوافق مع الإصدار 5.27.1.1 من برنامج myTarget Android الإضافي.
- يتوافق مع الإصدار 5.28.0.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
الإصدار 1.0.0
- الإصدار الأوّلي.
- يتوافق مع الإصدار 5.27.1.0 من محوّل myTarget على Android.
- يتوافق مع الإصدار 5.24.1.0 من myTarget iOS adapter.
- تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.