네이티브 광고 옵션

GADAdLoader를 생성할 때 마지막으로 포함되는 매개변수는 선택사항인 객체의 배열입니다. 이 섹션에서는 이들 선택사항에 대해 설명합니다.

Swift

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ ... ad type constants ... ]
               options:@[ ... ad loader options objects ... ]];

GADNativeAdImageAdLoaderOptions

GADNativeAdImageAdLoaderOptions에는 네이티브 광고 고급형의 이미지와 관련된 속성이 포함되어 있습니다. 앱에서 GADAdLoader 객체 생성, 객체 속성(GADNativeAdImageAdLoaderOptions, disableImageLoading, preferredImageOrientation) 설정, 초기화 중 객체 전달을 통해 shouldRequestMultipleImages가 네이티브 광고 고급형 이미지 애셋을 처리하는 방법을 관리할 수 있습니다.

GADNativeAdImageAdLoaderOptions에는 다음과 같은 속성이 있습니다.

disableImageLoading
네이티브 광고의 이미지 애셋은 GADNativeAdImageimage 속성이 포함된 imageURL의 인스턴스를 통해 반환됩니다. disableImageLoading을 기본값인 false로 설정하면(Objective-C에서는 NO) SDK가 이미지 애셋을 자동으로 가져와서 imageimageURL 속성에 적용합니다. true로 설정되면(Objective-C에서는 YES) SDK가 imageURL만 채우며, 사용자의 선택에 따라 실제 이미지를 다운로드할 수 있습니다. 수동으로 이미지를 다운로드할 때 GADMediaContentmainImage 속성을 사용하여 미디어 보기의 이미지를 설정하세요.
preferredImageOrientation

일부 광고 소재는 다양한 기기 방향에 맞게 여러 이미지를 사용할 수 있습니다. 앱은 이 속성을 방향 상수 중 하나로 설정하여 특정 방향의 이미지를 요청할 수 있습니다.

  • GADNativeAdImageAdLoaderOptionsOrientationAny
  • GADNativeAdImageAdLoaderOptionsOrientationLandscape
  • GADNativeAdImageAdLoaderOptionsOrientationPortrait

    preferredImageOrientation을 사용하여 가로 또는 세로 이미지 방향에 대한 선호를 지정하면, SDK가 해당 방향과 일치하는 이미지부터 이미지 애셋 배열에 배치하고 나머지는 그 뒤에 배치합니다. 한 가지 방향으로만 제공되는 광고도 있으므로 게시자는 앱이 가로 이미지와 세로 이미지를 모두 처리할 수 있는지 확인해야 합니다.

    이 메소드를 호출하지 않으면 기본값인 GADNativeAdImageAdLoaderOptionsOrientationAny가 사용됩니다.

shouldRequestMultipleImages

일부 이미지 애셋에는 단일 이미지가 아닌 이미지의 집합이 포함됩니다. 이 값을 true로 설정하면 둘 이상의 이미지가 포함된 애셋에 대해 앱에서 모든 이미지를 표시할 준비가 되었다는 뜻입니다. false(기본값)로 설정하면 앱에서 이미지의 집합을 포함하는 애셋의 첫 번째 이미지만 제공하도록 SDK에 지시합니다.

GADAdLoader를 초기화할 때 GADAdLoaderOptions 객체를 전달하지 않으면 각 옵션의 기본값이 사용됩니다.

GADNativeAdViewAdOptions

GADNativeAdViewAdOptions 객체는 네이티브 광고 보기에서 광고가 표시되는 방식에 대한 환경설정을 나타내는 데 사용됩니다. 속성은 preferredAdChoicesPosition 하나이며, 이를 이용해 AdChoices 아이콘이 표시되는 위치를 지정할 수 있습니다. 광고의 모든 모서리에 이 아이콘을 표시할 수 있으며, 기본값은 GADAdChoicesPositionTopRightCorner입니다. 이 속성에서 사용할 수 있는 값은 다음과 같습니다.

  • GADAdChoicesPositionTopRightCorner
  • GADAdChoicesPositionTopLeftCorner
  • GADAdChoicesPositionBottomRightCorner
  • GADAdChoicesPositionBottomLeftCorner

다음은 광고 왼쪽 상단에 AdChoices 아이콘을 표시하는 방법의 예입니다.

Swift

let adViewOptions = GADNativeAdViewAdOptions()
adViewOptions.preferredAdChoicesPosition = .topLeftCorner
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

GADNativeAdViewAdOptions *adViewOptions = [[GADNativeAdViewAdOptions alloc] init];
adViewOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

GADVideoOptions

GADVideoOptions 객체는 네이티브 동영상 애셋을 표시하는 방법을 나타내는 데 사용됩니다. 여기에서 제공되는 속성은 startMuted 하나입니다.

이 부울은 동영상 애셋이 재생을 시작할 때 음소거 상태여야 하는지를 나타냅니다. 기본값은 true입니다.

GADMultipleAdsAdLoaderOptions

GADMultipleAdsAdLoaderOptions 객체를 사용하면 요청 한 번으로 여러 광고를 로드하도록 광고 로더에 지시할 수 있습니다. 이 방법으로 로드된 광고는 고유성이 확인된 광고입니다. GADMultipleAdsAdLoaderOptions에는 광고 로더가 요청에 대해 반환을 시도해야 하는 광고의 개수를 나타내는 numberOfAds라는 속성 1개가 있습니다. 이 속성의 기본값은 1이며 최댓값은 5입니다(앱에서 더 많은 광고를 요청하는 경우에도 5개까지만 반환됨). 반환된 광고의 실제 개수는 정해져 있지 않지만 0~numberOfAds개입니다.

GADNativeAdMediaAdLoaderOptions

이 기능을 사용하려면 GADAdLoader 초기화의 네이티브 광고 옵션 배열에 GADNativeAdMediaAdLoaderOptions 클래스를 포함합니다.

GADNativeAdMediaAdLoaderOptions 객체를 사용하면 미디어 가로 세로 비율 환경설정을 선택할 수 있습니다. 이 옵션은 이미지와 동영상 모두에 적용됩니다. 이 클래스에는 지원되는 미디어 가로 세로 비율을 지정하는 데 사용할 수 있는 mediaAspectRatio 속성이 있습니다. 이 속성에서 사용할 수 있는 값은 다음과 같습니다.

Objective-CSwift
GADMediaAspectRatioAny .any
GADMediaAspectRatioLandscape .landscape
GADMediaAspectRatioPortrait .portrait
GADMediaAspectRatioSquare .square

mediaAspectRatio를 이러한 옵션 중 하나로 설정하면 지정된 가로 세로 비율의 미디어가 있는 광고만 반환됩니다. 이 속성을 명시적으로 설정하지 않으면 기본값이 GADMediaAspectRatioUnknown으로 설정되며, 가로 세로 비율에 대한 제한은 적용되지 않습니다.