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

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

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

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

يتضمّن محوِّل التوسّط في Chartboost الإمكانات التالية:

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

المتطلبات

الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

Android

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

iOS

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

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

وضع اختبار Chartboost

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

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

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

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

عليك إضافة Chartboost إلى إعداد التوسّط لوحدتك الإعلانية.

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

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

أدخِل شكل الإعلان والمنصّة، ثمّ انقر على متابعة.

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

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

من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية التي تمت تعبئتها بالوحدات الإعلانية التي حدّدتها:

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

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

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

إذا كان لديك تعيين بالفعل لـ Chartboost، يمكنك تحديده. بخلاف ذلك، انقر على إضافة تعيين.

بعد ذلك، أدخِل App ID, App Signature and Ad Location التي تم الحصول عليها في القسم السابق. بعد ذلك، انقر على تمّ.

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

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

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

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

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

استخدام CocoaPods (يُنصح به)

أضف السطر التالي إلى Podfile لمشروعك:
```
pod 'GoogleMobileAdsMediationChartboost'
```
من سطر الأوامر، قم بتشغيل:
```
pod install --repo-update
```

الدمج اليدوي

نزِّل أحدث إصدار من Chartboost SDK والرابط Chartboost.framework وCHAMoatMobileAppKit.framework في مشروعك.
نزِّل أحدث إصدار من محوّل Chartboost من رابط التنزيل في سجلّ التغييرات ربط ChartboostAdapter.framework في مشروعك.
أضف أطر العمل التالية إلى مشروعك:
- StoreKit
- Foundation
- CoreGraphics
- WebKit
- AVFoundation
- UIKit

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

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

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

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

Swift

let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];

انظر Chartboost مقالة اللائحة العامة لحماية البيانات طرق الخصوصية في iOS لمزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة.

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

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

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

Swift

let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];

انظر Chartboost مقالة قانون خصوصية المستهلك في كاليفورنيا (CCPA) طرق الخصوصية في iOS لمزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة.

رموز الخطأ

إذا فشل المحوّل في استلام إعلان من Chartboost، يمكنك التحقق من خطأ أساسي من استجابة الإعلان باستخدام GADResponseInfo.adNetworkInfoArray ضمن الفئات التالية:

GADMAdapterChartboost
GADMediationAdapterChartboost

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

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