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

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

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

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

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

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

الدمج اليدوي

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

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

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

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

انظر 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)

انظر Chartboost مقالة قانون خصوصية المستهلك في كاليفورنيا (CCPA) طرق الخصوصية في 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.getAdapterResponses() ضمن الفئات التالية:

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

في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل Chartboost عند تعذّر تحميل إعلان:

رمز الخطأ	السبب
0-99	عرَضَت حزمة Chartboost SDK خطأً. اطّلِع على مستندات 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 الاطّلاع على الرمز لمزيد من التفاصيل.