Chartboost را با میانجیگری ادغام کنید

این راهنما به شما نشان می دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Chartboost با استفاده از میانجیگری AdMob ،پوشش ادغام آبشار نحوه افزودن Chartboost به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Chartboost SDK و آداپتور را در یک iOS برنامه

ادغام ها و قالب های تبلیغاتی پشتیبانی شده

آداپتور میانجی برای Chartboost دارای قابلیت های زیر است:

الزامات

• هدف استقرار iOS 12.0 یا بالاتر

• جدیدترین SDK تبلیغات موبایل گوگل

• راهنمای شروع میانجیگری را کامل کنید

مرحله 1: تنظیمات را در Chartboost UI تنظیم کنید

برای یک حساب Chartboost ثبت نام کنید و پس از تأیید حساب خود وارد شوید . سپس، به تب مدیریت برنامه ها بروید.

برای ایجاد برنامه خود، روی دکمه افزودن برنامه جدید کلیک کنید.

بقیه فرم را پر کنید و روی دکمه افزودن برنامه کلیک کنید تا برنامه شما نهایی شود.

پس از ایجاد برنامه، به داشبورد آن هدایت خواهید شد. به شناسه برنامه و امضای برنامه برنامه خود توجه داشته باشید.

AdMob برای تنظیم شناسه واحد تبلیغات AdMob به شناسه کاربر Chartboost و امضای کاربر نیاز دارد. می‌توانید این پارامترها را با کلیک کردن روی میانجی‌گری Chartboost در رابط کاربری Chartboost بیابید.

به برگه Resources > API Explorer بروید و شناسه کاربری و امضای کاربر خود را که در زیر بخش Authentication قرار دارد، یادداشت کنید.

حالت تست را روشن کنید

می‌توانید با رفتن به برگه مدیریت برنامه‌ها از رابط کاربری Chartboost، انتخاب برنامه خود از لیست و کلیک کردن بر روی ویرایش تنظیمات برنامه ، حالت تست را در برنامه خود فعال کنید.

از تنظیمات برنامه خود، می توانید حالت تست را در برنامه خود تغییر دهید.

پس از فعال شدن حالت تست، می‌توانید با استفاده از شناسه واحد تبلیغاتی که قبلاً ایجاد شده بود، درخواست تبلیغات کنید و یک تبلیغ آزمایشی Chartboost دریافت کنید.

پس از اینکه بتوانید تبلیغات آزمایشی Chartboost را دریافت کنید، برنامه شما در بررسی برنامه ناشر Chartboost قرار می گیرد. برای اینکه کسب درآمد در Chartboost کار کند، بررسی برنامه ناشر باید توسط Chartboost تأیید شود.

مرحله 2: تقاضای Chartboost را در آن تنظیم کنید AdMob UI

تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید

باید Chartboost را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.

ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر گروه میانجی موجودی دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید، و به افزودن Chartboost به عنوان منبع آگهی بروید.

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی Continue کلیک کنید.

به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغات AdMob موجود خود مرتبط کنید. سپس روی Done کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کرده‌اید مشاهده کنید:

Chartboost را به عنوان منبع تبلیغاتی اضافه کنید

Chartboost را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید

برای افزودن Chartboost به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

مرحله 3: Chartboost SDK و آداپتور را وارد کنید

استفاده از CocoaPods (توصیه می شود)

• خط زیر را به Podfile پروژه خود اضافه کنید:

  pod 'GoogleMobileAdsMediationChartboost'
  

• از خط فرمان اجرا کنید:

  pod install --repo-update
  

ادغام دستی

• آخرین نسخه Chartboost SDK را دانلود کنید و Chartboost.framework و CHAMoatMobileAppKit.framework را در پروژه خود پیوند دهید.

• آخرین نسخه آداپتور Chartboost را از لینک دانلود در Changelog دانلود کنید و ChartboostAdapter.framework را در پروژه خود پیوند دهید.

• چارچوب های زیر را به پروژه خود اضافه کنید:

  • StoreKit
  • Foundation
  • CoreGraphics
  • WebKit
  • AVFoundation
  • UIKit

مرحله 4: تنظیمات حریم خصوصی را در Chartboost SDK اجرا کنید

رضایت اتحادیه اروپا و GDPR

تحت «خط‌مشی رضایت کاربر اتحادیه اروپا» Google، باید اطمینان حاصل کنید که اطلاعات مشخصی در رابطه با استفاده از شناسه‌های دستگاه و داده‌های شخصی به کاربران منطقه اقتصادی اروپا (EEA) داده می‌شود و از آنها رضایت گرفته می‌شود. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. هنگام درخواست رضایت، باید هر شبکه تبلیغاتی را در زنجیره میانجی خود شناسایی کنید که ممکن است داده‌های شخصی را جمع‌آوری، دریافت یا استفاده کند و اطلاعاتی درباره استفاده هر شبکه ارائه دهد. Google در حال حاضر نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.

