این راهنما به شما نشان میدهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از Chartboost با استفاده از میانجیگری استفاده کنید، و ادغامهای آبشاری را پوشش میدهد. این راهنما نحوه اضافه کردن Chartboost به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور Chartboost در یک برنامه Unity را پوشش میدهد.
آداپتور میانجیگری AdMob برای Chartboost دارای قابلیتهای زیر است:
ادغام | |
---|---|
مناقصه | |
آبشار | |
قالبها | |
بنر | |
بینابینی | |
پاداش داده شده |
- جدیدترین SDK تبلیغات موبایلی گوگل
- یونیتی ۴ یا بالاتر
- برای نصب روی اندروید
- اندروید API سطح ۲۳ یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه Unity در حال کار که با SDK تبلیغات موبایلی گوگل پیکربندی شده است. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
- راهنمای شروع میانجیگری را تکمیل کنید
برای یک حساب کاربری Chartboost ثبت نام کنید و پس از تأیید حساب کاربری خود، وارد سیستم شوید . سپس، به برگه مدیریت برنامهها بروید.
برای ایجاد برنامه خود، روی دکمه افزودن برنامه جدید کلیک کنید.
بقیه فرم را پر کنید و برای نهایی کردن برنامه خود، روی دکمه افزودن برنامه کلیک کنید.
پس از ایجاد برنامه، به داشبورد آن هدایت خواهید شد. شناسه برنامه (App ID) و امضای برنامه (App Signature) برنامه خود را یادداشت کنید.
ادموب برای تنظیم شناسه واحد تبلیغاتی ادموب شما به شناسه کاربری و امضای کاربر Chartboost نیاز دارد. میتوانید این پارامترها را با کلیک روی گزینه Chartboost mediation در رابط کاربری Chartboost پیدا کنید.
به برگه منابع > API Explorer بروید و شناسه کاربری و امضای کاربری خود را که در بخش احراز هویت قرار دارد، یادداشت کنید.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt
پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .
برای پیادهسازی app-ads.txt
برای Chartboost، به app-ads.txt مراجعه کنید.
شما میتوانید با رفتن به تب مدیریت برنامهها از رابط کاربری Chartboost، انتخاب برنامه از لیست و کلیک روی ویرایش تنظیمات برنامه ، حالت آزمایشی را برای برنامه خود فعال کنید.
از تنظیمات برنامه، میتوانید حالت آزمایشی را برای برنامه خود فعال یا غیرفعال کنید.
پس از فعال شدن حالت آزمایشی، میتوانید با استفاده از شناسه واحد تبلیغاتی که قبلاً ایجاد کردهاید، درخواست تبلیغات دهید و یک تبلیغ آزمایشی Chartboost دریافت کنید.
بعد از اینکه توانستید تبلیغات آزمایشی Chartboost را دریافت کنید، برنامه شما در بخش بررسی برنامه ناشر Chartboost قرار میگیرد. برای اینکه کسب درآمد در Chartboost انجام شود، بررسی برنامه ناشر باید توسط Chartboost تأیید شود.
برای دستورالعملها، به مرحله ۲ در راهنمای اندروید مراجعه کنید.
برای دستورالعملها، به مرحله ۲ در راهنمای iOS مراجعه کنید.
برای اضافه کردن Chartboost به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
اگر OpenUPM-CLI را نصب کردهاید، میتوانید افزونهی Google Mobile Ads Chartboost Mediation Plugin for Unity را با اجرای دستور زیر از دایرکتوری ریشهی پروژه، روی پروژهی خود نصب کنید:
openupm add com.google.ads.mobile.mediation.chartboost
در ویرایشگر پروژه یونیتی خود، گزینه Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.
در زیر تب Scoped Registries ، OpenUPM را به عنوان یک رجیستری Scoped با جزئیات زیر اضافه کنید:
- نام:
OpenUPM
- آدرس اینترنتی:
https://package.openupm.com
- محدوده(ها):
com.google
سپس، به مسیر Window > Package Manager بروید تا Unity Package Manager باز شود و از منوی کشویی، My Registrys را انتخاب کنید.
بستهی Google Mobile Ads Chartboost Mediation را انتخاب کرده و روی نصب کلیک کنید.
آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای Chartboost را از لینک دانلود موجود در Changelog دانلود کنید و بسته GoogleMobileAdsChartboostMediation.unitypackage
را از فایل زیپ استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsChartboostMediation.unitypackage
را که دانلود کردهاید، پیدا کنید. مطمئن شوید که همه فایلها انتخاب شدهاند و روی Import کلیک کنید.
سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تجزیه و تحلیل وابستگیها را از ابتدا انجام میدهد و وابستگیهای اعلام شده را در پوشه Assets/Plugins/Android
برنامه Unity شما کپی میکند.
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطهگری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکههایی منتقل کند.
افزونه میانجیگری تبلیغات موبایل گوگل برای Chartboost نسخه ۳.۱.۰ شامل متد Chartboost.AddDataUseConsent()
است. کد نمونه زیر، رضایت استفاده از دادهها را روی NonBehavioral
تنظیم میکند. اگر تصمیم به فراخوانی این متد دارید، توصیه میشود قبل از درخواست تبلیغات با استفاده از SDK تبلیغات موبایل گوگل، این کار را انجام دهید.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
افزونه میانجیگری تبلیغات موبایل گوگل برای Chartboost نسخه ۳.۱.۰ شامل متد Chartboost.AddDataUseConsent()
است. کد نمونه زیر، رضایت استفاده از دادهها را روی OptInSale
تنظیم میکند. اگر تصمیم به فراخوانی این متد دارید، توصیه میشود قبل از درخواست تبلیغات با استفاده از SDK تبلیغات موبایل گوگل، این کار را انجام دهید.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
برای ادغام Chartboost هیچ کد اضافی لازم نیست.
برای افزودن شناسههای SKAdNetwork به فایل Info.plist
پروژه خود ، مستندات Chartboost را دنبال کنید.
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کردهاید و حالت آزمایشی را در Chartboost UI فعال کردهاید . برای تأیید اینکه تبلیغات آزمایشی را از Chartboost دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی Chartboost (آبشاری ) فعال کنید. برای عملکرد بهینه، Chartboost توصیه میکند مجوزهای اختیاری زیر را به فایل هیچ مرحله اضافی برای ادغام iOS لازم نیست. اگر آداپتور نتواند تبلیغی از Chartboost دریافت کند، ناشران میتوانند خطای اساسی را از پاسخ تبلیغ با استفاده از در اینجا کدها و پیامهای همراه که توسط آداپتور Chartboost هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آمده است: AndroidManifest.xml
برنامه خود اضافه کنید:<uses-permission android:name="android.permission.READ_PHONE_STATE" />
ResponseInfo
تحت کلاسهای زیر بررسی کنند: com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
GADMAdapterChartboost
GADMediationAdapterChartboost
کد خطا دلیل ۰-۹۹ Chartboost SDK خطایی را برگرداند. ۱۰۱ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط Chartboost مطابقت ندارد. ۱۰۲ Chartboost فقط میتواند ۱ تبلیغ را در هر مکان به طور همزمان بارگذاری کند. ۱۰۳ پارامترهای سرور Chartboost که در رابط کاربری AdMob پیکربندی شدهاند، وجود ندارند/نامعتبر هستند. ۱۰۴ تبلیغ بینابینی یا پاداشی Chartboost آماده نمایش نیست. کد خطا دلیل ۱۰۱ پارامترهای سرور Chartboost که در رابط کاربری AdMob پیکربندی شدهاند، وجود ندارند/نامعتبر هستند. ۱۰۲ SDK مربوط به Chartboost خطای مقداردهی اولیه را برگرداند. ۱۰۳ تبلیغ Chartboost در زمان نمایش ذخیره نمیشود. ۱۰۴ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط Chartboost مطابقت ندارد. ۱۰۵ نسخه سیستم عامل دستگاه پایینتر از حداقل نسخه سیستم عامل پشتیبانی شده توسط Chartboost SDK است. ۲۰۰-۲۹۹ خطاهای حافظه پنهان SDK مربوط به Chartboost. برای جزئیات بیشتر به کد مراجعه کنید. ۳۰۰-۳۹۹ نمودار SDK خطاها را نشان میدهد. برای جزئیات بیشتر به کد مراجعه کنید. ۴۰۰-۴۹۹ خطاهای کلیک در Chartboost SDK. برای جزئیات بیشتر به کد مراجعه کنید. DummyClient
به PlaceholderClient
تغییر یافت.GoogleMobileAds/Mediation/Chartboost/
منتقل شد.GoogleMobileAds.Mediation.Chartboost
بازسازی شده است.RestrictDataCollection()
از کلاس Chartboost
حذف شد.AddDataUseConsent()
برای ارسال اطلاعات GDPR و CCPA به Chartboost اضافه شد.Chartboost.RestrictDataCollection()
برای فعال کردن محدودیتهای جمعآوری دادههای GDPR برای Chartboost SDK اضافه شد.