يوضِّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل تحميل الإعلانات وعرضها من InMobi باستخدام التوسّط، والتي تغطي عمليات دمج عروض الأسعار والعرض الإعلاني بدون انقطاع. حيث يتناول كيفية إضافة InMobi إلى تهيئة توسط الوحدة الإعلانية، وكيفية دمج أداة InMobi SDK ومعدِّله في تطبيق Unity.
عمليات الدمج وأشكال الإعلانات المتوافقة
الدمج | |
---|---|
عروض الأسعار | 1 |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة |
1 ميزة دمج عروض الأسعار في الإصدار التجريبي المغلق يُرجى التواصل مع مدير حسابك لطلب الوصول.
المتطلّبات
- Unity 4 أو أعلى
- أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
- للنشر على Android:
- المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android
- للنشر على iOS:
- هدف نشر iOS هو 10.0 أو أحدث
- مشروع Unity عملي تم إعداده باستخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على مزيد من التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة الأولى: ضبط الإعدادات في واجهة مستخدم InMobi
اشترِك للحصول على حساب InMobi.
عروض الأسعار
اختر استخدام InMobi SSP مع عرض الأسعار المفتوح من Google وأدخِل الرقم التعريفي للناشر في Google.
شلال
ليس عليك اتّخاذ أي خطوة إضافية لعمليات دمج العرض الإعلاني بدون انقطاع.
سجِّل الدخول إلى حسابك على InMobi بعد إثبات ملكيته.
إضافة تطبيق
لإضافة تطبيقك إلى لوحة بيانات InMobi، انقر على المستودع > إعدادات المستودع.
انقر على إضافة مستودع واختَر قناة تطبيق متوافق مع الأجهزة الجوّالة من القائمة المنسدلة.
ابدأ بكتابة عنوان URL لمتجر التطبيقات المنشور في شريط البحث واختَر التطبيق من النتائج التي تتم تعبئتها تلقائيًا. انقر على متابعة
إذا لم يتم نشر تطبيقك، انقر على الربط يدويًّا وأدخِل التفاصيل المطلوبة. انقر على متابعة
راجع إعدادات الامتثال للتطبيقات والمواقع الإلكترونية، ثم انقر على حفظ وإنشاء مواضع إعلان.
مواضع الإعلانات
بعد إعداد المستودع، يُعيد النظام توجيهك إلى سير عمل إنشاء موضع الإعلان.
عروض الأسعار
اختَر نوع الوحدة الإعلانية. أدخِل اسم موضع الإعلان، واختَر تفعيل وعرض الأسعار المفتوح من Google لكلٍّ من عروض أسعار الجمهور والشريك على التوالي، واملأ بقية النموذج. انقر على إنشاء موضع عند الانتهاء.
شلال
اختَر نوع الوحدة الإعلانية. بعد ذلك، أدخِل اسم موضع الإعلان واختَر إيقاف إلى جانب عروض أسعار الجمهور، واملأ بقية النموذج. انقر على إنشاء موضع عند الانتهاء.
وبعد إنشاء موضع الإعلان، تظهر تفاصيله. دوِّن رقم تعريف موضع الإعلان الذي سيُستخدَم لإعداد AdMob وحدتك الإعلانية.
رقم تعريف الحساب
ويتوفر رقم تعريف حسابك على InMobi ضمن الشؤون المالية > إعدادات الدفع > معلومات الدفع.
تحديد موقع مفتاح واجهة برمجة التطبيقات InMobi Reporting API
عروض الأسعار
هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
انتقل إلى حسابي > إعدادات الحساب. انتقِل إلى علامة التبويب مفتاح واجهة برمجة التطبيقات وانقر على إنشاء مفتاح واجهة برمجة التطبيقات.
اختَر البريد الإلكتروني للمستخدم الذي يتطلب إنشاء المفتاح له وانقر على إنشاء مفتاح واجهة برمجة التطبيقات. سيتم إنشاء ملف يحتوي على مفتاح واجهة برمجة التطبيقات واسم المستخدم أو معلومات تسجيل الدخول.
لن يتمكن أحد سوى مشرف الحساب من إنشاء مفتاح واجهة برمجة التطبيقات لجميع المستخدمين. إذا نسيت مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه سابقًا، يمكنك إعادة ضبط مفتاح واجهة برمجة التطبيقات من خلال التمرير فوق بريدك في علامة التبويب مفتاح واجهة برمجة التطبيقات.
تفعيل وضع الاختبار
فعِّل وضع الاختبار لموضع الإعلان على جميع مرات الظهور المباشرة أو بعض أجهزة الاختبار فقط.
الخطوة 2: إعداد طلب InMobi في AdMob واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة InMobi إلى قائمة شركاء الإعلانات الذين يخضعون للّائحة العامة لحماية البيانات (GDPR) ولوائح الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة InMobi إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في AdMob واجهة المستخدم.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوّل InMobi
نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في InMobi
من رابط التنزيل في
سجلّ التغييرات واستخرج
GoogleMobileAdsInMobiMediation.unitypackage
من ملف zip.
في محرر مشروع Unity، حدد Assets >Import Package > Custom
Package وحدد الملف GoogleMobileAdsInMobiMediation.unitypackage
الذي قمت بتنزيله. تأكَّد من اختيار جميع الملفات وانقر على استيراد.
بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android > فرض الحل. ستنفِّذ مكتبة أداة حلّ المشاكل في Unity Play Services حل التبعية من البداية،
وتنسخ التبعيات المُعلَن عنها إلى
دليل Assets/Plugins/Android
في تطبيق Unity.
الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة InMobi SDK
موافقة المستخدمين في الاتحاد الأوروبي واللائحة العامة لحماية البيانات
بموجب سياسة موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google، عليك التأكّد من الإفصاح عن معلومات محدّدة للمستخدمين في المنطقة الاقتصادية الأوروبية والحصول على موافقات منهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR) في الاتّحاد الأوروبي. عند طلب الحصول على موافقة، يجب عليك تحديد كل شبكة إعلانات في سلسلة التوسط قد تجمع البيانات الشخصية أو تتلقاها أو تستخدمها، وتقدم معلومات عن استخدام كل شبكة. ولا يمكن لشركة 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 تطبيق هذا الإعداد على كل شبكة إعلانات في سلسلة التوسّط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية واتّباع الإرشادات من كل شبكة من هذه الشبكات لضمان الامتثال لها.
اطّلِع على مستندات CCPA الخاصة بـ InMobi للحصول على إرشادات حول كيفية تفعيل إعدادات CCPA لبرنامج InMobi.
الخطوة 5: إضافة الرمز الإضافي المطلوب
Android
ليس من المطلوب استخدام رمز إضافي لدمج InMobi.
iOS
دمج SKAdNetwork
اتّبِع مستندات
InMobi
لإضافة معرّفات 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 | أخطاء InMobi SDK اطّلِع على الرمز البرمجي لمزيد من التفاصيل. |
100 | مَعلمات خادم InMobi التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة أو غير صالحة. |
101 | تعذّر إعداد حزمة تطوير البرامج (SDK) لخدمة InMobi. |
102 | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع InMobi. |
103 | طلب الإعلان ليس طلبًا موحدًا لإعلان مدمج مع المحتوى. |
104 | تمت محاولة طلب إعلان InMobi بدون إعداد حزمة تطوير البرامج (SDK) لخدمة InMobi. من المفترض ألّا يحدث هذا من الناحية النظرية أبدًا لأنّ المحوّل أعدّ حزمة تطوير برامج 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 . |
سجلّ تغييرات المكوّن الإضافي لتوسّط Unity من InMobi
الإصدار 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 على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.0.2.
الإصدار 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.
الإصدار 2.4.0
- يتوافق مع الإصدار 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
- تم تحديث المكوّن الإضافي للتوافق مع واجهة برمجة التطبيقات الجديدة التي تضم مكافآت.
- يتوافق الجهاز مع الإصدار 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.
الإصدار 2.1.0
- يتوافق الجهاز مع الإصدار 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.