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

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

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

يمتلك محوِّل التوسّط في AdMob لـ Chartboost القدرات التالية:

المتطلبات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الدمج من خلال pub.dev

أضِف التبعية التالية مع أحدث إصدارَين من حزمة تطوير البرامج (SDK) وملف التبديل في Chartboost فيملفpubspec.yaml الحزمة:

dependencies:
  gma_mediation_chartboost: ^1.0.0

الدمج اليدوي

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

dependencies:
  gma_mediation_chartboost:
    path: path/to/local/package

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

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

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

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

الخطوة 6: اختبار عملية التنفيذ

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

تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم Chartboost.

إثبات صحة الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من Chartboost، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات Chartboost (العرض بدون انقطاع).

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

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

رموز الخطأ

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

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

GADMAdapterChartboost
GADMediationAdapterChartboost

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل Chartboost عند تعذُّر تحميل إعلان:

سجلّ التغييرات في Chartboost Flutter Mediation Adapter

1.0.0

• الإصدار الأولي
• تم التحقّق من التوافق مع الإصدار 9.8.1.0 من محوِّل Android في Chartboost
• تم التحقّق من التوافق مع الإصدار 9.8.0.0 من محوِّل Chartboost لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 5.2.0 من المكوّن الإضافي Flutter لإعلانات Google على الأجهزة الجوّالة.