يوضّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من InMobi باستخدام التوسّط، ويشمل ذلك دمج كلّ من العرض الإعلاني بدون انقطاع وعروض الأسعار. ويتناول كيفية إضافة InMobi إلى إعدادات التوسط لإحدى الوحدات الإعلانية، وكيفية دمج حزمة InMobi SDK وأداة التكيّف في أحد التطبيقات. Flutter
أشكال الإعلانات وعمليات الدمج المتوافقة
التكامل | |
---|---|
عروض الأسعار | 1 |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة | |
مدمجة مع المحتوى | 2 |
1 لا تزال عملية دمج عروض الأسعار في وضع تجريبي مفتوح.
2 لا تتوفّر هذه الميزة إلا لميزة توسّط العرض الإعلاني بدون انقطاع.
المتطلبات
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android
- المستوى 21 أو إصدار أحدث من واجهة برمجة التطبيقات لنظام التشغيل Android
- للنشر على أجهزة iOS
- إصدار 10.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
- مشروع Flutter عامل يتم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". اطّلِع على البدء لمعرفة التفاصيل.
- أكمِل دليل البدء الخاص بالتوسّط.
الخطوة 1: إعداد الإعدادات في واجهة مستخدم InMobi
اشترِك للحصول على حساب على InMobi. عند إنشاء حساب، اترك الخيار استخدام منصّة عرض الإعلانات InMobi مع عروض الأسعار المفتوحة من Google بدون وضع علامة عليه.
بعد إثبات ملكية حسابك، سجِّل الدخول.
إضافة تطبيق
لإضافة تطبيقك إلى لوحة بيانات InMobi، انقر على المستودع > إعدادات المستودع .
انقر على إضافة مستودع واختر قناة تطبيق الجوّال من القائمة المنسدلة.
ابدأ في كتابة عنوان URL متجر التطبيقات الذي نشرته في شريط البحث واختَر التطبيق من النتائج التي تتم تعبئتها تلقائيًا. انقر على متابعة.
إذا لم يكن تطبيقك منشورًا، انقر على الربط يدويًا وأدخِل التفاصيل المطلوبة. انقر على متابعة.
راجع إعدادات امتثال التطبيقات والمواقع الإلكترونية، ثم انقر على حفظ مواضع الإعلانات وإنشاؤها.
مواضع الإعلانات
بعد إعداد مستودعك، سيعيد النظام توجيهك إلى سير عمل إنشاء موضع الإعلان.
عروض الأسعار
اختَر نوع الوحدة الإعلانية. أدخِل اسم موضع الإعلان، واختَر تفعيل وعروض الأسعار المفتوحة من Google لكلٍّ من عروض أسعار الجمهور والشريك على التوالي، ثمّ املأ باقي النموذج. انقر على إنشاء موضع إعلان عند الانتهاء.
شلال
اختَر نوع الوحدة الإعلانية. بعد ذلك، أدخِل اسم موضع الإعلان، واختَر إيقاف عروض أسعار الجمهور، واملأ بقية النموذج. انقر على إنشاء موضع إعلان عند الانتهاء.
بعد إنشاء موضع الإعلان، يتم عرض تفاصيله. سجِّل معرّف موضع الإعلان الذي سيتم استخدامه لإعداد وحدتك الإعلانية على AdMob.
رقم تعريف الحساب
يتوفّر رقم تعريف حسابك على InMobi ضمن المالية > إعدادات الدفع > معلومات الدفع.
العثور على مفتاح واجهة برمجة التطبيقات InMobi Reporting API
عروض الأسعار
وهذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
انتقِل إلى حسابي > إعدادات الحساب. انتقِل إلى علامة التبويب مفتاح واجهة برمجة التطبيقات وانقر على إنشاء مفتاح واجهة برمجة التطبيقات.
اختَر عنوان البريد الإلكتروني للمستخدم المطلوب إنشاء المفتاح له، ثم انقر على إنشاء مفتاح واجهة برمجة التطبيقات. سيتم إنشاء ملف يحتوي على مفتاح واجهة برمجة التطبيقات واسم المستخدم/اسم تسجيل الدخول .
لن يتمكّن سوى مشرف الناشر للحساب من إنشاء مفتاح واجهة برمجة التطبيقات لجميع المستخدمين. إذا نسيت مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه سابقًا، يمكنك إعادة ضبط مفتاح واجهة برمجة التطبيقات من خلال تمرير مؤشر الماوس فوق بريدك الإلكتروني في علامة التبويب مفتاح واجهة برمجة التطبيقات.
تفعيل وضع الاختبار
فعِّل وضع الاختبار لموضع إعلانك في جميع مرّات الظهور المباشرة أو على أجهزة اختبار معيّنة فقط.
الخطوة 2: إعداد طلب InMobi في AdMob واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة InMobi إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات "اللائحة العامّة لحماية البيانات" (GDPR) و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة InMobi إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية في واجهة مستخدِم AdMob.
الخطوة 3: استيراد حِزم تطوير البرامج (SDK) ومحوِّل InMobi
الدمج من خلال pub.dev
أضِف التبعية التالية مع أحدث إصدارات
InMobi حزمة SDK والمحوِّل في ملف
pubspec.yaml
الحزمة:
dependencies:
gma_mediation_inmobi: ^1.0.0
الدمج اليدوي
نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة لنظام التشغيل
InMobi،
واسحب الملف الذي تم تنزيله، وأضِف مجلد المكوّن الإضافي المُستخرَج
(ومحتوياته) إلى مشروع Flutter. بعد ذلك، يمكنك الإشارة إلى المكوّن الإضافي في ملف
pubspec.yaml
عن طريق إضافة التبعية التالية:
dependencies:
gma_mediation_inmobi:
path: path/to/local/package
الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة تطوير البرامج (SDK) من InMobi
موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامّة لحماية البيانات"
بموجب سياسة موافقة المستخدِم في الاتّحاد الأوروبي المتّبَعة في Google، عليك التأكّد من تقديم بيانات الإفصاح المعيّنة إلى المستخدِمين في المنطقة الاقتصادية الأوروبية والحصول على موافقاتهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تراعي هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR). عند طلب الموافقة، عليك تحديد كل شبكة إعلانية في سلسلة التوسّط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، و تقديم معلومات عن استخدام كل شبكة. يتعذّر على Google حاليًا تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
لا يتيح المكوّن الإضافي لوسيط إعلانات Google على الأجهزة الجوّالة في InMobi تمرير معلومات الموافقة إلى حزمة SDK من InMobi.
قوانين الخصوصية في الولايات الأمريكية
قوانين الخصوصية في الولايات الأمريكية تتطلّب منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن لا يمكن لشركة Google تطبيق هذا الإعداد على كل شبكة إعلانية في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة مواقع إعلانية في سلسلة التوسّط التي قد تشارك في بيع المَعلومات الشخصية واتباع الإرشادات الواردة من كلّ من هذه الشبكات لضمان الامتثال.
لا يتيح المكوّن الإضافي لوسيط إعلانات Google على الأجهزة الجوّالة في InMobi تمرير معلومات الموافقة إلى حزمة SDK من InMobi.
الخطوة 5: إضافة الرمز الإضافي المطلوب
Android
لا يلزم إدخال رمز إضافي لدمج InMobi.
iOS
دمج SKAdNetwork
اتّبِع مستندات
InMobi
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist
في مشروعك.
الخطوة 6: اختبار عملية التنفيذ
تفعيل الإعلانات الاختبارية
تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم InMobi.
إثبات صحة الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من InMobi، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصدرَي الإعلانات InMobi (عروض الأسعار) وInMobi (العرض بدون انقطاع).
خطوات اختيارية
Android
الأذونات
ولتحقيق الأداء الأمثل، تقترح InMobi إضافة الأذونات الاختيارية
التالية إلى ملف AndroidManifest.xml
في تطبيقك.
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
يمكنك اختياريًا إضافة هذه الأذونات إلى ملف
Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml
.
iOS
ما مِن خطوات إضافية مطلوبة لدمج iOS.
رموز الخطأ
إذا تعذّر على المُحوِّل تلقّي إعلان من InMobi، يمكن للناشرين التحقّق من
الخطأ الأساسي من استجابة الإعلان باستخدام
ResponseInfo
ضمن
الفئات التالية:
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل InMobi عند تعذُّر تحميل أحد الإعلانات:
Android
رمز الخطأ | السبب |
---|---|
0-99 | أخطاء حزمة تطوير البرامج (SDK) من InMobi اطّلِع على الرمز للحصول على مزيد من التفاصيل. |
100 | مَعلمات خادم InMobi التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة أو غير صالحة. |
101 | تعذّر إعداد حزمة تطوير البرامج (SDK) من InMobi. |
102 | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع InMobi. |
103 | طلب الإعلان ليس طلب إعلان مدمجًا مع المحتوى موحّدًا. |
104 | تمّت محاولة طلب إعلان InMobi بدون إعداد حزمة تطوير البرامج (SDK) من InMobi. من المفترض أنّه لن يحدث ذلك أبدًا نظريًا لأنّ المحوِّل يُنشئ حزمة تطوير البرامج (SDK) لـ InMobi قبل طلب إعلانات InMobi. |
105 | إعلان InMobi غير جاهز للعرض بعد. |
106 | تعذّر على InMobi عرض إعلان. |
107 | عرضت InMobi إعلانًا مضمّنًا لا يتضمّن مادة عرض مطلوبة. |
108 | تحتوي مواد عرض صور الإعلانات المدمجة مع المحتوى في InMobi على عنوان URL مكتوب بشكلٍ غير صحيح. |
109 | تعذّر على المُحوِّل تنزيل مواد عرض الصور الإعلانية الأصلية من InMobi. |
iOS
رمز الخطأ | السبب |
---|---|
101 | مَعلمات خادم InMobi التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة أو غير صالحة. |
102 | لا يتيح محوّل InMobi استخدام شكل الإعلان المطلوب. |
103 | سبق أن تم تحميل إعلان InMobi لإعدادات الشبكة هذه. |
غير ذلك | عرَض حِزم تطوير البرامج (SDK) من InMobi خطأً. يُرجى الاطّلاع على IMRequestStatus.h لمزيد من التفاصيل. |
سجلّ التغييرات في محوِّل التوسّط في InMobi Flutter
النسخة التالية
- تم إنشاؤه واختباره باستخدام الإصدار 5.2.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".
1.1.0
- تم التحقّق من التوافق مع الإصدار 10.7.5.0 من محوِّل Android في InMobi.
- تم التحقّق من التوافق مع الإصدار 10.7.5.0 من محوِّل InMobi لنظام التشغيل iOS.
- تم إنشاؤه واختباره باستخدام الإصدار 5.1.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".
1.0.0
- الإصدار الأولي.
- تم التحقّق من التوافق مع الإصدار 10.6.7.1 من محوّل InMobi المتوافق مع Android.
- تم التحقّق من التوافق مع الإصدار 10.7.2.0 من محوِّل InMobi لنظام التشغيل iOS.
- تم إنشاء هذا البرنامج واختباره باستخدام الإصدار 5.1.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.