این راهنما نحوه ادغام کردن یک آداپتور واسطه‌گری با برنامه Flutter شما را نشان می‌دهد.
پیش‌نیازها
قبل‌از اینکه بتوانید میانجی‌گری را برای قالب آگهی ادغام کنید، باید آن قالب آگهی را در برنامه‌تان ادغام کنید:
در میانجی‌گری تازه‌کار هستید؟ مقدمه‌ای بر میانجی‌گری را بخوانید.
مقداردهی اولیه Google Mobile Ads Flutter Plugin
راهنمای شروع سریع به شما نشان می‌دهد که چگونه Google Mobile Ads Flutter Plugin را مقداردهی اولیه کنید. درطول آن فراخوانی مقداردهی اولیه، آداپتورهای میانجی نیز مقداردهی اولیه می‌شوند. مهم است که قبل‌از بار کردن آگهی‌ها منتظر بمانید تا مقداردهی اولیه تکمیل شود تا بتوانید مشارکت کامل هر شبکه آگهی را در اولین درخواست آگهی تأیید کنید.
کد نمونه زیر نشان می‌دهد که چگونه می‌توانید وضعیت مقداردهی اولیه هر آداپتور را قبل‌از درخواست آگهی بررسی کنید.
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize()
.then((initializationStatus) {
initializationStatus.adapterStatuses.forEach((key, value) {
debugPrint('Adapter status for $key: ${value.description}');
});
});
runApp(MyApp());
}
تنظیمات gradle را به‌روز کنید (فقط Android)
خطوط زیر را به فایل settings.gradle اضافه کنید تا بتوانید از
میاناهای برنامه‌سازی کاربردی Android افزونه استفاده کنید:
def flutterSdkPath = {
def properties = new Properties()
file("local.properties").withInputStream { properties.load(it) }
def flutterSdkPath = properties.getProperty("flutter.sdk")
assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
return flutterSdkPath
}()
includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")
افزودن وابستگی برای شبکه‌های شریک
واسطه‌های میانجی‌گری و وابستگی‌های آن‌ها باید به پروژه‌های Android و iOS شما اضافه شوند. این موارد را می‌توان با به‌روزرسانی فایل سطح برنامه build.gradle
در Android و Podfile در iOS اضافه کرد. Google در GitHub
برای هر دو
Android
و
iOS
مبدل‌های متن‌باز دارد.
برای راهنمایی دقیق درباره نحوه افزودن آداپتور هر شبکه شریک در برنامه‌تان، به اسناد Android و iOS مراجعه کنید.
بررسی کنید کدام کلاس آداپتور شبکه آگهی آگهی را بار کرده است
کد نمونه زیر نشان می‌دهد چگونه نام کلاس شبکه آگهی را برای آگهی برنمایی ثبت کنید:
final bannerAd = AdManagerBannerAd(
size: [AdSize.banner],
adUnitId: '<your-ad-unit>',
listener: AdManagerBannerAdListener(
onAdLoaded: (ad) {
debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
},
),
request: AdManagerAdRequest(),
);
استفاده از آگهی‌های برنمایی با میانجی‌گری
مطمئن شوید که بازآوری را در همه واسط‌های کاربر منبع آگهی شخص ثالث برای واحدهای آگهی برنمایی که در میانجی‌گری استفاده می‌شوند غیرفعال کنید. این کار از بازآوری مضاعف جلوگیری می‌کند زیرا Ad Manager نیز براساس نرخ بازآوری واحد آگهی برنمایی شما، بازآوری را راه‌اندازی می‌کند.
استفاده از آگهی‌های بومی با میانجی‌گری
در زیر برخی‌از روال‌های مطلوب برای درنظر گرفتن هنگام پیاده‌سازی میانجی‌گری بومی آورده شده است.
- خط‌مشی ارائه آگهی بومی
- هر شبکه تبلیغاتی خط‌مشی‌های خاص خود را دارد. هنگام استفاده از میانجی‌گری، مهم است که به‌یاد داشته باشید برنامه شما همچنان باید از خط‌مشی‌های شبکه میانجی‌گری‌شده‌ای که آگهی را ارائه کرده است پیروی کند.
قوانین حریم خصوصی ایالتی در ایالات متحده و «مقررات عمومی حفاظت از داده‌ها»
اگر لازم است از قوانین حریم خصوصی ایالت‌های امریکا یا مقررات کلی حفاظت از داده‌ها (GDPR) تبعیت کنید، مراحل موجود در تنظیمات مقررات ایالتی امریکا یا تنظیمات GDPR را دنبال کنید تا شرکای میانجی‌گری‌تان را به فهرست شرکای آگهی GDPR یا ایالت‌های امریکا در «حریم خصوصی و پیام‌رسانی» Ad Manager اضافه کنید. عدم انجام این کار می‌تواند منجر به عدم ارائه آگهی توسط شرکا در برنامه شما شود.
درباره فعال کردن پردازش داده‌های محدودشده (RDP) و دریافت موافقت GDPR با کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر Google (UMP) بیشتر بدانید.