شروع به کار

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

پیش‌نیازها

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

• تبلیغات بنری
• تبلیغات بینابینی
• تبلیغات بومی
• تبلیغات جایزه‌دار
• تبلیغات بینابینی جایزه‌دار

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

برای پیشنهاد قیمت: Google Mobile Ads SDK 7.53.1 یا بالاتر.

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

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

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

MobileAds.shared.start { initializationStatus in
  // Check each adapter's initialization status.
  for (adapterName, status) in initializationStatus.adapterStatusesByClassName {
    print(
      "Adapter: \(adapterName), Description: \(status.description), Latency: \(status.latency)")
  }
}
MediationSnippets.swift

[[GADMobileAds sharedInstance]
    startWithCompletionHandler:^(GADInitializationStatus *_Nonnull status) {
      // Check each adapter's initialization status.
      NSDictionary<NSString *, GADAdapterStatus *> *adapterStatuses =
          status.adapterStatusesByClassName;
      for (NSString *adapterName in adapterStatuses) {
        GADAdapterStatus *adapterStatus = adapterStatuses[adapterName];
        NSLog(@"Adapter: %@, Description: %@, Latency: %f", adapterName,
              adapterStatus.description, adapterStatus.latency);
      }
    }];
MediationSnippets.m

بدانید کدام شبکه تبلیغاتی برنده است

هر کلاس فرمت تبلیغ دارای یک ویژگی GADResponseInfo است که شامل adNetworkClassName است که نام کلاس شبکه تبلیغ را برای تبلیغ فعلی برمی‌گرداند. adNetworkClassName فقط زمانی که تبلیغ با موفقیت بارگذاری شود، مقداری دارد. کد زیر نحوه دریافت این اطلاعات را برای تبلیغات بنری نشان می‌دهد.

print(
  "Adapter class name: \(ad.responseInfo?.loadedAdNetworkResponseInfo?.adNetworkClassName ?? "Unknown")"
)
ResponseInfoSnippets.swift

NSLog(@"Adapter class name: %@",
      ad.responseInfo.loadedAdNetworkResponseInfo.adNetworkClassName ?: @"Unknown");
ResponseInfoSnippets.m

برای جزئیات بیشتر به بازیابی اطلاعات مربوط به پاسخ تبلیغ مراجعه کنید.

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

مطمئن شوید که قابلیت رفرش را در تمام رابط‌های کاربری منبع تبلیغات شخص ثالث برای واحدهای تبلیغاتی بنری مورد استفاده در میانجیگری غیرفعال کرده‌اید. این کار از رفرش مضاعف جلوگیری می‌کند، زیرا Ad Manager نیز بر اساس نرخ رفرش واحد تبلیغاتی بنر شما، رفرش را فعال می‌کند.

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

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

سیاست ارائه تبلیغات بومی

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

هنگام ارسال درخواست‌ها از استفاده از کلاس GADMultipleAdsAdLoaderOptions خودداری کنید.

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

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

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

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