میانجیگری را تنظیم کنید

پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر ، اندروید (قدیمی)

این راهنما به شما نشان می‌دهد که چگونه یک آداپتور میانجی را با برنامه Flutter خود ادغام کنید.

پیش‌نیازها

قبل از اینکه بتوانید میانجیگری را برای یک قالب تبلیغاتی ادغام کنید، باید آن قالب تبلیغاتی را در برنامه خود ادغام کنید:

آیا در زمینه میانجیگری تازه‌کار هستید؟ مقدمه‌ای بر میانجیگری را بخوانید.

Initialize 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());
}

Update your gradle settings (Android only)

خطوط زیر را به فایل settings.gradle خود اضافه کنید تا بتوانید از APIهای اندروید افزونه استفاده کنید:

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")

Add dependencies for partner networks

آداپتورهای میانجی و وابستگی‌های آنها باید به پروژه‌های اندروید و iOS شما اضافه شوند. آنها را می‌توان با به‌روزرسانی فایل build.gradle سطح برنامه در اندروید و Podfile در iOS اضافه کرد. گوگل آداپتورهای متن‌باز را برای اندروید و iOS در GitHub دارد.

برای راهنمایی دقیق در مورد نحوه اضافه کردن آداپتور هر شبکه شریک به برنامه خود، به مستندات 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 نیز بر اساس نرخ رفرش واحد تبلیغاتی بنر شما، رفرش را فعال می‌کند.

Use native ads with mediation

موارد زیر برخی از بهترین شیوه‌هایی هستند که باید هنگام اجرای میانجیگری بومی در نظر گرفته شوند.

Native ad presentation policy
هر شبکه تبلیغاتی سیاست‌های خاص خود را دارد. هنگام استفاده از واسطه‌گری، مهم است به یاد داشته باشید که برنامه شما همچنان باید از سیاست‌های شبکه واسطه‌ای که تبلیغ را ارائه داده است، پیروی کند.

US states privacy laws and GDPR

اگر لازم است از قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده یا مقررات عمومی حفاظت از داده‌ها (GDPR) پیروی کنید، مراحل موجود در تنظیمات مقررات ایالت‌های ایالات متحده یا تنظیمات GDPR را دنبال کنید تا شرکای میانجی خود را در فهرست شرکای تبلیغاتی ایالت‌های ایالات متحده یا GDPR در Ad Manager Privacy & messaging اضافه کنید. عدم انجام این کار می‌تواند منجر به عدم نمایش تبلیغات توسط شرکا در برنامه شما شود.

درباره فعال کردن پردازش داده‌های محدود (RDP) و دریافت رضایت GDPR با SDK پلتفرم پیام‌رسانی کاربر گوگل (UMP) بیشتر بدانید.

بعدی
منابع تبلیغاتی را انتخاب کنید، منابع تبلیغاتی را انتخاب کنید