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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

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

يتضمّن محوّل التوسّط في "مدير إعلانات Google" لشبكة Chartboost الإمكانات التالية:

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

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

  • أحدث إصدار من Google Mobile Ads Unity Plugin
  • الإصدار 2019.4 أو إصدار أحدث من Unity Editor
  • للنشر على Android
    • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
  • للنشر على أجهزة iOS
    • هدف نشر iOS‏ 13.0 أو إصدار أحدث
  • مشروع Unity قيد العمل تم إعداده باستخدام Google Mobile Ads Unity Plugin لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Unity Plugin.
  • إعداد التوسّط

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

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

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

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

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

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

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

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

    Android

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

    iOS

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

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

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

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

    Chartboost api explorer

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

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

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

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

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

    Android

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

    iOS

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

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

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

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

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

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

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

    Android

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

    iOS

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

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

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

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

    OpenUPM-CLI

    إذا كان لديك OpenUPM-CLI مثبّتًا، يمكنك تثبيت Google Mobile Ads 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مستودعات ‫

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

    التثبيت من‫ OpenUPM

    حزمة Unity

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

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

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

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

    فرض الحلّ

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

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

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

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

    يضبط الرمز النموذجي التالي الموافقة على استخدام البيانات على OptInSale. إذا اخترت استدعاء هذه الطريقة، ننصحك بإجراء ذلك قبل طلب الإعلانات باستخدام Google Mobile Ads Unity Plugin.

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

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

    الخطوة 5: إضافة الرمز المطلوب

    Android

    لا يلزم استخدام أي رمز إضافي لدمج Chartboost.

    iOS

    دمج SKAdNetwork

    اتّبِع مستندات Chartboost لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

    الخطوة 6: اختبار عملية الإعداد

    تفعيل الإعلانات الاختبارية

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

    iOS

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

    الإصدار 4.15.1

    الإصدار 4.15.0

    الإصدار 4.14.0

    الإصدار 4.13.0

    الإصدار 4.12.1

    الإصدار 4.12.0

    الإصدار 4.11.3

    الإصدار 4.11.2

    الإصدار 4.11.1

    الإصدار 4.11.0

    الإصدار 4.10.3

    الإصدار 4.10.2

    الإصدار 4.10.1

    الإصدار 4.10.0

    الإصدار 4.9.3

    الإصدار 4.9.2

    الإصدار 4.9.1

    الإصدار 4.9.0

    الإصدار 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) لمنصّة Chartboost على أجهزة iOS.
    • تمت إضافة طريقة Chartboost.RestrictDataCollection() لتفعيل قيود جمع البيانات بموجب "اللائحة العامة لحماية البيانات" (GDPR) في حزمة تطوير البرامج (SDK) لمنصّة Chartboost.

    الإصدار 1.0.0

    • الإصدار الأول
    • يتوافق مع الإصدار 7.0.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Chartboost.
    • يتوافق مع الإصدار 7.1.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Chartboost.