این راهنما به شما نشان می‌دهد که چگونه یک آداپتور میانجی را با برنامه 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) و کسب رضایت با مقررات کلی حفاظت از داده با کیت توسعه نرم‌افزار پلاتفرم پیام‌رسانی کاربر Google (UMP) بیشتر بدانید.