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

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

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

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

یکپارچه سازی
مناقصه
آبشار
فرمت ها
بنر
بینابینی
پاداش داده شد

الزامات

  • یونیتی 4 یا بالاتر
  • جدیدترین SDK تبلیغات موبایل گوگل
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

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

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

داشبورد برنامه های Chartboost

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

مدیریت برنامه ها

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

فرم جدید اپلیکیشن

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

اندروید

تنظیمات برنامه

iOS

تنظیمات برنامه

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

داشبورد میانجی گری Chartboost

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

Chartboost Api Explorer

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

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

اندروید

تنظیمات برنامه را ویرایش کنید

iOS

تنظیمات برنامه را ویرایش کنید

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

حالت تست Chartboost

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

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

مرحله 2: تقاضای Chartboost را در رابط کاربری Ad Manager تنظیم کنید

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

اندروید

برای دستورالعمل‌ها، به مرحله 2 در راهنمای Android مراجعه کنید.

iOS

برای دستورالعمل‌ها، مرحله 2 را در راهنمای iOS ببینید.

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

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

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

OpenUPM-CLI

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای دستور زیر از دایرکتوری اصلی پروژه، افزونه Google Mobile Ads Chartboost Mediation for Unity را در پروژه خود نصب کنید:

openupm add com.google.ads.mobile.mediation.chartboost

OpenUPM

در ویرایشگر پروژه Unity خود، Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.

در برگه Scoped Registries ، OpenUPM را به عنوان یک رجیستری محدوده با جزئیات زیر اضافه کنید:

  • نام: OpenUPM
  • آدرس اینترنتی: https://package.openupm.com
  • محدوده (ها): com.google

جزئیات OpenUPM

سپس به مسیر Window > Package Manager بروید تا Unity Package Manager را باز کنید و My Registries را از منوی کشویی انتخاب کنید.

ثبت واحدها

بسته Google Mobile Ads Chartboost Mediation را انتخاب کنید و روی Install کلیک کنید.

از OpenUPM نصب کنید

پکیج یونیتی

آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل برای 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 شما کپی می کند.

اجباری حل و فصل

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

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

افزونه میانجی گری تبلیغات موبایل Google برای Chartboost نسخه 3.1.0 شامل متد Chartboost.AddDataUseConsent() است. کد نمونه زیر رضایت استفاده از داده ها را به NonBehavioral تنظیم می کند. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌شود قبل از درخواست تبلیغات با استفاده از Google Mobile Ads SDK این کار را انجام دهید.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

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

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

افزونه میانجی گری تبلیغات موبایل Google برای Chartboost نسخه 3.1.0 شامل متد Chartboost.AddDataUseConsent() است. کد نمونه زیر رضایت استفاده از داده ها را به OptInSale تنظیم می کند. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌شود قبل از درخواست تبلیغات با استفاده از Google Mobile Ads SDK این کار را انجام دهید.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

مرحله 5: کد مورد نیاز را اضافه کنید

اندروید

هیچ کد اضافی برای ادغام Chartboost مورد نیاز نیست.

iOS

ادغام SKAdNetwork

مستندات Chartboost را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.

مرحله 6: اجرای خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید و حالت تست را در Chartboost UI فعال کرده اید .

تبلیغات آزمایشی را تأیید کنید

برای تأیید اینکه آگهی‌های آزمایشی را از Chartboost دریافت می‌کنید، با استفاده از منبع(های) آگهی Chartboost (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.

مراحل اختیاری

اندروید

مجوزها

برای عملکرد بهینه، Chartboost توصیه می‌کند مجوزهای اختیاری زیر را به فایل AndroidManifest.xml برنامه خود اضافه کنید:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

iOS

هیچ مرحله اضافی برای ادغام iOS لازم نیست.

کدهای خطا

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

اندروید 

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

iOS 

GADMAdapterChartboost
GADMediationAdapterChartboost

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

اندروید

کد خطا دلیل
0-99 Chartboost SDK خطایی را برگرداند.
101 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده Chartboost مطابقت ندارد.
102 Chartboost فقط می تواند 1 تبلیغ را در هر مکان بارگیری کند.
103 پارامترهای سرور Chartboost پیکربندی شده در رابط کاربری Ad Manager وجود ندارد/نامعتبر است.
104 تبلیغ بین‌اصل یا دارای پاداش Chartboost برای نمایش آماده نیست.

iOS

کد خطا دلیل
101 پارامترهای سرور Chartboost پیکربندی شده در رابط کاربری Ad Manager وجود ندارد/نامعتبر است.
102 Chartboost SDK یک خطای اولیه را برگرداند.
103 تبلیغ Chartboost در زمان نمایش در حافظه پنهان ذخیره نمی شود.
104 اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده Chartboost مطابقت ندارد.
105 نسخه سیستم عامل دستگاه کمتر از حداقل نسخه سیستم عامل پشتیبانی شده Chartboost SDK است.
200-299 خطاهای حافظه نهان SDK Chartboost. برای جزئیات بیشتر به کد مراجعه کنید.
300-399 خطاهای نمودار Chartboost SDK. برای جزئیات بیشتر به کد مراجعه کنید.
400-499 خطاهای کلیک Chartboost SDK. برای جزئیات بیشتر به کد مراجعه کنید.

Chartboost Unity Mediation Plugin Changelog

نسخه 4.7.0

نسخه 4.6.1

نسخه 4.6.0

نسخه 4.5.0

نسخه 4.4.0

نسخه 4.3.0

نسخه 4.2.0

نسخه 4.1.1

نسخه 4.1.0

نسخه 4.0.0

نسخه 3.5.1

نسخه 3.5.0

نسخه 3.4.1

نسخه 3.4.0

نسخه 3.3.1

نسخه 3.3.0

نسخه 3.2.0

نسخه 3.1.0

نسخه 3.0.1

نسخه 3.0.0

نسخه 2.0.1

نسخه 2.0.0

  • از آداپتور اندروید Chartboost نسخه 7.5.0.0 پشتیبانی می کند.
  • از آداپتور Chartboost iOS نسخه 8.0.1.1 پشتیبانی می کند.

نسخه 1.3.0

  • افزونه را برای پشتیبانی از Rewarded API جدید به روز کرد.
  • از آداپتور Chartboost اندروید نسخه 7.3.1.1 پشتیبانی می کند.
  • از آداپتور Chartboost iOS نسخه 7.5.0.0 پشتیبانی می کند.

نسخه 1.2.0

  • از آداپتور اندروید Chartboost نسخه 7.3.0.0 پشتیبانی می کند.
  • از آداپتور Chartboost iOS نسخه 7.3.0.0 پشتیبانی می کند.

نسخه 1.1.1

  • از آداپتور اندروید Chartboost نسخه 7.2.0.1 پشتیبانی می کند.
  • از آداپتور Chartboost iOS نسخه 7.2.0.1 پشتیبانی می کند.

نسخه 1.1.0

  • پشتیبانی از Chartboost Android SDK نسخه 7.2.0.
  • پشتیبانی از Chartboost iOS SDK نسخه 7.2.0.
  • متد Chartboost.RestrictDataCollection() برای فعال کردن محدودیت‌های جمع‌آوری داده‌های GDPR برای Chartboost SDK اضافه شد.

نسخه 1.0.0

  • اولین انتشار!
  • پشتیبانی از Chartboost Android SDK نسخه 7.0.1.
  • پشتیبانی از Chartboost iOS SDK نسخه 7.1.2.