در SDK نسخه 8.2.0، Chartboost متد addDataUseConsent را اضافه کرد. کد نمونه زیر رضایت استفاده از داده ها را با CHBGDPRConsentNonBehavioral تنظیم می کند. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.

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

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

مقاله GDPR Chartboost و آنها را ببینیدروش‌های حفظ حریم خصوصی iOSبرای جزئیات بیشتر و مقادیر قابل ارائه در هر روش.

قوانین حفظ حریم خصوصی ایالات متحده

قوانین حفظ حریم خصوصی ایالات متحده مستلزم دادن حق انصراف کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف ارائه شده از طریق پیوند برجسته "اطلاعات شخصی من را نفروش" در "فروش" "صفحه اصلی حزب. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.

در SDK نسخه 8.2.0، Chartboost متد addDataUseConsent را اضافه کرد. کد نمونه زیر رضایت استفاده از داده را با CHBCCPAConsentOptInSale تنظیم می کند. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید.

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

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

مقاله CCPA Chartboost و آنها را ببینیدروش‌های حفظ حریم خصوصی iOSبرای جزئیات بیشتر و مقادیر قابل ارائه در هر روش.

کدهای خطا

اگر آداپتور نتواند تبلیغی را از Chartboost دریافت کند، می‌توانید خطای اساسی را از پاسخ آگهی با استفاده از آن بررسی کنید.GADResponseInfo.adNetworkInfoArray تحت کلاس های زیر:

GADMAdapterChartboost
GADMediationAdapterChartboost

در اینجا کدها و پیام‌های همراهی وجود دارد که توسط آداپتور Chartboost هنگام بارگیری نشدن آگهی ارسال می‌شود:

Changelog آداپتور میانجی‌گری Chartboost iOS

نسخه 9.8.0.0

• سازگاری تایید شده با Chartboost SDK نسخه 9.8.0.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 11.11.0.
• Chartboost SDK نسخه 9.8.0.

نسخه 9.7.0.1

• CFBundleShortVersionString به‌روزرسانی کرد تا به جای چهار مؤلفه، سه مؤلفه داشته باشد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 11.10.0.
• Chartboost SDK نسخه 9.7.0.

نسخه 9.7.0.0

• سازگاری تایید شده با Chartboost SDK نسخه 9.7.0.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 11.2.0.
• Chartboost SDK نسخه 9.7.0.

نسخه 9.6.0.1

• اکنون به حداقل نسخه iOS 12.0 نیاز دارد.
• اکنون به Google Mobile Ads SDK نسخه 11.0 یا بالاتر نیاز دارد.
• Info.plist در چارچوب های ChartboostAdapter.xcframework گنجانده شده است.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 11.0.1.
• Chartboost SDK نسخه 9.6.0.

نسخه 9.6.0.0

• سازگاری تایید شده با Chartboost SDK نسخه 9.6.0.
• روش منسوخ شده GADMobileAds.sharedInstance.sdkVersion با GADMobileAds.sharedInstance.versionNumber جایگزین کرد.
• اجرای GADMediationInterstitialAd اضافه شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 10.14.0.
• Chartboost SDK نسخه 9.6.0.

نسخه 9.5.1.0

• سازگاری تایید شده با Chartboost SDK نسخه 9.5.1.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 10.12.0.
• Chartboost SDK نسخه 9.5.1.

نسخه 9.4.0.0

• سازگاری تایید شده با Chartboost SDK نسخه 9.4.0.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 10.7.0.
• Chartboost SDK نسخه 9.4.0.

نسخه 9.3.1.0

• سازگاری تایید شده با Chartboost SDK نسخه 9.3.1.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 10.7.0.
• Chartboost SDK نسخه 9.3.1.

نسخه 9.3.0.0

• سازگاری تایید شده با Chartboost SDK نسخه 9.3.0.
• اکنون به حداقل نسخه iOS 11.0 نیاز دارد.
• اکنون به Google Mobile Ads SDK نسخه 10.4.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 10.4.0.
• Chartboost SDK نسخه 9.3.0.

نسخه 9.2.0.0

• واردات GADMChartboostExtras در فایل هدر ChartboostAdapter حذف شد.
• سازگاری تایید شده با Chartboost SDK نسخه 9.2.0.
• اکنون به Google Mobile Ads SDK نسخه 10.0.0 یا بالاتر نیاز دارد.
• پشتیبانی از معماری armv7 حذف شد.
• اکنون به حداقل نسخه iOS 11.0 نیاز دارد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 10.0.0.
• Chartboost SDK نسخه 9.2.0.

