پادرمیانی

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

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

پیش‌نیازها

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

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

مقداردهی اولیه SDK تبلیغات موبایلی گوگل

راهنمای شروع سریع به شما نشان می‌دهد که چگونه SDK تبلیغات موبایلی گوگل را راه‌اندازی کنید . در طول فراخوانی راه‌اندازی، آداپتورهای میانجی نیز راه‌اندازی می‌شوند. مهم است که قبل از بارگذاری تبلیغات، منتظر بمانید تا راه‌اندازی اولیه کامل شود تا مشارکت کامل از هر شبکه تبلیغاتی در اولین درخواست تبلیغ تأیید شود.

کد نمونه زیر نشان می‌دهد که چگونه می‌توانید وضعیت راه‌اندازی اولیه هر آداپتور را قبل از ارسال درخواست تبلیغ بررسی کنید.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

تنظیمات gradle خود را به‌روزرسانی کنید (فقط اندروید)

خطوط زیر را به فایل 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")

اضافه کردن وابستگی‌ها برای شبکه‌های همکار

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

از تبلیغات بومی با واسطه استفاده کنید

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

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

قوانین حفظ حریم خصوصی ایالت‌های آمریکا و GDPR

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

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

بعدی
شبکه ها را انتخاب کنید