네이티브 광고 옵션

광고 요청 타임아웃 (기본값 60초)

광고요청 이후 지정한 시간(초)경과 까지 광고 응답을 얻지 못하면 기존 요청이 무효화되며, GFPAdLoaderDelegate의 adLoader:didFailWithError:responseInfo: 메소드가 호출됩니다.

Swift

self.adLoader?.requestTimeoutInterval = ...

Objective-C

self.adLoader.requestTimeoutInterval = ...

GFPNativeAdRenderingSetting

정보

이 섹션에서는 자주 사용되는 주요 옵션만 다룹니다. GFPNativeAdRenderingSetting이 제공하는 모든 옵션의 전체 목록은 네이티브 렌더링 옵션을 참고해 주세요.

DFP adChoicesView 위치 설정 옵션

DFP의 adChoiceView는 오버레이 형식으로 렌더링 됩니다. 따라서, adChoicesView가 자동으로 삽입될 네 귀퉁이중 한군데를 비워놓아야 합니다. DFP의 adChoicesView의 기본 위치는 오른쪽 상단 코너이며,
GFPNativeAdRenderingSetting의 preferredAdChoicesViewPosition 을 통해 설정 가능합니다.

Swift

let renderingSetting = GFPNativeAdRenderingSetting()
renderingSetting.preferredAdChoicesViewPosition = .topRightCorner

let nativeOption = GFPAdNativeOptions()
nativeOption.renderingSetting = renderingSetting

Objective-C

GFPNativeAdRenderingSetting *setting = [[GFPNativeAdRenderingSetting alloc] init];
setting.preferredAdChoicesViewPosition = GFPAdChoicesViewPositionTopRightCorner;

GFPAdNativeOptions *nativeOptions = [[GFPAdNativeOptions alloc] init];
nativeOptions.renderingSetting = setting;

정보

구글 문서에는 adChoiceView를 직접 등록하면 오버레이형식이 아닌 직접 등록한 뷰에 그려진다고 되어있으나, 아직까지 정상 동작 하지 않으므로 우상단이 아닌 위치에 adChoiceView가 렌더링 되기를 원하시는 경우 이 세팅이 필요합니다.

미디어뷰가 없는 네이티브 광고 사용시

미디어뷰가 없는 네이티브 광고(예를들어 아이콘과 타이틀 클릭 버튼만으로 구성된 네이티브 광고)를 사용하려면, GFPNativeAdRenderingSetting 의 hasMediaView = NO를 설정해야 합니다. (기본값은 YES)

위험

네이티브 뷰에 미디어 뷰 존재여부와 GFPNativeAdRenderingSetting.hasMediaView 상태가 다르면, 네이티브 광고 렌더링 시점에 오류가 발생합니다.

Swift

let setting = GFPNativeAdRenderingSetting()
setting.hasMediaView = false

let nativeOption = GFPAdNativeOptions()
nativeOption.renderingSetting = setting

Objective-C

GFPNativeAdRenderingSetting *setting = [[GFPNativeAdRenderingSetting alloc] init];
setting.hasMediaView = NO;

GFPAdNativeOptions *nativeOptions = [[GFPAdNativeOptions alloc] init];
nativeOptions.renderingSetting = setting;

네이티브 광고 Lazy Loading

Lazy Loading 활성화

네이티브 렌더링 옵션에서 lazy loading 을 활성화 시키면 네이티브 광고 뷰 객체와 텍스트 에셋이 먼저 GFPAdLoaderDelegate.adLoader(_ unifiedAdLoader: GFPAdLoader!, didReceive nativeAd: GFPNativeAd!) 으로 주어지며, 미디어 뷰, 아이콘 뷰 등은 비동기로 로딩 됩니다.

Swift

self.adLoader = GFPAdLoader(unitID: "UnitId", rootViewController: self, adParam: adParam)
    
let nativeOption = GFPAdNativeOptions()
nativeOptions.renderingSetting.useLazyMediaLoading = true
self.adLoader?.setNativeDelegate(self, nativeOptions: nativeOption)

self.adLoader?.delegate = self
self.adLoader?.loadAd()

Objective-C

self.adLoader = [[GFPAdLoader alloc] initWithUnitID:self.unitID
                                 rootViewController:self
                                            adParam:adParam];
        
GFPAdNativeOptions *nativeOptions = [[GFPAdNativeOptions alloc] init];
nativeOptions.renderingSetting.useLazyMediaLoading = YES;
[self.adLoader setNativeDelegate:self nativeOptions:nativeOptions];

