네이티브 스타일

플랫폼 선택: Android iOS Flutter

네이티브 스타일 설정을 사용하면 Google Ad Manager에서 제품 내에 지정한 네이티브 스타일을 기반으로 네이티브 광고의 렌더링을 처리할 수 있습니다. 먼저 크기 및 타겟팅을 지정합니다. 그런 다음 HTML, CSS, JavaScript를 추가하여 반응형 광고를 정의하고 모든 화면에서 고화질로 표시되는 광고를 생성합니다. 렌더링을 직접 할 필요가 없습니다. Ad Manager에서 도착 페이지에 맞는 네이티브 스타일을 자동으로 적용합니다. 네이티브 스타일은 AdManagerAdView를 사용하여 배너 광고와 마찬가지로 구현됩니다. 사전에 결정된 고정 광고 크기 또는 런타임에 결정된 유동 광고 크기와 함께 사용할 수 있습니다.

기본 요건

  • Google 모바일 광고 Flutter 플러그인 버전 0.13.6 이상

이 가이드는 Google 모바일 광고 SDK에 대한 실무적인 이해가 있다는 것을 전제로 설명을 제공합니다. 시작 가이드를 진행하지 않은 경우 시작 가이드부터 진행하시기 바랍니다.

고정 크기

고정 크기의 네이티브 스타일을 사용하면 네이티브 광고의 너비와 높이를 설정할 수 있습니다. 고정 크기를 설정하려면 다음 단계를 따르세요.

  1. Ad Manager UI에서 광고 항목을 만들고 Size 필드 드롭다운에서 사전 정의된 크기 중 하나를 선택합니다.

  2. 1단계에서 설정한 것과 동일한 크기로 AdManagerBannerAd를 로드합니다. 광고를 인스턴스화하고 로드하는 방법은 배너 광고 문서를 참고하세요. 배너 크기 섹션에서 크기 목록과 해당 AdSize 상수를 확인할 수 있습니다.

다음은 MEDIUM_RECTANGLE(300x250) 광고 크기와 같은 고정 크기를 지정하는 방법의 예입니다.

AdManagerBannerAd ad = AdManagerBannerAd(
  adUnitId: '<your-ad-unit>',
  sizes: <AdSize>[AdSize.mediumRectangle],
  request: AdManagerAdRequest(),
);

유동 크기

경우에 따라 고정 크기가 적합하지 않을 수 있습니다. 예를 들어 광고의 너비는 앱의 콘텐츠와 일치해야 하지만 높이는 광고의 콘텐츠에 맞게 동적으로 조정해야 할 수 있습니다. 이 경우를 처리하려면 Ad Manager UI에서 광고 크기를 Fluid로 지정하면 됩니다. 이렇게 하면 앱에서 런타임에 광고 크기를 지정합니다. SDK는 이 경우를 처리하기 위해 특수 AdSize 상수인 FLUID를 제공합니다. 유동 광고 크기 높이는 게시자가 정의한 너비를 기반으로 하여 동적으로 결정되므로 플랫폼 광고 뷰가 광고 소재의 높이에 맞게 높이를 조정할 수 있습니다.

유동 요청

FluidAdManagerBannerAd를 사용하여 유동 광고를 요청합니다.

final fluidAd = FluidAdManagerBannerAd(
  adUnitId: '<your-ad-unit>',
  request: AdManagerAdRequest(),
  listener: AdManagerBannerAdListener(
    onAdLoaded: (Ad ad) {
      print('$_fluidAd loaded.');
    },
    onAdFailedToLoad: (Ad ad, LoadAdError error) {
      print('$_fluidAd failedToLoad: $error');
      ad.dispose();
    },
  ),

유동 광고 표시

광고가 로드된 후 FluidAdWidget을 사용하여 유동 광고를 표시합니다. 기본 플랫폼 광고 뷰와 일치하도록 높이를 조정합니다.

FluidAdWidget(
  width: <your-width>,
  ad: fluidAd,
);

GitHub의 예에 해당하는 앱에서 Ad Manager 유동 광고 크기의 구현 예를 확인하세요.