دمج Chartboost مع "توسّط AdMob"

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

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

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

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

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

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

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

• أحدث إصدار من Google Mobile Ads SDK for React Native
• الإصدار 0.85.0 أو إصدار أحدث من إطار عمل React Native
• للنشر على أجهزة Android
  • مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث
• للنشر على أجهزة iOS
  • أن يكون هدف نشر iOS هو الإصدار 13.0 أو إصدار أحدث
• مشروع React Native يعمل بشكل صحيح وتم ضبطه باستخدام Google Mobile Ads SDK for React Native يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads SDK for React Native لمزيد من التفاصيل.
  • تأكَّد من تنزيل مجلد adapters واستخراجه من مجلد gma-sdk-react-native. إذا لم يكن لديك مجلد adapters، اتّبِع الخطوات الأولى والثانية والثالثة في تثبيت Google Mobile Ads SDK for React Native.
• إعداد ميزة "توسّط AdMob"

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

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

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

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

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

ملاحظة: يمكنك الانتقال إلى لوحة بيانات تطبيقك من خلال علامة التبويب إدارة التطبيقات الموضّحة سابقًا واختيار تطبيقك.

Android

iOS

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

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

تعديل ملف 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 على مراجعة تطبيق الناشر.

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

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

Android

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

iOS

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

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

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

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

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

ملاحظة: قد يؤدي عدم دمج الإصدارات المتوافقة من Chartboost وGoogle Mobile Ads SDK for React Native إلى حدوث مشاكل في الإصدار.

في الدليل الجذري لمشروعك، ثبِّت محوِّل التوسّط Google Mobile Ads SDK for React Native الخاص بـ Chartboost. يُرجى إكمال الخطوات التالية:

1. انسخ ملف tar الخاص بمحوّل Google Mobile Ads SDK for React Native من دليل gma-sdk-react-native/adapters/chartboost/ إلى دليل local_packages/ في مشروعك. إذا لم يكن لديك المجلد adapters، يُرجى الاطّلاع على المتطلبات الأساسية.

   mkdir -p local_packages
   cp EXTRACT_DIR/gma-sdk-react-native/adapters/chartboost/gma-mediation-chartboost-0.1.0.tgz local_packages/
   

   استبدِل EXTRACT_DIR بالمسار إلى الدليل الذي استخرجت الأرشيف فيه.

2. ثبِّت حزمة المحوّل باستخدام أداة إدارة الحِزم المفضّلة لديك:

   npm

   npm install ./local_packages/gma-mediation-chartboost-0.1.0.tgz
   

   خيط غزل

   yarn add ./local_packages/gma-mediation-chartboost-0.1.0.tgz
   

3. إذا كنت تنشئ تطبيقًا لنظام التشغيل Android، أضِف المستودع التالي إلى ملف build.gradle في دليل android الخاص بمشروعك:

   repositories {
       google()
       mavenCentral()
       maven {
           url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
       }
   }
   

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

موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامة لحماية البيانات"

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

يتيح الإصدار 0.1.0 من محوّل Chartboost React Native والإصدارات الأحدث تمرير إشارات الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) من حزمة تطوير البرامج لمنصة UMP ومنصات إدارة الموافقة التي تتكامل مع مواصفات الموافقة الإضافية من Google إلى حزمة تطوير البرامج (SDK) من Chartboost. لمزيد من المعلومات، يُرجى الاطّلاع على طرق الخصوصية في حزمة تطوير البرامج (SDK) لنظامَي التشغيل Android وiOS.

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

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

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

import {
  ChartboostCCPAConsent,
  ChartboostMediation,
} from '@google/gma-mediation-chartboost';
// ...

ChartboostMediation.addCCPADataUseConsent(ChartboostCCPAConsent.OPT_IN_SALE);

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

Android

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

iOS

تكامل SKAdNetwork

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

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

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

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

ملاحظة مهمة: عليك إيقاف وضع الاختبار في 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 يمكنك الاطّلاع على الرمز لمزيد من التفاصيل.

الإصدار 0.1.0

• الإصدار الأوّلي

• يتوافق مع الإصدار 9.12.0.0 من محوّل Chartboost لنظام التشغيل Android.
• متوافق مع الإصدار 9.12.0.1 من محوّل Chartboost لنظام التشغيل iOS