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

يوضِّح لك هذا الدليل كيفية استخدام حزمة "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

اشترِك للحصول على حساب في 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 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

الإصدار 4.6.0

الإصدار 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 من محوّل 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.