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

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

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

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

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

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

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

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

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

هدف نشر iOS‏ 13.0 أو إصدار أحدث

أحدث إصدار من Google Mobile Ads SDK
إعداد التوسّط

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

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

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

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

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

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

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

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

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

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

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

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

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

تعديل ملف app-ads.txt

مبادرة البائعون المعتمَدون للتطبيقات (app-ads.txt) هي مبادرة من المختبَر التقني لمكتب الإعلانات التفاعلية (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقك إلا من خلال القنوات التي حدَّدت أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم تكن قد فعلت ذلك، أنشئ ملف app-ads.txt في "إدارة إعلانات Google".

لتنفيذ app-ads.txt في Chartboost، يُرجى الاطّلاع على app-ads.txt.

تفعيل "الوضع التجريبي"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بعد اختيار شريك إعلاني مدِّر للأرباح، اختَر التوسّط في حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وiOS كـ النظام الأساسي، ونشط كـ الحالة. أدخِل معرّف التطبيق وتوقيع التطبيق والموقع الجغرافي المستهدَف للإعلانات التي حصلت عليها في القسم السابق. بعد ذلك، أدخِل قيمة تكلفة تلقائية لكل ألف ظهور.

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

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

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

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

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

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

استخدام Swift Package Manager

قبل المتابعة، يجب أن يكون لديك الحد الأدنى من إصدار المحوّل المتوافق 9.11.0.1.

لإضافة حزمة تابعة إلى مشروعك، اتّبِع الخطوات التالية:

في Xcode، انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة... (File > Add Package Dependencies...).
في الطلب الذي يظهر، ابحث عن عنوان URL للحزمة التالية:
```
https://github.com/googleads/googleads-mobile-ios-mediation-chartboost.git
```
في قاعدة التبعية، اختَر الفرع.
في حقل النص، أدخِل main.

استخدام CocoaPods

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

الدمج اليدوي

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

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

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

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

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

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

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

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

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

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

تنفيذ SKAdNetwork

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

إعدادات المشروع

اضبط السماح بالتضمينات غير المعيارية في وحدات إطار العمل على YES ضمن إعدادات الإنشاء لهدفك.

أضِف القيمة -ObjC في Other Linker Flags ضمن Build Settings لمشروعك لكل من Debug وRelease.

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

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

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

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

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

رموز الخطأ

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

GADMAdapterChartboost
GADMediationAdapterChartboost

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

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