تبلیغات بومی

تبلیغات بومی دارایی‌های تبلیغاتی هستند که از طریق مؤلفه‌های رابط کاربری بومی پلتفرم به کاربران ارائه می‌شوند. آنها با استفاده از همان کلاس‌هایی که قبلاً در استوری‌بردهای خود استفاده می‌کردید نشان داده می‌شوند و می‌توانند برای مطابقت با طراحی بصری برنامه شما قالب‌بندی شوند.

وقتی یک تبلیغ بومی بارگیری می‌شود، برنامه شما یک شی تبلیغاتی دریافت می‌کند که حاوی دارایی‌های آن است و برنامه - به جای Google Mobile Ads SDK - مسئول نمایش آنهاست.

به طور کلی، دو بخش برای اجرای موفقیت آمیز تبلیغات بومی وجود دارد: بارگیری یک تبلیغ با استفاده از SDK و سپس نمایش محتوای تبلیغات در برنامه شما.

این صفحه نحوه استفاده از SDK برای بارگیری تبلیغات بومی را نشان می دهد.

پیش نیازها

• راهنمای شروع را کامل کنید.

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

هنگام ساخت و آزمایش برنامه های خود، مطمئن شوید که از تبلیغات آزمایشی به جای تبلیغات زنده و تولیدی استفاده می کنید.

ساده ترین راه برای بارگیری تبلیغات آزمایشی استفاده از شناسه واحد آگهی آزمایشی اختصاصی ما برای تبلیغات بومی در iOS است:

/21775744923/example/native

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

برای اطلاعات بیشتر در مورد نحوه عملکرد تبلیغات آزمایشی SDK تبلیغات موبایلی Google، به آگهی‌های آزمایشی مراجعه کنید.

بارگذاری تبلیغات

تبلیغات بومی با کلاس GADAdLoader بارگذاری می شوند که طبق پروتکل GADAdLoaderDelegate برای نمایندگان خود پیام ارسال می کنند.

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

بارگذاری آگهی را راه اندازی کنید

قبل از اینکه بتوانید یک تبلیغ را بارگیری کنید، باید بارگذاری آگهی را مقداردهی اولیه کنید. کد زیر نحوه راه اندازی اولیه GADAdLoader را نشان می دهد:

سویفت