نسخه 9.1.0.0

• سازگاری تایید شده با Chartboost SDK نسخه 9.1.0.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 9.11.0.
• Chartboost SDK نسخه 9.1.0.

نسخه 9.0.0.0

• سازگاری تایید شده با Chartboost SDK نسخه 9.0.0.
• سازگاری تأیید شده با Google Mobile Ads SDK نسخه 9.10.0.
• آداپتور را برای استفاده از didRewardUser API به روز کرد.
• اکنون به Google Mobile Ads SDK نسخه 9.8.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 9.10.0.
• Chartboost SDK نسخه 9.0.0.

نسخه 8.5.0.2

• سازگاری تأیید شده با Google Mobile Ads SDK نسخه 9.0.0.
• اکنون به Google Mobile Ads SDK نسخه 9.0.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 9.0.0.
• Chartboost SDK نسخه 8.5.0.

نسخه 8.5.0.1.0

• سازگاری تایید شده با Chartboost SDK 8.5.0 که به نسخه 8.5.0.1 در CocoaPods اشاره دارد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 8.13.0.
• Chartboost SDK نسخه 8.5.0.

نسخه 8.5.0.0

• سازگاری تایید شده با Chartboost SDK 8.5.0.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 8.12.0.
• Chartboost SDK نسخه 8.5.0.

نسخه 8.4.2.0

• سازگاری تایید شده با Chartboost SDK 8.4.2.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 8.6.0.
• Chartboost SDK نسخه 8.4.2.

نسخه 8.4.1.1

• وابستگی آرام به Google Mobile Ads SDK نسخه 8.0.0 یا بالاتر.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 8.4.0.
• Chartboost SDK نسخه 8.4.1.

نسخه 8.4.1.0

• سازگاری تایید شده با Chartboost SDK 8.4.1.
• اکنون به Google Mobile Ads SDK نسخه 8.1.0 یا بالاتر نیاز دارد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 8.1.0.
• Chartboost SDK نسخه 8.4.1.

نسخه 8.4.0.1

• کدها و پیام های خطای استاندارد آداپتور اضافه شده است.
• آداپتور را برای استفاده از قالب .xcframework . به روز کرد.
• اکنون به Google Mobile Ads SDK نسخه 8.0.0 یا بالاتر نیاز دارد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 8.0.0.
• Chartboost SDK نسخه 8.4.0.

نسخه 8.4.0.0

• سازگاری تایید شده با Chartboost SDK 8.4.0.
• اکنون به Google Mobile Ads SDK نسخه 7.68.0 یا بالاتر نیاز دارد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.68.0.
• Chartboost SDK نسخه 8.4.0.

نسخه 8.3.1.0

• سازگاری تایید شده با Chartboost SDK 8.3.1.
• اکنون به Google Mobile Ads SDK نسخه 7.66.0 یا بالاتر نیاز دارد.
• اکنون به حداقل نسخه iOS 10.0 نیاز دارد.
• آداپتور را برای پشتیبانی از درخواست های بنر تطبیقی ​​به روز کرد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.66.0.
• Chartboost SDK نسخه 8.3.1.

نسخه 8.2.1.0

• سازگاری تایید شده با Chartboost SDK 8.2.1.
• اکنون به Google Mobile Ads SDK نسخه 7.64.0 یا بالاتر نیاز دارد.
• اکنون به حداقل نسخه iOS 9.0 نیاز دارد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.64.0.
• Chartboost SDK نسخه 8.2.1.

نسخه 8.2.0.0

• سازگاری تایید شده با Chartboost SDK 8.2.0.
• اکنون به Google Mobile Ads SDK نسخه 7.61.0 یا بالاتر نیاز دارد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.61.0.
• Chartboost SDK نسخه 8.2.0.

نسخه 8.1.0.1

• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 7.60.0 به روز شد.
• آداپتور را برای استفاده از API جدید Chartboost به روز کرد و API های منسوخ را حذف کرد.
• آداپتور اکنون از بارگیری تبلیغات چندگانه با همان فرمت با استفاده از مکان Chartboost یکسان پشتیبانی می کند.
• اگر پاداش در رابط کاربری AdMob یا Ad Manager لغو نشود، ارزش پاداش برای تبلیغات پاداش داده شده اکنون به جای 0 ، مقدار مشخص شده در رابط کاربری Chartboost است.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.60.0.
• Chartboost SDK نسخه 8.1.0.

نسخه 8.1.0.0

• سازگاری تایید شده با Chartboost SDK 8.1.0.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 7.59.0 به روز شد.
• پشتیبانی از معماری i386 حذف شد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.59.0.
• Chartboost SDK نسخه 8.1.0.

