يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من Chartboost باستخدام التوسّط، التي تغطي عمليات دمج الشلال. يتناول كيفية إضافة Chartboost إلى موضع إعلان إعدادات التوسّط وكيفية دمج محوّل وحزمة تطوير البرامج (SDK) في Chartboost إلى تطبيق Unity.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمن محوِّل AdMob التوسّط في Chartboost الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة |
المتطلبات
- Unity 4 أو إصدار أحدث
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Unity قيد التشغيل تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". عرض البدء لمعرفة التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم 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 Services
تحليل التبعية من البداية ونسخ التبعيات المعلنة إلى
الدليل Assets/Plugins/Android
لتطبيق Unity
الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة تطوير البرامج (SDK) لتطبيق Chartboost
موافقة المستخدمين في الاتحاد الأوروبي واللائحة العامة لحماية البيانات
بموجب موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google السياسة، يجب التأكّد من الإفصاح عن معلومات معيّنة الموافقات التي تم الحصول عليها من المستخدمين في المنطقة الاقتصادية الأوروبية في ما يتعلق استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية و"حماية البيانات العامة" اللائحة (اللائحة العامة لحماية البيانات). عند طلب الحصول على موافقة، عليك تحديد كل شبكة إعلانات. في سلسلة التوسط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها تقدم معلومات حول استخدام كل شبكة. يتعذّر على 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 | عرَضَت حزمة Chartboost SDK خطأً. |
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 الاطّلاع على الرمز لمزيد من التفاصيل. |
سجلّ تغييرات المكوّن الإضافي لتوسّط Unity في Chartboost
الإصدار التالي
- تمت إعادة تسمية "
DummyClient
" إلى "PlaceholderClient
".
الإصدار 4.6.0
- متوافق مع الإصدار 9.7.0.0 من محوّل Android Chartboost
- يتوافق مع الإصدار 9.7.0.0 من محوّل Chartboost في iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 9.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.5.0
- يتوافق مع الإصدار 9.6.0.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 9.6.0.0 من محوّل Chartboost في iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.6.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.4.0
- يتوافق مع الإصدار 9.5.0.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 9.5.1.0 من محوّل Chartboost في iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.5.3 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.3.0
- يتوافق مع الإصدار 9.4.0.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 9.4.0.0 من محوّل Chartboost في iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.5.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.2.0
- متوافق مع الإصدار 9.3.0.0 من محوّل Android Chartboost
- يتوافق مع الإصدار 9.3.0.0 من محوّل Chartboost في iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.2.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.1.1
- تم نقل محتوى المحوّل إلى
GoogleMobileAds/Mediation/Chartboost/
. - تمت إعادة ضبط مساحة الاسم للمهايئ لاستخدام
GoogleMobileAds.Mediation.Chartboost
. - يتوافق مع الإصدار 9.2.1.1 من محوّل Android Chartboost.
- يتوافق مع الإصدار 9.2.0.0 من محوّل Chartboost في iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.1.0
- يتوافق مع الإصدار 9.2.0.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 9.2.0.0 من محوّل Chartboost في iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.4.1 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 4.0.0
- يتوافق مع الإصدار 9.1.1.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 9.1.0.0 من محوّل Chartboost في iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.3.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.5.1
- يتوافق مع الإصدار 8.4.3.1 من محوّل Android في Chartboost.
- يتوافق مع الإصدار 8.5.0.2 من محوّل Chartboost في iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.2 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.5.0
- يتوافق مع الإصدار 8.4.2.0 من محوّل Android في Chartboost.
- يتوافق مع الإصدار 8.5.0.2 من محوّل Chartboost في iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.4.1
- يتوافق مع الإصدار 8.3.1.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 8.5.0.2 من محوّل Chartboost في iOS.
- تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.0.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.4.0
- تتوافق مع الإصدار 8.3.0.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 8.5.0.1.0 من محوّل Chartboost في iOS.
الإصدار 3.3.1
- يتوافق مع الإصدار 8.2.1.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 8.4.1.1 من محوّل Chartboost في iOS.
الإصدار 3.3.0
- يتوافق مع الإصدار 8.2.0.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 8.4.0.0 من محوّل Chartboost في iOS.
الإصدار 3.2.0
- يتوافق مع الإصدار 8.1.0.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 8.3.1.0 من محوّل Chartboost في iOS.
الإصدار 3.1.0
- تمت إزالة طريقة
RestrictDataCollection()
من الصفChartboost
. - تمت إضافة
AddDataUseConsent()
طريقة مساعدة لتمرير معلومات اللائحة العامة لحماية البيانات (GDPR) وقانون خصوصية المستهلك في كاليفورنيا (CCPA) إلى Chartboost. - يتوافق مع الإصدار 8.1.0.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 8.2.0.0 من محوّل Chartboost iOS.
الإصدار 3.0.1
- تتوافق مع الإصدار 8.0.3.1 من محوّل Android Chartboost.
- يتوافق مع الإصدار 8.1.0.1 من محوّل Chartboost iOS.
الإصدار 3.0.0
- تتوافق مع الإصدار 8.0.2.0 من محوّل Android في Chartboost.
- يتوافق مع الإصدار 8.1.0.0 من محوّل Chartboost في iOS.
الإصدار 2.0.1
- يتوافق مع الإصدار 7.5.0.1 من محوّل Android في Chartboost.
- يتوافق مع الإصدار 8.0.4.0 من محوّل Chartboost في iOS.
الإصدار 2.0.0
- يتوافق مع الإصدار 7.5.0.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 8.0.1.1 من محوّل Chartboost iOS.
الإصدار 1.3.0
- تم تحديث المكوّن الإضافي لإتاحة Bonus API الجديدة.
- يتوافق مع الإصدار 7.3.1.1 من محوّل Android Chartboost.
- يتوافق مع الإصدار 7.5.0.0 من محوّل Chartboost iOS.
الإصدار 1.2.0
- يتوافق مع الإصدار 7.3.0.0 من محوّل Android Chartboost.
- يتوافق مع الإصدار 7.3.0.0 من محوّل Chartboost iOS.
الإصدار 1.1.1
- يتوافق مع الإصدار 7.2.0.1 من محوّل Android Chartboost.
- يتوافق مع الإصدار 7.2.0.1 من محوّل Chartboost iOS.
الإصدار 1.1.0
- يتوافق مع الإصدار 7.2.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Chartboost.
- يتوافق مع الإصدار 7.2.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Chartboost.
- تمت إضافة طريقة
Chartboost.RestrictDataCollection()
لتفعيل قيود جمع البيانات بموجب اللائحة العامة لحماية البيانات (GDPR) لحزمة تطوير البرامج (SDK) في Chartboost.
الإصدار 1.0.0
- الإصدار الأول!
- يتوافق مع الإصدار 7.0.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Chartboost.
- يتوافق مع الإصدار 7.1.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Chartboost.