adLoader = GADAdLoader(adUnitID: "/21775744923/example/native",
    // The UIViewController parameter is optional.
    rootViewController: rootViewController,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

هدف-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"/21775744923/example/native"
    // The UIViewController parameter is nullable.
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;

شما به یک شناسه واحد تبلیغات (می‌توانید از شناسه آزمایشی استفاده کنید)، ثابت‌هایی برای ارسال در آرایه adTypes برای تعیین قالب‌های بومی که می‌خواهید درخواست کنید، و هر گزینه‌ای که می‌خواهید در پارامتر options تنظیم کنید، نیاز دارید. لیست مقادیر ممکن برای پارامتر options را می توان در صفحه تنظیمات گزینه های تبلیغات بومی یافت.

آرایه adTypes باید شامل یک یا چند مورد از ثابت های زیر باشد:

• GADAdLoaderAdTypeNative

• GADAdLoaderAdTypeCustomNative

نماینده لودر تبلیغات را پیاده سازی کنید

نماینده لودر تبلیغات باید پروتکل‌های مخصوص نوع تبلیغ شما را پیاده‌سازی کند. برای تبلیغات بومی، پروتکل GADNativeAdLoaderDelegate شامل پیامی است که هنگام بارگیری آگهی بومی برای نماینده ارسال می‌شود.

سویفت

public func adLoader(_ adLoader: GADAdLoader,
            didReceive nativeAd: GADNativeAd)

هدف-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd;

پروتکل GADCustomNativeAdLoaderDelegate شامل پیامی است که هنگام بارگیری یک تبلیغ الگوی سفارشی برای نماینده ارسال می شود.

سویفت

func adLoader(_ adLoader: GADAdLoader,
  Receive customNativeAd: GADCustomNativeAd)

هدف-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveCustomNativeAd:(GADCustomNativeAd *) customNativeAd;

درخواست تبلیغات

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

هنگامی که GADAdLoader شما مقداردهی اولیه شد، متد loadRequest: آن را برای درخواست تبلیغ فراخوانی کنید:

سویفت

adLoader.load(GAMRequest())

هدف-C

[self.adLoader loadRequest:[GAMRequest request]];

متد loadRequest: در GADAdLoader همان اشیاء GAMRequest را به عنوان بنرها و بینابینی ها می پذیرد. شما می توانید از اشیاء درخواست برای افزودن اطلاعات هدف استفاده کنید، درست مانند سایر انواع تبلیغات.

توجه: Ad Manager از بارگیری چند آگهی با GADMultipleAdsAdLoaderOptions پشتیبانی نمی‌کند و در صورت استفاده، فقط یک آگهی را برمی‌گرداند.

تعیین زمان پایان بارگیری

پس از اینکه یک برنامه با loadRequest: می‌تواند نتایج درخواست را با استفاده از تماس‌هایی به:

• adLoader:didFailToReceiveAdWithError: در GADAdLoaderDelegate
• adLoader:didReceiveNativeAd: در GADNativeAdLoaderDelegate

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

رسیدگی به درخواست های ناموفق

پروتکل های بالا پروتکل GADAdLoaderDelegate را گسترش می دهند، که پیامی را تعریف می کند که زمانی که تبلیغات بارگیری نمی شود ارسال می شود.

سویفت

public func adLoader(_ adLoader: GADAdLoader,
    didFailToReceiveAdWithError error: NSError)

هدف-C

- (void)adLoader:(GADAdLoader *)adLoader
    didFailToReceiveAdWithError:(NSError *)error;

اخطار: تلاش برای بارگیری آگهی جدید از adLoader:didFailToReceiveAdWithError: به شدت ممنوع است. اگر باید تبلیغی را از adLoader:didFailToReceiveAdWithError: بارگیری کنید، تلاش‌های بارگذاری مجدد آگهی را محدود کنید تا از درخواست‌های تبلیغاتی ناموفق مداوم در شرایطی مانند اتصال شبکه محدود جلوگیری کنید.

از رویدادهای تبلیغاتی بومی مطلع شوید

برای اطلاع از رویدادهای مربوط به تعاملات تبلیغاتی بومی، ویژگی نمایندگی تبلیغ بومی را تنظیم کنید:

سویفت

nativeAd.delegate = self

هدف-C

nativeAd.delegate = self;

سپس GADNativeAdDelegate برای دریافت تماس های نماینده زیر پیاده سازی کنید:

سویفت

func nativeAdDidRecordImpression(_ nativeAd: GADNativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: GADNativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: GADNativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: GADNativeAd) {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

هدف-C

- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
  // The native ad was shown.
}

- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  // The native ad was clicked on.
}

- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
  // The native ad will present a full screen view.
}

- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad will dismiss a full screen view.
}

- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad did dismiss a full screen view.
}

- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

بهترین شیوه ها

هنگام بارگذاری تبلیغات از این قوانین پیروی کنید.

• برنامه‌هایی که از تبلیغات بومی در فهرست استفاده می‌کنند، باید فهرست تبلیغات را از قبل ذخیره کنند.

• هنگام پیش کش کردن تبلیغات، حافظه پنهان خود را پاک کنید و پس از یک ساعت دوباره بارگیری کنید.

• loadRequest: که توسط GADAdLoader adLoaderDidFinishLoading:

• حافظه پنهان تبلیغات بومی را فقط به موارد مورد نیاز محدود کنید. به عنوان مثال هنگام پیش کش کردن، فقط تبلیغاتی را ذخیره کنید که بلافاصله روی صفحه قابل مشاهده هستند. تبلیغات بومی دارای حافظه زیادی هستند و ذخیره تبلیغات بومی بدون از بین بردن آنها منجر به استفاده بیش از حد از حافظه می شود.

• تبلیغات بومی را زمانی که دیگر استفاده نمی کنید از بین ببرید.

تبلیغ خود را نمایش دهید

هنگامی که یک تبلیغ را بارگذاری کردید، تنها چیزی که باقی می ماند نمایش آن برای کاربران است. برای مشاهده نحوه انجام، به راهنمای پیشرفته بومی ما مراجعه کنید.