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

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

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

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

يملك محوّل توسّط AdMob لـ Chartboost الإمكانات التالية:

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

المتطلبات

  • أحدث Google Mobile Ads Flutter Plugin
  • ‫Flutter 3.7.0 أو إصدار أحدث
  • للنشر على Android
    • المستوى 23 من واجهة برمجة تطبيقات Android أو إصدار أحدث
  • للنشر على iOS
    • هدف النشر على iOS 13.0 أو إصدار أحدث
  • مشروع Flutter قيد التشغيل تم إعداده باستخدام Google Mobile Ads Flutter Plugin. لمزيد من التفاصيل، يُرجى الاطّلاع على إعداد Google Mobile Ads Flutter Plugin.
  • إعداد ميزة "توسّط AdMob"

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

Chartboost api explorer

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

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

التكامل من خلال pub.dev

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

dependencies:
  gma_mediation_chartboost: ^1.4.2

الدمج اليدوي

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

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

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

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

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

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

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

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

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

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

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 Flutter

الإصدار 1.4.2

الإصدار 1.4.1

الإصدار 1.4.0

الإصدار 1.3.3

الإصدار 1.3.2

الإصدار 1.3.1

الإصدار 1.3.0

الإصدار 1.2.1

الإصدار 1.2.0

الإصدار 1.1.0

الإصدار 1.0.2

الإصدار 1.0.1

الإصدار 1.0.0