原生廣告提供許多進階功能 量身打造最適合的廣告體驗本指南說明 如何使用原生廣告的進階功能
必要條件
- 整合原生廣告格式。
資產控制選項
偏好的媒體顯示比例控制項
媒體顯示比例控制項可讓您指定廣告素材的顯示比例偏好設定。
設定「GADNativeAdMediaAdLoaderOptions mediaAspectRatio」
使用 GADMediaAspectRatio。
如未設定，傳回的廣告可以採用任何媒體顯示比例。
設定後，您就能指定偏好的顯示比例類型，進而改善使用者體驗。
以下範例會指示 SDK 優先採用含有 挑選出適當的顯示比例
GADNativeAdMediaAdLoaderOptions *nativeOption = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOption.mediaAspectRatio = GADMediaAspectRatioAny;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
圖片下載控制項
映像檔下載控制項可讓您決定圖片素材資源是還是只有 URI SDK 傳回的 IP 位址
設定「GADNativeAdImageAdLoaderOptions disableImageLoading」
並指定 BOOL 值。
圖片下載控制項預設為停用。
停用後，Google Mobile Ads SDK 會為您填入圖片和 URI。
啟用後，SDK 只會填入 URI，讓您自行決定是否要下載實際圖片。
下列範例會指示 SDK 只傳回 URI。
GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.disableImageLoading = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
圖片酬載控制項
有些廣告會使用一系列圖片，而非單張圖片。使用這項功能可指出應用程式是否準備好顯示所有圖片，或是只顯示一張圖片。
使用BOOL 值設定 GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages。映像檔酬載控制項預設為停用。
停用後，應用程式會指示 SDK 只為包含系列叢書的任何素材資源提供第一張圖片。
啟用後，應用程式會表示已準備好顯示所有圖像，適用於任何擁有多個圖像的素材資源。
以下範例會指示 SDK 傳回多個圖片素材資源。
GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.shouldRequestMultipleImages = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
AdChoices 刊登位置
AdChoices 位置控制項
AdChoices 位置控制項可讓您選擇要顯示 AdChoices 圖示的角落。
設定「GADNativeAdViewAdOptions preferredAdChoicesPosition」
使用 GADAdChoicesPosition
值。
如果未設定，AdChoices 圖示位置會設為右上方。
如果已設定，AdChoices 會顯示在自訂位置，
以下範例說明如何設定自訂 AdChoices 圖片位置。
GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
AdChoices 自訂檢視畫面
AdChoices 自訂檢視功能可讓您將 AdChoices 圖示放置在 自訂位置。這與 AdChoices 位置控制項不同，後者只允許指定四個角落中的一個。
在算繪前，請使用 GADAdChoicesView 設定 GADNativeAd.adChoicesView 屬性，AdChoices 內容就會算繪至 GADAdChoicesView 中。
以下範例說明如何設定自訂 AdChoices 檢視畫面。AdChoices 圖示會在 GADAdChoicesView 中顯示。
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {
...
GADAdChoicesView *customAdChoicesView =
[[GADAdChoicesView alloc] initWithFrame: CGRectMake(..., ..., ..., ...)];
[nativeAdView addSubview:customAdChoicesView];
nativeAdView.adChoicesView = customAdChoicesView;
// Associate the native ad view with the native ad object. This is
// required to make the ad clickable.
// Note: this should always be done after populating the ad views.
nativeAdView.nativeAd = nativeAd;
}
Swift
func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
refreshAdButton.isEnabled = true
...
// Define a custom position for the AdChoices icon.
let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
let customAdChoicesView = GADAdChoicesView(frame: customRect)
nativeAdView.addSubview(customAdChoicesView)
nativeAdView.adChoicesView = customAdChoicesView
// Associate the native ad view with the native ad object. This is
// required to make the ad clickable.
// Note: this should always be done after populating the ad views.
nativeAdView.nativeAd = nativeAd;
}
影片控制選項
開始靜音行為
啟動靜音行為後，即可停用或啟用影片的起始音訊。
設定「GADVideoOptions startMuted」
並指定 BOOL 值。
啟動靜音行為預設為啟用。
如果停用這項設定，應用程式會要求播放影片 音訊。
啟用後，應用程式會要求影片一開始播放時，音訊應處於靜音狀態。
以下範例說明如何啟動影片，並讓音訊不靜音。
GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.startMuted = NO;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
自訂播放控制項
這樣您就能要求自訂影片輸入控制項來播放、暫停或靜音 影片。
使用BOOL 值設定 GADVideoOptions customControlsRequested。自訂播放控制項預設為停用，
停用後，影片就會顯示 SDK 轉譯的輸入控制項。
- 啟用後，您就可以使用
GADVideoController play、GADVideoController pause，以及GADVideoController setMute以控制影片廣告
- 如果廣告已啟用影片內容和自訂控制項，您應該
然後同時顯示自訂控制項與廣告，因為廣告不會實際放送
控制項本身接著，控制項可以呼叫
GADVideoController。
以下範例說明如何要求含有自訂播放控制項的影片。
GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.customControlsRequested = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
檢查是否已啟用自訂控制項
因為在請求時無法得知，傳回的廣告是否將 自訂影片控制項，您必須確認是否已啟用自訂控制項。
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader
didReceiveNativeAd:(GADNativeAd*)nativeAd {
GADVideoController *videoController = nativeAd.mediaContent.videoController;
BOOL canShowCustomControls = videoController.customControlsEnabled;
}
Swift
func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
let videoController = nativeAd.mediaContent.videoController
let canShowCustomControls = videoController?.customControlsEnabled() == true
}
顯示自訂影片控制項
按照下列最佳做法算繪自訂影片控制項：
- 將自訂控制項檢視畫面顯示為原生廣告檢視畫面的子項。這個做法可確保開放式評估可視度計算結果會將自訂控制項視為容易的阻礙。
- 避免在整個媒體檢視畫面上顯示不可見的重疊層。重疊層會阻擋媒體檢視畫面的點擊，進而影響原生廣告成效。建議您改為建立夠大且大小足以容納控制項的小型疊加層。
自訂點擊手勢
自訂點擊手勢是原生廣告功能，使用者只要滑動廣告檢視畫面， 。這項功能可與使用滑動手勢瀏覽內容的應用程式搭配使用。本指南說明如何啟用自訂點擊 對原生廣告套用手勢
初始化 GADNativeAdCustomClickGestureOptions
例項。您也必須指出
必須設為點擊
自訂點擊手勢預設為停用。
如果停用，系統只會將輕觸動作計為點擊次數。
啟用後，滑動手勢就會計為點擊。 是否仍會計算點擊次數。
以下範例說明如何實作自訂滑動手勢，並保留一般輕觸行為。
GADNativeAdCustomClickGestureOptions *swipeGestureOptions = [[GADNativeAdCustomClickGestureOptions alloc]
initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
tapsAllowed:YES];
// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
self.adLoader = [[GADAdLoader alloc]
initWithAdUnitID:@"/21775744923/example/native"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ swipeGestureOptions ]];
監聽滑動手勢事件
記錄滑動手勢點擊時，Google Mobile Ads SDK 會叫用
nativeAdDidRecordSwipeGestureClick:
GADNativeAdDelegate 的委派方法
，除了現有的 nativeAdDidRecordClick: 以外，
委派方法。
#pragma mark - GADNativeAdDelegate implementation
// Called when a swipe gesture click is recorded.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
NSLog(@"A swipe gesture click has occurred.");
}
// Called when a swipe gesture click or a tap click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
NSLog(@"A swipe gesture click or tap click has occurred.");
}
中介服務
自訂點擊手勢僅適用於 Google 行動服務的原生廣告 廣告 SDK 呈現。具有 需要使用第三方 SDK 請不要回應自訂點擊路線設定。