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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

Android

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

iOS

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

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

وضع اختبار Chartboost

بعد تفعيل وضع الاختبار، يمكنك طلب الإعلانات باستخدام معرّف الوحدة الإعلانية الذي تم إنشاؤه في وقت سابق وتلقّي إعلان اختباري من Chartboost.

بعد أن تتمكّن من تلقّي إعلانات اختبار Chartboost، سيتم وضع تطبيقك في مراجعة تطبيق الناشر في Chartboost. لكي تعمل ميزة تحقيق الربح في Chartboost، يجب أن يوافق فريق Chartboost على مراجعة تطبيق الناشر.

الخطوة 2: إعداد طلب Chartboost في واجهة مستخدم Ad Manager

ضبط إعدادات التوسّط لوحدتك الإعلانية

Android

للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

إضافة Chartboost إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" (GDPR) واللوائح التنظيمية السارية في الولايات الأمريكية

اتّبِع الخطوات الواردة في إعدادات "اللائحة العامّة لحماية البيانات" (GDPR) و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Chartboost إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية في واجهة مستخدِم AdMob.

الخطوة 3: استيراد حِزم تطوير البرامج (SDK) ومحوِّل Chartboost

OpenUPM-CLI

إذا كان OpenUPM-CLI مثبّتًا، يمكنك تثبيت Chartboost المكوّن الإضافي للتوسّط من Google على الويب لمشروعك من خلال تنفيذ الأمر التالي من الدليل الجذري لمشروعك:

openupm add com.google.ads.mobile.mediation.chartboost

OpenUPM

في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > مدير الحِزم لفتح إعدادات مدير حِزم Unity.

ضمن علامة التبويب السجلّات على مستوى النطاق، أضِف OpenUPM كسجلّ على مستوى النطاق باستخدام التفاصيل التالية:

  • الاسم: OpenUPM
  • عنوان URL: https://package.openupm.com
  • النطاقات: com.google

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى النافذة > مدير الحِزم لفتح مدير حِزم Unity و اختَر السجلّات الخاصة بي من القائمة المنسدلة.

سجلات Unity

اختَر حزمة Google Mobile Ads Chartboost Mediation وانقر على تثبيت.

التثبيت من OpenUPM

حزمة الانسجام

نزِّل أحدث إصدار من المكوّن الإضافي لوسيط إعلانات Google للأجهزة الجوّالة لأجل Chartboost من رابط التنزيل في سجلّ التغييرات واسحب ملف GoogleMobileAdsChartboostMediation.unitypackage من ملف zip .

في محرِّر مشروعات Unity، انقر على Assets (مواد العرض) > Import Package (استيراد حزمة) > Custom Package (الحزمة المخصّصة) وابحث عن ملف GoogleMobileAdsChartboostMediation.unitypackage الذي نزَّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

الاستيراد من Unity

بعد ذلك، اختَر مواد العرض > مدير التبعيات الخارجية > Android Resolver > Force Resolve (حلّ المشاكل بالقوة). ستنفِّذ مكتبة "مدير التبعية الخارجية" عملية حلّ التبعية من البداية وستنسخ التبعيات المعلَن عنها إلى الدليل Assets/Plugins/Android في تطبيق Unity.

فرض الحل

الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة تطوير البرامج (SDK) من Chartboost

بموجب سياسة موافقة المستخدِم في الاتّحاد الأوروبي المتّبَعة في Google، عليك التأكّد من تقديم بيانات الإفصاح المعيّنة إلى المستخدِمين في المنطقة الاقتصادية الأوروبية والحصول على موافقاتهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تراعي هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR). عند طلب الموافقة، يجب عليك تحديد كل شبكة إعلانات في سلسلة التوسط قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، وأن تقدّم معلومات عن استخدام كل شبكة. لا يمكن لشركة Google حاليًا تمرير اختيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.

يتضمّن الإصدار 3.1.0 من مكوّن Chartboost الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" طريقة Chartboost.AddDataUseConsent(). يضبط نموذج الرمز البرمجي التالي الموافقة على استخدام البيانات على NonBehavioral. إذا اخترت استدعاء هذه الطريقة، ننصح بإجراء ذلك قبل طلب الإعلانات باستخدام حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

قوانين الخصوصية في الولايات الأمريكية

قوانين الخصوصية في الولايات الأمريكية تتطلّب منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن لا يمكن لشركة Google تطبيق هذا الإعداد على كل شبكة إعلانية في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة مواقع إعلانية في سلسلة التوسّط التي قد تشارك في بيع المَعلومات الشخصية واتباع الإرشادات الواردة من كلّ من هذه الشبكات لضمان الامتثال.

يتضمّن الإصدار 3.1.0 من مكوّن Chartboost الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" طريقة 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 (العرض الإعلاني بدون انقطاع).

الخطوات الاختيارية

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 التي تم ضبطها في Ad Manager واجهة المستخدم غير متوفّرة أو غير صالحة.
104 الإعلان البيني أو الإعلان الذي يضم مكافأة من Chartboost غير جاهز للعرض.

iOS

رمز الخطأ السبب
101 معلَمات خادم Chartboost التي تم ضبطها في واجهة المستخدم Ad Manager غير متوفّرة أو غير صالحة.
102 ظهرت رسالة خطأ في عملية إعداد حزمة تطوير البرامج (SDK) من Chartboost.
103 لا يتم تخزين إعلان Chartboost مؤقتًا في وقت العرض.
104 لا يتطابق حجم الإعلان المطلوب مع حجم البانر المتوافق مع Chartboost.
105 إصدار نظام التشغيل على الجهاز أقل من الحد الأدنى لإصدار نظام التشغيل المتوافق مع حزمة تطوير البرامج Chartboost SDK.
200-299 أخطاء ذاكرة التخزين المؤقت لحزمة Chartboost SDK اطّلِع على الرمز للحصول على مزيد من التفاصيل.
300-399 تظهر أخطاء في حزمة تطوير البرامج (SDK) من Chartboost. اطّلِع على الرمز للحصول على مزيد من التفاصيل.
400-499 أخطاء النقر في حزمة تطوير البرامج (SDK) من Chartboost اطّلِع على الرمز للحصول على مزيد من التفاصيل.

سجلّ التغييرات في مكوّن Chartboost Unity Mediation Plugin

الإصدار 4.6.1

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