يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من Chartboost باستخدام التوسّط، التي تغطي عمليات دمج الشلال. يتناول كيفية إضافة Chartboost إلى موضع إعلان إعدادات التوسّط وكيفية دمج محوّل وحزمة تطوير البرامج (SDK) في Chartboost إلى تطبيق Unity.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمن محوِّل Ad Manager التوسّط في Chartboost الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة |
المتطلبات
- Unity 4 أو إصدار أحدث
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Unity قيد التشغيل تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة". عرض البدء لمعرفة التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم Chartboost
اشترك في حساب Chartboost تسجيل الدخول بعد إثبات ملكية حسابك. بعد ذلك، انتقِل إلى علامة التبويب إدارة التطبيقات.
انقر على زر إضافة تطبيق جديد لإنشاء تطبيقك.
املأ باقي النموذج وانقر على الزر إضافة تطبيق لإنهاء التطبيق.
بعد إنشاء تطبيقك، سيتم توجيهك إلى لوحة بياناته. قم بتدوين رقم تعريف التطبيق وتوقيع التطبيق لتطبيقك.
Android
iOS
تتطلب AdMob توفُّر رقم تعريف المستخدم في Chartboost توقيع المستخدم لإعداد إعلانك على AdMob معرّف الوحدة. يمكنك العثور على هذه المَعلمات بالنقر على توسّط Chartboost على واجهة مستخدم Chartboost.
انتقل إلى الموارد > API Explorer (مستكشف واجهات برمجة التطبيقات) ودوِّن رقم تعريف المستخدم وتوقيع المستخدم ضمن قسم المصادقة.
تفعيل وضع الاختبار
يمكنك تفعيل وضع الاختبار في تطبيقك من خلال الانتقال إلى إدارة التطبيقات. من واجهة مستخدم Chartboost، وتحديد تطبيقك من القائمة والنقر فوق تعديل إعدادات التطبيق
Android
iOS
من إعدادات تطبيقك، يمكنك تفعيل الوضع التجريبي في تطبيقك.
بعد تفعيل وضع الاختبار، يمكنك طلب الإعلانات باستخدام رقم تعريف الوحدة الإعلانية الذي تم إنشاؤه. سابقًا والحصول على إعلان تجريبي من Chartboost.
بعد أن تتمكّن من تلقّي الإعلانات الاختبارية من Chartboost، سيتم وضع تطبيقك في Publisher App Review من Chartboost. ولتفعيل ميزة تحقيق الربح في Chartboost، يجب مراجعة تطبيق الناشر يجب أن تتم الموافقة عليها من قبل Chartboost.
الخطوة 2: إعداد طلب Chartboost في واجهة مستخدم Ad Manager
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة Chartboost إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية
الخطوة 3: استيراد المحوّل وحزمة تطوير البرامج (SDK) لتطبيق Chartboost
OpenUPM-CLI
إذا كان لديك OpenUPM-CLI يمكنك تثبيت Chartboost لإعلانات Google على الجوال المكوّن الإضافي للتوسّط for Unity إلى مشروعك من خلال تشغيل الأمر التالي من الدليل الجذري لمشروعك:
openupm add com.google.ads.mobile.mediation.chartboost
OpenUPM
في محرِّر مشروع Unity، اختَر تعديل >. إعدادات المشروع > مدير الحزم لفتح إعدادات Unity Package Manager
ضمن علامة التبويب السجلات المندرجة ضمن النطاق، أضِف OpenUPM كسجلّ نطاق محدَّد باستخدام التفاصيل التالية:
- الاسم:
OpenUPM
- عنوان URL:
https://package.openupm.com
- النطاقات:
com.google
بعد ذلك، انتقل إلى Window > مدير الحزم لفتح Unity Package Manager اختَر سجلاتي من القائمة المنسدلة.
اختَر حزمة توسّط Chartboost لإعلانات Google على الأجهزة الجوّالة انقر على تثبيت.
حزمة الانسجام
تنزيل أحدث إصدار من مكوّن توسّط إعلانات Google على الأجهزة الجوّالة
Chartboost من رابط التنزيل في
الـ
سجلّ التغييرات
واستخراج
GoogleMobileAdsChartboostMediation.unitypackage
من الرمز البريدي
الملف.
في محرِّر مشروعات Unity، اختَر مواد العرض >. استيراد حزمة >
الحزمة المخصّصة واعثر على
GoogleMobileAdsChartboostMediation.unitypackage
الملف الذي قمت بتنزيله. تأكد من تحديد كل الملفات وانقر على
استيراد.
بعد ذلك، اختَر مواد العرض >. محلل خدمات Play >
أداة تحليل Android > فرض الحل: أداة حلّ خدمات Unity Play
دقة التبعية من البداية ونسخ
التي تم الإعلان عنها ضمن دليل 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: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل Ad Manager وتفعيل وضع الاختبار في واجهة المستخدم 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 التي تم ضبطها في واجهة المستخدم Ad Manager غير متوفّرة أو غير صالحة. |
104 | الإعلان البيني أو الإعلان الذي يضم مكافأة في Chartboost غير جاهز للعرض. |
iOS
رمز الخطأ | السبب |
---|---|
101 | معلَمات خادم Chartboost التي تم ضبطها في واجهة المستخدم Ad Manager غير متوفّرة أو غير صالحة. |
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
- تم تحديث المكوّن الإضافي لإتاحة Rewards 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.