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

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

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

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

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

Chartboost Api Explorer

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

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

اندروید

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

iOS

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

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

حالت تست Chartboost

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

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

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

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

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

،

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

،

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

مرحله 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: اجرای خود را آزمایش کنید

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

اندروید

مجوزها

برای عملکرد بهینه، 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

نسخه بعدی

  • DummyClient به PlaceholderClient تغییر نام داد.

نسخه 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.