// 광고 요청
self.adLoader.delegate = self;
[self.adLoader loadAd];

플레이스홀더 표시

미디어가 비동기로 로딩 되는 동안 플레이스 홀더를 보여줄 수 있습니다. 플레이스홀더는 광고 뷰 위에 바로 나타나며, 뷰 요소에 크기가 맞도록 자동 조절됩니다.

Swift

func adLoader(_ unifiedAdLoader: GFPAdLoader!, didReceive nativeAd: GFPNativeAd!) {
    self.nativeAdView.nativeAd = nativeAd

    self.nativeAdView.mediaView?.showPlaceholder { imageView in
        imageView.image = UIImage(named: "my_media_placeholder")
        imageView.contentMode = .scaleAspectFill
        imageView.clipsToBounds = true
    }

    self.nativeAdView.showIconPlaceholder { imageView in
        imageView.image = UIImage(named: "my_icon_placeholder")
        imageView.contentMode = .scaleAspectFill
        imageView.clipsToBounds = true
    }

Objective-C

- (void)adLoader:(GFPAdLoader *)unifiedAdLoader didReceiveNativeAd:(GFPNativeAd *)nativeAd {
    self.nativeAdView.nativeAd = nativeAd

    [self.nativeAdView.mediaView showPlaceholderWith:^(UIImageView *imageView) {
        imageView.image = [UIImage imageNamed:@"my_media_placeholder"];
        imageView.contentMode = UIViewContentModeScaleAspectFill;
        imageView.clipsToBounds = YES;
    }];

    [self.nativeAdView showIconPlaceholderWith:^(UIImageView *imageView) {
        imageView.image = [UIImage imageNamed:@"my_icon_placeholder"];
        imageView.contentMode = UIViewContentModeScaleAspectFill;
        imageView.clipsToBounds = YES;
    }];
}

비동기 미디어 로딩 콜백

미디어 뷰, 아이콘 뷰 등 모든 미디어의 비동기 로딩이 완료되면 GFPNativeAdDelegate 의 nativeAdDidLoadMediaData(_:) 가 호출됩니다.

하나라도 로딩이 실패하는 경우 nativeAdDidFail(toLoadMediaData:) 가 호출됩니다.

Swift

// GFPNativeAdDelegate
func nativeAdDidLoadMediaData(_ nativeAd: GFPNativeAd) {
    self.nativeAdView.removePlaceholders() // Optional for safety.
}

func nativeAdDidFail(toLoadMediaData nativeAd: GFPNativeAd) {
    // Example showing new placeholders on failure.
    self.nativeAdView.mediaView?.showPlaceholder { imageView in
        imageView.image = UIImage(named: "my_fallback_media_placeholder")
        imageView.contentMode = .scaleAspectFill
        imageView.clipsToBounds = true
    }

    self.nativeAdView.showIconPlaceholder { imageView in
        imageView.image = UIImage(named: "my_fallback_icon_placeholder")
        imageView.contentMode = .scaleAspectFill
        imageView.clipsToBounds = true
    }
}

Objective-C

// GFPNativeAdDelegate
- (void)nativeAdDidLoadMediaData:(GFPNativeAd *)nativeAd {
    [self.nativeAdView removePlaceholders]; // Optional for safety.
}

- (void)nativeAdDidFailToLoadMediaData:(GFPNativeAd *)nativeAd {
    // Example showing new placeholders on failure.
    [self.nativeAdView.mediaView showPlaceholderWith:^(UIImageView *imageView) {
        imageView.image = [UIImage imageNamed:@"my_fallback_media_placeholder"];
        imageView.contentMode = UIViewContentModeScaleAspectFill;
        imageView.clipsToBounds = YES;
    }];

    [self.nativeAdView showIconPlaceholderWith:^(UIImageView *imageView) {
        imageView.image = [UIImage imageNamed:@"my_fallback_icon_placeholder"];
        imageView.contentMode = UIViewContentModeScaleAspectFill;
        imageView.clipsToBounds = YES;
    }];
}

GFPContentInfo

NativeNormal 타입 광고를 Communication Ad 으로 적용할 경우, ContentInfo 를 주입해야합니다.

Swift

let adParam = GFPAdParam()
adParam.contentInfo = GFPContentInfo(
        sourceType: “0001”,
        subtype: “menu”,
        sourceId: “30907206:7”)

Objective-C

GFPContentInfo *contentInfo = [[GFPContentInfo alloc] initWithSourceType:@"0001" subtype:@"menu" sourceId:@"30907206:7"];
adParam.contentInfo = contentInfo;