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

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

عمليات الدمج وأشكال الإعلانات المتوافقة

يتضمّن محوّل التوسّط في AdMob لشبكة Chartboost الميزات التالية:

التكامل
عروض الأسعار
شلال
التنسيقات
بانر
إعلان بيني
تم منح المكافأة

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫Unity 4 أو الإصدارات الأحدث
  • للنشر على Android
    • المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
  • للنشر على أجهزة iOS
    • الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث
  • مشروع Unity يعمل وتم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لمزيد من التفاصيل، يُرجى الاطّلاع على البدء.
  • أكمِل دليل البدء الخاص بالتوسّط

الخطوة 1: إعداد عمليات الضبط في واجهة مستخدم Chartboost

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

Chartboost api explorer

تعديل ملف app-ads.txt

مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، عليك إعداد ملف app-ads.txt لتطبيقك.

لتنفيذ app-ads.txt في Chartboost، يُرجى الاطّلاع على ملف app-ads.txt.

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

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

Android

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

iOS

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت Chartboost Mediation Plugin for Unity على مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر للمشروع:

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

OpenUPM

في أداة تعديل مشروع Unity، اختَر تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحِزم (Package Manager) لفتح إعدادات "إدارة حِزم Unity" (Unity Package Manager Settings).

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

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

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager (إدارة حِزم Unity)، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.

Unity Registries

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

التثبيت من OpenUPM

حزمة Unity

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

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

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

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

فرض الحلّ

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

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

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

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

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

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

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

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

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

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 إصدار نظام التشغيل على الجهاز أقل من الحد الأدنى لإصدار نظام التشغيل المتوافق مع حزمة تطوير البرامج (SDK) من Chartboost.
200-299 أخطاء ذاكرة التخزين المؤقت لحزمة تطوير البرامج (SDK) من Chartboost اطّلِع على الرمز لمزيد من التفاصيل.
300-399 تعرض حزمة تطوير البرامج (SDK) من Chartboost أخطاءً. اطّلِع على الرمز لمزيد من التفاصيل.
400-499 أخطاء النقر في حزمة تطوير البرامج (SDK) من Chartboost اطّلِع على الرمز لمزيد من التفاصيل.

سجلّ التغييرات في Chartboost Unity Mediation Plugin

الإصدار 4.8.0

الإصدار 4.7.3

الإصدار 4.7.2

الإصدار 4.7.1

الإصدار 4.7.0

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