نسخه 8.0.4.0

• سازگاری تایید شده با Chartboost SDK 8.0.4.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.52.0.
• Chartboost SDK نسخه 8.0.4.

نسخه 8.0.1.1

• رفع مشکلی که در آن درخواست تبلیغات بنری بدون پر شده است.

نسخه 8.0.1.0

• سازگاری تایید شده با Chartboost SDK 8.0.1.
• پشتیبانی برای درخواست تبلیغات بنری اضافه شده است.

نسخه 7.5.0.1

• کد اضافه شده برای مقداردهی اولیه Chartboost SDK.

نسخه 7.5.0.0

• سازگاری تایید شده با Chartboost SDK 7.5.0.
• آداپتور را برای استفاده از API جدید پاداش به روز کرد.
• آداپتور را برای رسیدگی به چندین درخواست بینابینی به روز کرد.
• اکنون به Google Mobile Ads SDK نسخه 7.42.2 یا بالاتر نیاز دارد.

نسخه 7.3.0.0

• سازگاری تایید شده با Chartboost SDK 7.3.0.

نسخه 7.2.0.1

• adapterDidCompletePlayingRewardBasedVideoAd: برگشت به آداپتور.

نسخه 7.2.0.0

• سازگاری تایید شده با Chartboost SDK 7.2.0.

نسخه 7.1.2.0

• سازگاری تایید شده با Chartboost SDK 7.1.2.

نسخه 7.1.1.0

• سازگاری تایید شده با Chartboost SDK 7.1.1.

نسخه 7.1.0.0

• سازگاری تایید شده با Chartboost SDK 7.1.0.

نسخه 7.0.4.0

• سازگاری تایید شده با Chartboost SDK 7.0.4.

نسخه 7.0.3.0

• سازگاری تایید شده با Chartboost SDK 7.0.3.

نسخه 7.0.2.0

• سازگاری تایید شده با Chartboost SDK 7.0.2.
• پشتیبانی از دو کد خطای جدید Chartboost اضافه شده است.

نسخه 7.0.1.0

• سازگاری تایید شده با Chartboost SDK 7.0.1.

نسخه 7.0.0.0

• سازگاری تایید شده با Chartboost SDK 7.0.0.

نسخه 6.6.3.0

• سازگاری تایید شده با Chartboost SDK 6.6.3.
• پشتیبانی از معماری 'armv7s' حذف شد.
• رفع اشکالی که در آن ناشران هنگام وارد کردن ChartboostAdapter.framework به عنوان یک ماژول که در حال وارد کردن Chartboost SDK غیر ماژولار بود، با مشکل تلفیقی در Swift مواجه شدند.

نسخه 6.6.2.0

• سازگاری تایید شده با Chartboost SDK 6.6.2.

نسخه 6.6.1.0

• سازگاری تایید شده با Chartboost SDK 6.6.1.

نسخه 6.6.0.0

• سازگاری تایید شده با Chartboost SDK 6.6.0.

نسخه 6.5.2.1

• پشتیبانی از بیت کد فعال شد.
• اکنون آداپتور Chartboost را به عنوان یک چارچوب توزیع می کنیم.
• برای وارد کردن ChartboostAdapter.framework در پروژه خود، مطمئن شوید که Allow Non-modular Includes in Framework Modules در زیر تنظیمات ساخت هدف خود روی YES تنظیم کنید.

نسخه 6.5.2.0

• سیستم نامگذاری نسخه را به [نسخه Chartboost SDK] تغییر داد. [نسخه وصله آداپتور].
• حداقل Chartboost SDK مورد نیاز را به نسخه 6.5.1 به روز کرد.
• حداقل مورد نیاز Google Mobile Ads SDK به نسخه 7.10.1 به روز شد.
• رفع اشکال برای پشتیبانی از چندین مکان تبلیغات Chartboost.
• برنامه‌ها اکنون interstitialWillDismissScreen: زمانی که آگهی بینابینی در شرف رد شدن است.
• برنامه‌ها اکنون rewardBasedVideoAdDidOpen: وقتی یک تبلیغ ویدیویی مبتنی بر پاداش باز می‌شود، پاسخ به تماس را دریافت می‌کنند.

نسخه 1.1.0

• Chartboost Ad Location از قسمت های اضافه Chartboost حذف شد. اکنون هنگام پیکربندی Chartboost برای میانجیگری، مکان آگهی در کنسول AdMob مشخص شده است.

نسخه 1.0.0

• انتشار اولیه از تبلیغات ویدیویی مبتنی بر پاداش و تبلیغات بینابینی پشتیبانی می کند.