دمج Chartboost مع التوسّط

يوضِّح لك هذا الدليل كيفية استخدام "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 وسجِّل الدخول بعد إثبات ملكية حسابك. بعد ذلك، انتقِل إلى علامة التبويب إدارة التطبيقات.

لوحة بيانات تطبيقات Chartboost

انقر على الزر إضافة تطبيق جديد لإنشاء تطبيقك.

إدارة التطبيقات

املأ ما تبقّى من النموذج وانقر على زر إضافة تطبيق لإنهاء عملية إعداد تطبيقك.

نموذج تطبيق جديد

بعد إنشاء تطبيقك، سيتم توجيهك إلى لوحة البيانات الخاصة به. دوِّن معرّف التطبيق وتوقيع التطبيق لتطبيقك.

Android

إعدادات التطبيق

iOS

إعدادات التطبيق

AdMob لإعداد AdMob رقم تعريف الوحدة الإعلانية، يجب استخدام رقم تعريف المستخدم وتوقيع المستخدم في Chartboost. يمكنك العثور على هذه المَعلمات من خلال النقر على توسّط Chartboost في واجهة مستخدم Chartboost.

لوحة بيانات التوسّط في Chartboost

انتقِل إلى علامة تبويب الموارد > مستكشف واجهة برمجة التطبيقات ودوِّن معرّف المستخدم وتوقيع المستخدم ضمن قسم المصادقة.

مستكشف واجهات برمجة التطبيقات في Chartboost

تفعيل وضع الاختبار

يمكنك تفعيل وضع الاختبار في تطبيقك من خلال الانتقال إلى علامة التبويب إدارة التطبيقات من واجهة مستخدم Chartboost واختيار تطبيقك من القائمة والنقر على تعديل إعدادات التطبيق.

Android

تعديل إعدادات التطبيق

iOS

تعديل إعدادات التطبيق

من إعدادات تطبيقك، يمكنك تفعيل وضع الاختبار في تطبيقك.

وضع اختبار Chartboost

بعد تفعيل وضع "الاختبار"، يمكنك طلب الإعلانات باستخدام رقم تعريف الوحدة الإعلانية الذي تم إنشاؤه سابقًا وتلقّي إعلان اختباري من 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

الإصدار 4.4.0

الإصدار 4.3.0

الإصدار 4.2.0

الإصدار 4.1.1

الإصدار 4.1.0

الإصدار 4.0.0

الإصدار 3.5.1

الإصدار 3.5.0

الإصدار 3.4.1

الإصدار 3.4.0

الإصدار 3.3.1

الإصدار 3.3.0

الإصدار 3.2.0

الإصدار 3.1.0

الإصدار 3.0.1

الإصدار 3.0.0

الإصدار 2.0.1

الإصدار 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.