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

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

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

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

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

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل
  • فلاتر 3.7.0 یا بالاتر
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه Flutter در حال کار که با 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 را در رابط کاربری AdMob تنظیم کنید

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

اندروید

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

iOS

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

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

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

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

ادغام از طریق pub.dev

وابستگی زیر را با آخرین نسخه Chartboost SDK و آداپتور در فایل pubspec.yaml بسته خود اضافه کنید:

dependencies:
  gma_mediation_chartboost: ^1.0.0

ادغام دستی

آخرین نسخه افزونه واسطه تبلیغات موبایل گوگل را برای Chartboost دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml خود مراجعه کنید:

dependencies:
  gma_mediation_chartboost:
    path: path/to/local/package

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

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

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید و حالت تست را در 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 پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است.
104 تبلیغ بین‌اصل یا دارای پاداش Chartboost برای نمایش آماده نیست.

iOS

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

Chartboost Flutter Mediation Adapter Changelog

1.0.0

  • انتشار اولیه
  • سازگاری تأیید شده با آداپتور Chartboost Android نسخه 9.8.1.0
  • سازگاری تأیید شده با آداپتور Chartboost iOS نسخه 9.8.0.0
  • ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.