يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من InMobi باستخدام التوسّط التي تغطي عمليات دمج كلّ من العرض الإعلاني بدون انقطاع وعروض الأسعار يتناول كيفية إضافة InMobi إلى تهيئة التوسط لوحدة إعلانية وكيفية دمج حزمة InMobi SDK محوّل في Unity تطبيق.
أشكال الإعلانات وعمليات الدمج المتوافقة
الدمج | |
---|---|
عروض الأسعار | 1 |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة |
1 تم إغلاق عملية دمج عروض الأسعار. تجريبيًا، يُرجى التواصل مع مدير حسابك لطلب الإذن بالوصول.
المتطلبات
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- Unity 4 أو إصدار أحدث
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 10.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Unity عامل تم إعداده باستخدام Google SDK لإعلانات الأجهزة الجوّالة. عرض البدء لمعرفة التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم InMobi
الخطوة 2: إعداد طلبات InMobi في واجهة المستخدم AdMob
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة InMobi إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوّل InMobi
تنزيل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في InMobi
من رابط التنزيل في
سجلّ التغييرات واستخراجه
GoogleMobileAdsInMobiMediation.unitypackage
من ملف ZIP.
في محرِّر مشروعات Unity، اختَر مواد العرض >. استيراد الحزمة > مُخَصَّصْ
الحزمة واختَر الملف GoogleMobileAdsInMobiMediation.unitypackage
الذي تريد
تم تنزيله. تأكَّد من اختيار كل الملفات وانقر على استيراد.
بعد ذلك، اختَر مواد العرض >. محلل خدمات Play > محلل Android > القوة
حلّ المشكلة ستنفّذ مكتبة "أداة حل خدمات Unity Play" الاعتمادية
من البداية ونسخ التبعيات المعلنة إلى
الدليل Assets/Plugins/Android
لتطبيق Unity
الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة InMobi SDK
موافقة المستخدمين في الاتحاد الأوروبي واللائحة العامة لحماية البيانات
بموجب موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google السياسة، يجب التأكّد من الإفصاح عن معلومات معيّنة الموافقات التي تم الحصول عليها من المستخدمين في المنطقة الاقتصادية الأوروبية في ما يتعلق استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية و"حماية البيانات العامة" اللائحة (اللائحة العامة لحماية البيانات). عند طلب الحصول على موافقة، عليك تحديد كل شبكة إعلانات. في سلسلة التوسط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها تقدم معلومات حول استخدام كل شبكة. يتعذّر على Google حاليًا إجراء ما يلي: تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
أضاف المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة للإصدار 2.1.0 من InMobi
طريقة واحدة (InMobi.UpdateGDPRConsent()
) تتيح لك نقل معلومات الموافقة إلى
InMobi. يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة إلى
حزمة تطوير البرامج (SDK) لـ InMobi إذا اخترت استدعاء هذه الطريقة، فنوصيك بالقيام بذلك قبل
إلى طلب الإعلانات باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
using GoogleMobileAds.Api.Mediation.InMobi;
using System.Collections.Generic;
// ...
Dictionary<string, string> consentObject = new Dictionary<string, string>();
consentObject.Add("gdpr_consent_available", "true");
consentObject.Add("gdpr", "1");
InMobi.UpdateGDPRConsent(consentObject);
الاطّلاع على تنفيذ اللائحة العامة لحماية البيانات في InMobi التفاصيل لمزيد من المعلومات عن المفاتيح والقيم المحتملة التي تقبلها InMobi عنصر الموافقة هذا
قوانين الخصوصية في الولايات الأمريكية
الولايات المتحدة قوانين الخصوصية السارية في الولايات تتطلب منح المستخدمين لإيقاف "التخفيضات" "معلوماتهم الشخصية" (كما يحدّد القانون هذه البنود)، مع ميزة الإيقاف المتوفرة من خلال ميزة "عدم بيع بياناتي الشخصية" المعلومات" حول "البيع" للصفحة الرئيسية. تشير رسالة الأشكال البيانية الولايات المتحدة خصوصية الولايات دليل الامتثال للقوانين إمكانية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن يتعذّر على Google تطبيق هذا الإعداد على كل إعلان الشبكة في سلسلة التوسط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسط التي قد تشارك في بيع البضائع المعلومات واتباع الإرشادات من كل شبكة من تلك الشبكات للتأكد الامتثال.
شاهد InMobi مستندات قانون خصوصية المستهلك في كاليفورنيا (CCPA) للحصول على إرشادات حول كيفية تفعيل إعدادات قانون خصوصية المستهلك في كاليفورنيا (CCPA) لتطبيق InMobi.
الخطوة 5: إضافة الرمز الإضافي المطلوب
Android
ما مِن رمز إضافي مطلوب دمج InMobi.
iOS
دمج SKAdNetwork
تابع InMobis
المستندات
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist
الخاص بمشروعك.
الخطوة 6: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم InMobi .
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من InMobi، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام InMobi (Bidding) and InMobi (Waterfall) مصادر الإعلانات.
خطوات اختيارية
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 لإعداد الشبكة هذه. |
غير ذلك | عرَضَ InMobi SDK خطأً. لمزيد من التفاصيل، يُرجى الانتقال إلى IMRequestStatus.h . |
سجلّ تغييرات المكوّن الإضافي لتوسّط Unity InMobi
الإصدار 4.6.3
- تمت إعادة تسمية "
DummyClient
" إلى "PlaceholderClient
". - يتوافق مع الإصدار 10.7.5.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.7.4.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.2.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.6.2
- يتوافق مع الإصدار 10.7.4.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.7.4.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.6.1
- يتوافق مع الإصدار 10.7.4.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.7.2.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.6.0
- يتوافق مع الإصدار 10.7.3.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.7.2.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.5.1
- يتوافق مع الإصدار 10.6.7.1 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.7.2.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.5.0
- يتوافق مع الإصدار 10.6.7.1 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.7.1.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذا المكوِّن واختباره باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.4.1
- يتوافق مع الإصدار 10.6.2.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.6.0.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.6.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.4.0
- يتوافق مع الإصدار 10.6.0.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.6.0.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.6.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.3.3
- يتوافق مع الإصدار 10.5.8.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.5.8.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.5.2 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.3.0
- تم نقل محتوى المحوّل إلى
GoogleMobileAds/Mediation/InMobi/
. - تمت إعادة ضبط مساحة الاسم للمهايئ لاستخدام
GoogleMobileAds.Mediation.InMobi
. - يتوافق مع الإصدار 10.5.4.1 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.5.4.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.2.2
- يتوافق مع الإصدار 10.1.2.1 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.1.2.1 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.3.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.2.1
- يتوافق مع الإصدار 10.1.2.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.1.2.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.3.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.2.0
- يتوافق مع الإصدار 10.1.1.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.1.1.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.3.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.1.0
- يتوافق مع الإصدار 10.0.9.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.1.0.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.3.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.0.4
- يتوافق مع الإصدار 10.0.7.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.0.7.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.2 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.0.3
- يتوافق مع الإصدار 10.0.5.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.0.5.0 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.0.2
- يتوافق مع الإصدار 10.0.3.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.0.2.1 من محوّل InMobi بنظام iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.0.1
- يتوافق مع الإصدار 10.0.3.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.0.2.0 من محوّل InMobi بنظام iOS.
الإصدار 4.0.0
- يتوافق مع الإصدار 10.0.1.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 10.0.1.0 من محوّل InMobi بنظام iOS.
الإصدار 3.2.0
- يتوافق مع الإصدار 9.2.0.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 9.2.1.0 من محوّل InMobi بنظام iOS.
الإصدار 3.1.2
- يتوافق مع الإصدار 9.1.9.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 9.1.7.0 من محوّل InMobi بنظام iOS.
الإصدار 3.1.1
- يتوافق مع الإصدار 9.1.1.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 9.1.1.0 من محوّل InMobi بنظام iOS.
الإصدار 3.1.0
- يتوافق مع الإصدار 9.1.0.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 9.1.0.0 من محوّل InMobi بنظام iOS.
الإصدار 3.0.3
- يتوافق مع الإصدار 9.0.7.1 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 9.0.7.2 من محوّل InMobi بنظام iOS.
الإصدار 3.0.2
- يتوافق مع الإصدار 9.0.7.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 9.0.7.0 من محوّل InMobi بنظام iOS.
الإصدار 3.0.1
- يتوافق مع الإصدار 9.0.6.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 9.0.7.0 من محوّل InMobi بنظام iOS.
الإصدار 3.0.0
- يتوافق مع الإصدار 9.0.4.0 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 9.0.4.0 من محوّل InMobi بنظام iOS.
الإصدار
- يتوافق مع الإصدار 7.3.0.1 من محوّل InMobi المتوافق مع Android.
- يتوافق مع الإصدار 7.4.0.0 من محوّل InMobi بنظام iOS.
الإصدار 2.3.0
- يتوافق مع الإصدار 7.2.9.0 من محوّل Android.
- يتوافق مع الإصدار 7.3.2.0 من محوّل iOS.
الإصدار 2.2.2
- تم تحديث المكوّن الإضافي لإتاحة Rewards API الجديدة.
- يتوافق مع الإصدار 7.2.7.0 من محوّل Android.
- يتوافق مع الإصدار 7.2.7.0 من محوّل iOS.
الإصدار 2.2.1
- يتوافق مع الإصدار 7.2.2.0 من محوّل Android.
- يتوافق مع الإصدار 7.2.4.0 من محوّل iOS.
الإصدار 2.2.0
- يتوافق مع الإصدار 7.2.1.0 من محوّل Android.
- يتوافق مع الإصدار 7.2.0.0 من محوّل iOS.
الإصدار 2.1.2
- يتوافق مع الإصدار 7.1.1.1 من محوّل Android.
- يتوافق مع الإصدار 7.1.2.0 من محوّل iOS.
الإصدار 2.1.1
- يتوافق مع الإصدار 7.1.1.1 من محوّل Android.
- يتوافق مع الإصدار 7.1.1.2 من محوّل iOS.
الإصدار
- يتوافق مع الإصدار 7.1.0.0 من محوّل Android.
- يتوافق مع الإصدار 7.1.1.1 من محوّل iOS.
- تمت إضافة الطريقة
InMobi.UpdateGDPRConsent()
.
الإصدار 2.0.0
- يتوافق مع الإصدار 7.0.4.0 من محوّل Android.
- يتوافق مع الإصدار 7.1.1.0 من محوّل iOS.
الإصدار 1.0.0
- الإصدار الأول!
- يتيح استخدام الإصدار 6.2.4.0 من محوّل Android.
- يتوافق مع الإصدار 6.2.1.0 من محوّل iOS.