تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

يوفّر Ad Manager محوِّل التوسط لتطبيق Chartboost الإمكانات التالية:

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

المتطلّبات

المستوى 21 من واجهة برمجة تطبيقات Android أو أعلى

أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
إكمال عملية التوسّط دليل البدء

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

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

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

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

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

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

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

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

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

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

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

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

مستكشف واجهات برمجة التطبيقات في Chartboost

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

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

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

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

وضع اختبار Chartboost

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

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

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

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

سجِّل الدخول إلى حسابك على "مدير الإعلانات".

انتقِل إلى عرض الإعلانات > مجموعات الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة الشبكات الإعلانية المدِرّة للأرباح جديدة.

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

بعد ذلك، انقر على الزر إضافة شريك أرباح.

إذا كان لديك شريك أرباح في Chartboost، يمكنك اختياره. إذا لم يكن لديك حساب، اختَر إنشاء شريك جديد لتحقيق الأرباح.

اختَر Chartboost باعتبارها شبكة الإعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط.

فعِّل الجمع التلقائي للبيانات، وأدخِل User ID and User Signature الذي تم الحصول عليه في القسم السابق.

بعد اختيار الشريك المحقِّق للأرباح، اختر توسّط حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وAndroid باعتبارها النظام الأساسي، ونشط كالحالة. أدخِل App ID, App Signature and Ad Location الذي تم الحصول عليه في القسم السابق. ثم أدخِل قيمة التكلفة التلقائية لكل ألف ظهور.

مواقع إعلانات Chartboost (المواقع الجغرافية التي تمت تسميتها) هي أسماء بسيطة تمثل مكانًا في تطبيقك تريد عرض الإعلان فيه. Ad Manager يرسل الطلبات إلى الموقع الجغرافي المحدد في الإعدادات. بعد إرسال الطلبات، سيضيف Chartboost الموقع إلى واجهة المستخدم لأغراض إعداد التقارير.

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

انقر على حفظ في أسفل الصفحة عند الانتهاء.

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

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

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

دمج "استوديو Android" (يُنصح به)

في ملف settings.gradle.kts على مستوى المشروع، أضِف المستودعات التالية:

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

بعد ذلك، في ملف build.gradle.kts على مستوى التطبيق، أضِف تبعيات التنفيذ وإعداداته التالية. استخدِم أحدث إصدارات من Chartboost SDK ومحوّل:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:chartboost:9.6.1.0")
}

الدمج اليدوي

نزِّل ملف .aar لأحدث إصدار من Chartboost SDK من Maven Central، وأضِفه إلى مشروعك.
انتقِل إلى عناصر محوّل Chartboost في مستودع Maven من Google. اختَر أحدث إصدار ونزِّل ملف .aar الخاص بمعدِّل Chartboost وأضِفه إلى مشروعك.

الخطوة 4: تنفيذ إعدادات الخصوصية في Chartboost SDK

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

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

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

Java

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

Kotlin

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

يمكنك الاطّلاع على مقالة طلب موافقة المستخدمين بموجب "اللائحة العامة لحماية البيانات" (GDPR) على موقع Chartboost و طرق الخصوصية على Android لمعرفة مزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة.

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

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

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

Java

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

Kotlin

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

يمكنك الاطّلاع على مقالة قانون خصوصية المستهلك في كاليفورنيا (CCPA) من موقع Chartboost الإلكتروني بالإضافة إلى طرق الخصوصية لنظام التشغيل Android لمعرفة مزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة.

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

تعديل AndroidManifest

عناصر أخرى

أضِف السمة التالية إلى كل نشاط في ملف AndroidManifest.xml الذي سيعرض إعلانات Chartboost ويدعم اتجاهات مختلفة:

android:configChanges="keyboardHidden|orientation|screenSize"

أحداث مراحل النشاط

وفقًا لاقتراح Chartboost، أضِف الرمز التالي إلى جميع أحداث مراحل نشاط نشاطك التي ستعرض إعلانات Chartboost.

Java

import com.chartboost.sdk.Chartboost;
// ...

@Override
public void onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed()) {
        return;
    } else {
        super.onBackPressed();
    }
}

Kotlin

import com.chartboost.sdk.Chartboost
// ...

@Override
fun onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed())
        return
    else
        super.onBackPressed()
}

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

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

احرص على تسجيل جهاز الاختبار من أجل Ad Manager وتفعيل وضع الاختبار في واجهة المستخدم Chartboost .

التحقّق من الإعلانات الاختبارية

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

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

الأذونات

للحصول على الأداء الأمثل، تنصح Chartboost بإضافة الأذونات الاختيارية التالية إلى ملف AndroidManifest.xml الخاص بتطبيقك:

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

رموز الخطأ

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

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

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

رمز الخطأ	السبب
0-99	حدث خطأ في حزمة تطوير البرامج (SDK) في Chartboost. يمكنك الاطّلاع على مستندات Chartboost لمزيد من التفاصيل.
101	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع Chartboost.
102	يمكن لأداة Chartboost تحميل إعلان واحد فقط لكل موقع جغرافي في المرة الواحدة.
103	معلَمات خادم Chartboost التي تم ضبطها في Ad Manager واجهة المستخدم غير متوفّرة/غير صالحة.
104	لن يكون الإعلان البيني أو الذي يضم مكافأة في Chartboost غير جاهز للعرض.
101	معلَمات خادم Chartboost التي تم ضبطها في Ad Manager واجهة المستخدم غير متوفّرة/غير صالحة.
102	عرضت حزمة تطوير البرامج (SDK) في Chartboost خطأ في الإعداد.
103	لا يتم تخزين إعلان Chartboost مؤقتًا في وقت العرض.
104	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع Chartboost.
105	إصدار نظام تشغيل الجهاز أقل من الحد الأدنى لإصدار نظام التشغيل المتوافق مع حزمة Chartboost SDK.
200-299	أخطاء ذاكرة التخزين المؤقت لحزمة تطوير البرامج (SDK) في Chartboost اطّلِع على الرمز البرمجي لمزيد من التفاصيل.
300-399	تعرض حزمة تطوير البرامج (SDK) في Chartboost أخطاء. اطّلِع على الرمز البرمجي لمزيد من التفاصيل.
400-499	أخطاء النقر على حزمة تطوير البرامج (SDK) في Chartboost اطّلِع على الرمز البرمجي لمزيد من التفاصيل.