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

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

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

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

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

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

المتطلّبات

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

أحدث حزمة SDK لإعلانات Google على الجوال

الخطوة 1: إعداد Chartboost

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

إضافة تطبيق Chartboost

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

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

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

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

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

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

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

لإنشاء مجموعة توسط جديدة، اختر إنشاء مجموعة توسط.

علامة تبويب توسط AdMob Beta

أدخل شكل الإعلان والنظام الأساسي، ثم انقر على متابعة.

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

مجموعة التوسط الجديدة 2

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

اختيار وحدة إعلانية

من المفترض أن تشاهد الآن بطاقة الوحدات الإعلانية التي تمت تعبئتها بالوحدات الإعلانية التي حددتها.

الوحدات الإعلانية لمجموعة التوسط

إضافة Chartboost كمصدر إعلاني

في بطاقة مصادر الإعلانات، اختَر إضافة شبكة إعلانات. ثم اختَر Chartboost.

فعِّل مفتاح التحسين. أدخل User ID وتوقيع المستخدم اللذين تم الحصول عليهما في القسم السابق لإعداد تحسين مصدر الإعلان لتطبيق Chartboost. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور في Chartboost وانقر على متابعة.

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

تهيئة الوحدة الإعلانية في Chartboost

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

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

وأخيرًا، انقر على تم لإضافة Chartboost كمصدر إعلاني، ثم انقر على حفظ.

استخدام الإعلانات بمكافأة

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

في حال عدم تطبيق هذا الإعداد، سيعيد محوّل Chartboost المكافأة المحدّدة في واجهة مستخدم Chartboost.

لمزيد من المعلومات عن إعداد قيم المكافآت للوحدات الإعلانية في AdMob، يُرجى الاطّلاع على إنشاء وحدة إعلانية.

الخطوة 3: استيراد محوّل SDK وChartboost

دمج "استوديو Android" (موصى به)

أضف مستودع Maven التالي وتبعيات التنفيذ مع أحدث إصدارات Chartboost SDK والمحول إلى ملف build.gradle على مستوى التطبيق:

repositories {
    google()
    mavenCentral()
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:21.4.0'
    implementation 'com.google.ads.mediation:chartboost:9.1.1.0'
}
...

الدمج اليدوي

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

الخطوة 4: يلزم إدخال رمز إضافي

تعديل بيان البيان

العناصر الأخرى

أضِف السمة التالية إلى كل نشاط في ملف 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()
}

الخطوة 5: اختبار التنفيذ

يمكن تمكين الإعلانات الاختبارية لتطبيقك من لوحة بيانات Chartboost ضمن إعدادات التطبيق > الإعدادات الأساسية كما هو موضح أدناه.

وضع اختبار booboo

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

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

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

انتقل إلى تحقيق الدخل > نشر الحملات من القائمة على الجانب الأيمن، وانقر على إضافة حملة (أو + إضافة حملة في الجزء العلوي الأيسر من لوحة التحكم إذا كانت لديك بالفعل حملات أخرى) واختر نشر الشبكة عند المطالبة بذلك.

إضافة حملة Chartboost

أدخِل اسمًا لحملة النشر، ثم اختَر نوع الموضع، واختَر Google Play كـ النظام الأساسي. إذا تمت الموافقة على تطبيقك من قِبل Chartboost، ستتمكّن من اختيار تطبيقك وتطبيقه على هذه الحملة. املأ بقية النموذج وانقر على حفظ للانتهاء من إضافة الحملة.

حملة booboot

أكملت هذه الخطوة. لديك الآن دمج توسط صالح مع Chartboost.

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

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

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

إضافة Chartboost إلى قائمة شركاء الإعلانات باللائحة العامة لحماية البيانات

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

قانون خصوصية المستهلك في كاليفورنيا (CCPA)

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

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

الأذونات

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

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<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	عرض خطأ في Chartboost SDK خطأ. يمكنك الاطّلاع على الرمز للحصول على مزيد من التفاصيل.
101	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع Chartboost.
102	يمكن لـ Chartboost تحميل إعلان واحد فقط لكل موقع جغرافي في المرة الواحدة.
103	معلمات خادم Chartboost التي تم ضبطها في AdMob واجهة المستخدم مفقودة/غير صالحة.
101	معلمات خادم Chartboost التي تم ضبطها في AdMob واجهة المستخدم مفقودة/غير صالحة.
102	عرضت حزمة SDK Chartboost خطأ في الإعداد.
103	لا يتم تخزين إعلان Chartboost مؤقتًا في وقت العرض.
104	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع Chartboost.
105	إصدار نظام تشغيل الجهاز أقل من الحد الأدنى لإصدار نظام التشغيل المتوافق مع Chartboost SDK.
200-299	أخطاء ذاكرة التخزين المؤقت لحزمة SDK في Chartboost يمكنك الاطّلاع على الرمز للحصول على مزيد من التفاصيل.
300-399	تعرض حزمة تطوير البرامج في Chartboost الأخطاء. يمكنك الاطّلاع على الرمز للحصول على مزيد من التفاصيل.
400-499	أخطاء نقرات SDK للرسم البياني. يمكنك الاطّلاع على الرمز للحصول على مزيد من التفاصيل.

مراجع إضافية

يوفّر بدء حملة نشر تفاصيل إضافية عن كيفية إعداد حملات النشر في Chartboost.