این راهنما به شما نشان می دهد که چگونه یک آداپتور میانجی را با برنامه Flutter خود ادغام کنید.
قبل از اینکه بتوانید میانجیگری را برای یک قالب تبلیغ یکپارچه کنید، باید آن قالب تبلیغ را در برنامه خود ادغام کنید:
تازه در میانجیگری؟ مقدمه ای بر میانجی گری را بخوانید.
راهنمای شروع سریع به شما نشان می دهد که چگونه SDK تبلیغات موبایلی را مقداردهی اولیه کنید . در طول آن فراخوانی اولیه، آداپتورهای میانجیگری و مناقصه نیز مقداردهی اولیه می شوند. برای اطمینان از مشارکت کامل هر شبکه تبلیغاتی در اولین درخواست تبلیغ، مهم است که منتظر بمانید تا مقداردهی اولیه قبل از بارگیری تبلیغات کامل شود.
کد نمونه زیر نشان می دهد که چگونه می توانید وضعیت اولیه سازی هر آداپتور را قبل از درخواست تبلیغ بررسی کنید.
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize()
.then((initializationStatus) {
initializationStatus.adapterStatuses.forEach((key, value) {
debugPrint('Adapter status for $key: ${value.description}');
});
});
runApp(MyApp());
}
خطوط زیر را به فایل settings.gradle
خود اضافه کنید تا بتوانید از APIهای Android افزونه استفاده کنید:
def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
pluginsFile.withInputStream { stream -> plugins.load(stream) }
}
plugins.each { name, path ->
def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
include ":$name"
project(":$name").projectDir = pluginDirectory
}
آداپتورهای میانجی و وابستگیهای آنها باید به پروژههای Android و iOS شما اضافه شوند. آنها را می توان با به روز رسانی فایل build.gradle
سطح برنامه خود در Android و Podfile
در iOS اضافه کرد. گوگل آداپتورهای منبع باز در GitHub برای اندروید و 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 غیرفعال کنید. این کار از یک بهروزرسانی مضاعف جلوگیری میکند، زیرا Ad Manager نیز بر اساس نرخ تازهسازی واحد تبلیغات بنر شما، بهروزرسانی را راهاندازی میکند.
در زیر برخی از بهترین شیوه هایی که باید در هنگام اجرای میانجیگری بومی در نظر گرفته شوند آورده شده است.
- خط مشی ارائه تبلیغات بومی
- هر شبکه تبلیغاتی سیاست های خاص خود را دارد. هنگام استفاده از میانجیگری، مهم است که به یاد داشته باشید که برنامه شما همچنان باید از خطمشیهای شبکه واسطهای که آگهی را ارائه کرده است، تبعیت کند.
اگر نیاز به پیروی از قوانین حریم خصوصی ایالت های ایالات متحده یا مقررات عمومی حفاظت از داده (GDPR) دارید، مراحل موجود در تنظیمات مقررات ایالتی یا تنظیمات GDPR را دنبال کنید تا شرکای میانجی خود را در ایالت های ایالات متحده Ad Manager Privacy & Messaging یا لیست شرکای تبلیغاتی GDPR اضافه کنید. عدم انجام این کار می تواند منجر به شکست شرکا در ارائه تبلیغات در برنامه شما شود.
درباره فعال کردن پردازش محدود داده (RDP) و کسب رضایت GDPR با پلت فرم پیامرسانی کاربر Google (UMP) SDK بیشتر بیاموزید.