يوضِّح لك هذا الدليل كيفية استخدام "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل إعلانات وعرضها من Chartboost باستخدام التوسّط، ما يشمل عمليات دمج العرض الإعلاني بدون انقطاع. يتناول كيفية إضافة Chartboost إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج المحوّل وحزمة تطوير البرامج Chartboost في تطبيق Unity.
عمليات الدمج وأشكال الإعلانات المتوافقة
يوفّر AdMob محوِّل التوسط لتطبيق Chartboost الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة |
المتطلّبات
- Unity 4 أو أعلى
- أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
- للنشر على Android:
- المستوى 21 من واجهة برمجة تطبيقات Android أو أعلى
- للنشر على iOS:
- هدف نشر iOS هو 12.0 أو إصدار أحدث
- مشروع Unity عملي تم إعداده باستخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: ضبط الإعدادات في واجهة مستخدم Chartboost
اشترِك للحصول على حساب في Chartboost وسجِّل الدخول بعد إثبات ملكية حسابك. بعد ذلك، انتقِل إلى علامة التبويب إدارة التطبيقات.
انقر على الزر إضافة تطبيق جديد لإنشاء تطبيقك.
املأ ما تبقّى من النموذج وانقر على زر إضافة تطبيق لإنهاء عملية إعداد تطبيقك.
بعد إنشاء تطبيقك، سيتم توجيهك إلى لوحة البيانات الخاصة به. دوِّن معرّف التطبيق وتوقيع التطبيق لتطبيقك.
Android
iOS
AdMob لإعداد AdMob رقم تعريف الوحدة الإعلانية، يجب استخدام رقم تعريف المستخدم وتوقيع المستخدم في Chartboost. يمكنك العثور على هذه المَعلمات من خلال النقر على توسّط Chartboost في واجهة مستخدم Chartboost.
انتقِل إلى علامة تبويب الموارد > مستكشف واجهة برمجة التطبيقات ودوِّن معرّف المستخدم وتوقيع المستخدم ضمن قسم المصادقة.
تفعيل وضع الاختبار
يمكنك تفعيل وضع الاختبار في تطبيقك من خلال الانتقال إلى علامة التبويب إدارة التطبيقات من واجهة مستخدم Chartboost واختيار تطبيقك من القائمة والنقر على تعديل إعدادات التطبيق.
Android
iOS
من إعدادات تطبيقك، يمكنك تفعيل وضع الاختبار في تطبيقك.
بعد تفعيل وضع "الاختبار"، يمكنك طلب الإعلانات باستخدام رقم تعريف الوحدة الإعلانية الذي تم إنشاؤه سابقًا وتلقّي إعلان اختباري من Chartboost.
بعد أن تتمكّن من تلقّي إعلانات اختبارية في Chartboost، سيتم وضع تطبيقك في مراجعة تطبيقات الناشرين من Chartboost. لكي تعمل ميزة تحقيق الربح في Chartboost، يجب أن تتم الموافقة على مراجعة تطبيق الناشر من قِبل Chartboost.
الخطوة 2: إعداد طلب Chartboost في AdMob واجهة المستخدم
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة Chartboost إلى قائمة شركاء الإعلانات باللائحة العامة لحماية البيانات (GDPR) ولوائح الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة Chartboost إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في AdMob واجهة المستخدم.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) والمحوّل في Chartboost
نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في Chartboost من رابط التنزيل في سجلّ التغييرات واستخراج GoogleMobileAdsChartboostMediation.unitypackage
من ملف ZIP.
في محرر مشروع Unity، حدد مواد العرض > استيراد حزمة >
حزمة مخصصة وابحث عن الملف GoogleMobileAdsChartboostMediation.unitypackage
الذي تم تنزيله. تأكَّد من اختيار جميع الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android >
فرض الحل. ستنفِّذ مكتبة أداة حلّ المشاكل في Unity Play حلّ مشكلة الاعتماد من البداية وستنسخ التبعيات المُعلَنة إلى دليل Assets/Plugins/Android
في تطبيق Unity.
الخطوة 4: تنفيذ إعدادات الخصوصية في Chartboost SDK
موافقة الاتحاد الأوروبي واللائحة العامة لحماية البيانات
بموجب سياسة موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google، عليك التأكّد من الإفصاح عن معلومات محدّدة للمستخدمين في المنطقة الاقتصادية الأوروبية والحصول على موافقات منهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR) في الاتّحاد الأوروبي. عند طلب الحصول على موافقة، يجب عليك تحديد كل شبكة إعلانات في سلسلة التوسط قد تجمع البيانات الشخصية أو تتلقاها أو تستخدمها، وتقدم معلومات عن استخدام كل شبكة. ولا يمكن لشركة Google حاليًا تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
يتضمّن المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" للإصدار 3.1.0 من Chartboost طريقة Chartboost.AddDataUseConsent()
. يحدِّد الرمز النموذجي التالي استخدام البيانات
في الموافقة على NonBehavioral
. إذا اخترت استدعاء هذه الطريقة، ننصحك بإجراء ذلك قبل طلب الإعلانات باستخدام "SDK لإعلانات Google على الأجهزة الجوّالة".
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
قوانين الخصوصية في الولايات الأمريكية
قوانين الخصوصية في الولايات الأمريكية تتطلب من المستخدمين منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفقًا لما يحدّده القانون) لهذه المصطلحات)، وذلك من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف "البيع". إنّ دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية يوفّر إمكانية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات على Google، ولكن يتعذّر على Google تطبيق هذا الإعداد على كل شبكة إعلانات في سلسلة التوسّط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية واتّباع الإرشادات من كل شبكة من هذه الشبكات لضمان الامتثال لها.
يتضمّن المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" للإصدار 3.1.0 من Chartboost طريقة Chartboost.AddDataUseConsent()
. يحدِّد الرمز النموذجي التالي استخدام البيانات
في الموافقة على OptInSale
. إذا اخترت استدعاء هذه الطريقة، ننصحك بإجراء ذلك قبل طلب الإعلانات باستخدام "SDK لإعلانات Google على الأجهزة الجوّالة".
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
الخطوة 5: إضافة الرمز المطلوب
Android
ما مِن رمز إضافي مطلوب لدمج Chartboost.
iOS
دمج SKAdNetwork
اتّبِع مستندات Chartboost
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist
الخاص بمشروعك.
الخطوة 6: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم Chartboost .
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من Chartboost، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام Chartboost (Waterfall) مصادر الإعلانات.
خطوات اختيارية
Android
الأذونات
للحصول على الأداء الأمثل، تنصح Chartboost بإضافة الأذونات الاختيارية التالية إلى ملف AndroidManifest.xml
الخاص بتطبيقك:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
iOS
ليس من المطلوب اتّخاذ أي خطوات إضافية للتكامل مع نظام iOS.
رموز الخطأ
إذا تعذّر على المحوّل تلقّي إعلان من Chartboost، يمكن للناشرين التحقق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo
ضمن الفئات التالية:
Android
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
iOS
GADMAdapterChartboost
GADMediationAdapterChartboost
في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل Chartboost عند تعذُّر تحميل الإعلان:
Android
رمز الخطأ | السبب |
---|---|
0-99 | حدث خطأ في حزمة تطوير البرامج (SDK) في Chartboost. |
101 | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع Chartboost. |
102 | يمكن لأداة Chartboost تحميل إعلان واحد فقط لكل موقع جغرافي في المرة الواحدة. |
103 | معلَمات خادم Chartboost التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة/غير صالحة. |
104 | لن يكون الإعلان البيني أو الذي يضم مكافأة في Chartboost غير جاهز للعرض. |
iOS
رمز الخطأ | السبب |
---|---|
101 | معلَمات خادم Chartboost التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة/غير صالحة. |
102 | عرضت حزمة تطوير البرامج (SDK) في Chartboost خطأ في الإعداد. |
103 | لا يتم تخزين إعلان Chartboost مؤقتًا في وقت العرض. |
104 | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع Chartboost. |
105 | إصدار نظام تشغيل الجهاز أقل من الحد الأدنى لإصدار نظام التشغيل المتوافق مع حزمة Chartboost SDK. |
200-299 | أخطاء ذاكرة التخزين المؤقت لحزمة تطوير البرامج (SDK) في Chartboost اطّلِع على الرمز البرمجي لمزيد من التفاصيل. |
300-399 | تعرض حزمة تطوير البرامج (SDK) في Chartboost أخطاء. اطّلِع على الرمز البرمجي لمزيد من التفاصيل. |
400-499 | أخطاء النقر على حزمة تطوير البرامج (SDK) في Chartboost اطّلِع على الرمز البرمجي لمزيد من التفاصيل. |
سجلّ تغييرات المكوّن الإضافي لتوسّط Chartboost Unity
الإصدار 4.5.0
- يتوافق مع الإصدار 9.6.0.0 من محوّل Chartboost المتوافق مع Android.
- يتوافق مع الإصدار 9.6.0.0 من محوّل Chartboost لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.6.0 من المكوّن الإضافي لبرنامج Unity إضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.4.0
- يتوافق مع الإصدار 9.5.0.0 من محوّل Chartboost الخاص بنظام التشغيل Android.
- يتوافق مع الإصدار 9.5.1.0 من محوّل Chartboost لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.5.3 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.3.0
- يتوافق مع الإصدار 9.4.0.0 من محوّل Chartboost المتوافق مع Android.
- يتوافق مع الإصدار 9.4.0.0 من محوّل Chartboost لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.5.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.2.0
- يتوافق مع الإصدار 9.3.0.0 من محوّل Chartboost المتوافق مع Android.
- يتوافق مع الإصدار 9.3.0.0 من محوّل Chartboost لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.2.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.1.1
- تم نقل محتوى المحوّل إلى
GoogleMobileAds/Mediation/Chartboost/
. - تمت إعادة ضبط مساحة اسم المحوّل لاستخدام
GoogleMobileAds.Mediation.Chartboost
. - يتوافق مع الإصدار 9.2.1.1 من محوّل Chartboost لنظام التشغيل Android.
- يتوافق مع الإصدار 9.2.0.0 من محوّل Chartboost لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.1.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.1.0
- يتوافق مع الإصدار 9.2.0.0 من محوّل Chartboost الخاص بنظام التشغيل Android.
- يتوافق مع الإصدار 9.2.0.0 من محوّل Chartboost لنظام التشغيل iOS.
- تم إنشاء الإصدار 7.4.1 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.4.1.
الإصدار 4.0.0
- يتوافق مع الإصدار 9.1.1.0 من محوّل Chartboost المتوافق مع Android.
- يتوافق مع الإصدار 9.1.0.0 من محوّل Chartboost لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.3.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.5.1
- يتوافق مع الإصدار 8.4.3.1 من محوّل Chartboost المتوافق مع Android.
- يتوافق مع الإصدار 8.5.0.2 من محوّل Chartboost لنظام التشغيل iOS.
- تم إنشاء الإصدار 7.0.2 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.0.2.
الإصدار 3.5.0
- يتوافق مع الإصدار 8.4.2.0 من محوّل Chartboost الخاص بنظام التشغيل Android.
- يتوافق مع الإصدار 8.5.0.2 من محوّل Chartboost لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.0.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.4.1
- يتوافق مع الإصدار 8.3.1.0 من محوّل Chartboost الخاص بنظام التشغيل Android.
- يتوافق مع الإصدار 8.5.0.2 من محوّل Chartboost لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.0.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.4.0
- يتوافق مع الإصدار 8.3.0.0 من محوّل Chartboost المتوافق مع Android.
- يتوافق مع الإصدار 8.5.0.1.0 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 3.3.1
- يتوافق مع الإصدار 8.2.1.0 من محوّل Chartboost المتوافق مع Android.
- يتوافق مع الإصدار 8.4.1.1 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 3.3.0
- يتوافق مع الإصدار 8.2.0.0 من محوّل Chartboost الخاص بنظام التشغيل Android.
- يتوافق مع الإصدار 8.4.0.0 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 3.2.0
- يتوافق مع الإصدار 8.1.0.0 من محوّل Chartboost الخاص بنظام التشغيل Android.
- يتوافق مع الإصدار 8.3.1.0 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 3.1.0
- تمت إزالة طريقة
RestrictDataCollection()
من الصفChartboost
. - تمت إضافة
AddDataUseConsent()
طريقة مساعِدة لتمرير معلومات اللائحة العامة لحماية البيانات (GDPR) وقانون خصوصية المستهلك في كاليفورنيا (CCPA) إلى Chartboost. - يتوافق مع الإصدار 8.1.0.0 من محوّل Chartboost الخاص بنظام التشغيل Android.
- يتوافق مع الإصدار 8.2.0.0 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 3.0.1
- يتوافق مع الإصدار 8.0.3.1 من محوّل Chartboost المتوافق مع Android.
- يتوافق مع الإصدار 8.1.0.1 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 3.0.0
- يتوافق مع الإصدار 8.0.2.0 من محوّل Chartboost لنظام التشغيل Android.
- يتوافق مع الإصدار 8.1.0.0 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 2.0.1
- يتوافق مع الإصدار 7.5.0.1 من محوّل Chartboost المتوافق مع Android.
- يتوافق مع الإصدار 8.0.4.0 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 2.0.0
- يتوافق مع الإصدار 7.5.0.0 من محوّل Chartboost لنظام التشغيل Android.
- يتوافق مع الإصدار 8.0.1.1 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 1.3.0
- تم تحديث المكوّن الإضافي للتوافق مع واجهة برمجة التطبيقات الجديدة التي تضم مكافآت.
- يتوافق مع الإصدار 7.3.1.1 من محوّل Chartboost لنظام التشغيل Android.
- يتوافق مع الإصدار 7.5.0.0 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 1.2.0
- يتوافق مع الإصدار 7.3.0.0 من محوّل Chartboost لنظام التشغيل Android.
- يتوافق مع الإصدار 7.3.0.0 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 1.1.1
- يتوافق مع الإصدار 7.2.0.1 من محوّل Chartboost لنظام التشغيل Android.
- يتوافق مع الإصدار 7.2.0.1 من محوّل Chartboost لنظام التشغيل iOS.
الإصدار 1.1.0
- يتوافق مع الإصدار 7.2.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Chartboost.
- يتوافق مع الإصدار 7.2.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Chartboost.
- تمت إضافة طريقة "
Chartboost.RestrictDataCollection()
" لتفعيل قيود جمع البيانات بموجب "اللائحة العامة لحماية البيانات" في حزمة تطوير البرامج (SDK) في Chartboost.
الإصدار 1.0.0
- الإصدار الأول
- يتوافق مع الإصدار 7.0.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Chartboost.
- يتوافق مع الإصدار 7.1.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Chartboost.