ตัวเลือกโฆษณาเนทีฟ

โฆษณาเนทีฟมีฟีเจอร์ขั้นสูงมากมายที่ช่วยให้คุณ การปรับแต่งและทำให้ประสบการณ์โฆษณาดีที่สุดเท่าที่จะเป็นไปได้ คู่มือนี้จะแสดง วิธีใช้ฟีเจอร์ขั้นสูงของโฆษณาเนทีฟ

ข้อกำหนดเบื้องต้น

• ผสานรวมรูปแบบโฆษณาเนทีฟ

การควบคุมชิ้นงาน

การควบคุมสัดส่วนภาพของสื่อที่ต้องการ

การควบคุมสัดส่วนภาพสื่อช่วยให้คุณระบุค่ากำหนดสำหรับสัดส่วนภาพ ครีเอทีฟโฆษณา

สำคัญ: การใช้ API นี้ไม่ได้รับประกันว่าครีเอทีฟโฆษณาทั้งหมดจะเป็นไปตาม ค่ากำหนดที่ระบุไว้

ตั้งค่า GADNativeAdMediaAdLoaderOptions mediaAspectRatio กับ GADMediaAspectRatio

• เมื่อไม่ได้ตั้งค่า โฆษณาที่ส่งคืนจะมีสัดส่วนภาพของสื่อเท่าใดก็ได้

• เมื่อตั้งค่าแล้ว คุณจะสามารถปรับปรุงประสบการณ์ของผู้ใช้ได้โดยการระบุ ของสัดส่วนภาพที่ต้องการ

ตัวอย่างต่อไปนี้บอก SDK ว่าต้องการส่งคืนรูปภาพหรือวิดีโอที่มี สัดส่วนภาพที่เฉพาะเจาะจง

GADNativeAdMediaAdLoaderOptions *nativeOption = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOption.mediaAspectRatio = GADMediaAspectRatioAny;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

การควบคุมการดาวน์โหลดรูปภาพ

การควบคุมการดาวน์โหลดรูปภาพช่วยให้คุณเลือกได้ว่าจะให้ชิ้นงานรูปภาพหรือเฉพาะ URI SDK แสดงอีกครั้ง

ตั้งค่า 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:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

การควบคุมเพย์โหลดรูปภาพ

โฆษณาบางรายการจะมีชุดรูปภาพ ไม่ใช่แค่ชุดเดียว ใช้ฟีเจอร์นี้เพื่อ เพื่อระบุว่าแอปของคุณพร้อมที่จะแสดงรูปภาพทั้งหมดหรือเพียงรูปเดียว

ตั้งค่า GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages ด้วยค่า BOOL

• การควบคุมเพย์โหลดรูปภาพจะปิดใช้อยู่โดยค่าเริ่มต้น

• เมื่อปิดใช้ แอปของคุณจะสั่งให้ SDK แสดงเฉพาะ รูปภาพแรกสำหรับเนื้อหาที่มีชุด

• เมื่อเปิดใช้ แอปของคุณจะระบุว่าพร้อมแสดงรูปภาพทั้งหมด สำหรับเนื้อหาที่มีมากกว่า 1 ไฟล์

ตัวอย่างต่อไปนี้จะสั่งให้ SDK แสดงชิ้นงานรูปภาพหลายรายการ

GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.shouldRequestMultipleImages = YES;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

ตำแหน่ง "ตัวเลือกโฆษณาอื่นๆ"

การควบคุมตำแหน่งตัวเลือกโฆษณาอื่นๆ

ส่วนควบคุมตำแหน่งของตัวเลือกโฆษณาอื่นๆ ช่วยให้คุณเลือกมุมที่จะแสดง ไอคอนตัวเลือกโฆษณาอื่นๆ

ตั้งค่า GADNativeAdViewAdOptions preferredAdChoicesPosition กับ GADAdChoicesPosition

• หากไม่ได้ตั้งค่า ระบบจะตั้งค่าตำแหน่งไอคอนตัวเลือกโฆษณาอื่นๆ ที่ด้านขวาบน

• หากตั้งค่าไว้ ระบบจะวางตัวเลือกโฆษณาอื่นๆ ที่ตำแหน่งที่กำหนดเองตามคำขอ

ตัวอย่างต่อไปนี้แสดงวิธีกำหนดตำแหน่งรูปภาพตัวเลือกโฆษณาอื่นๆ ที่กำหนดเอง

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

มุมมองที่กำหนดเองของตัวเลือกโฆษณาอื่นๆ

คำเตือน: การเข้าถึงฟีเจอร์นี้ถูกจำกัด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์การเข้าถึง

คุณลักษณะมุมมองที่กำหนดเองของตัวเลือกโฆษณาอื่นๆ ช่วยให้คุณวางตำแหน่งไอคอนตัวเลือกโฆษณาอื่นๆ เป็น ตำแหน่งที่กำหนดเอง ซึ่งแตกต่างจากการควบคุมอันดับของตัวเลือกโฆษณาอื่นๆ ซึ่ง อนุญาตให้ระบุมุมใดมุมหนึ่งจาก 4 มุมได้

ตั้งค่าGADNativeAd.adChoicesView พร็อพเพอร์ตี้ที่มี GADAdChoicesView ก่อนแสดงผลและเนื้อหาของตัวเลือกโฆษณาอื่นๆ จะแสดงภายใน GADAdChoicesView

ตัวอย่างต่อไปนี้แสดงวิธีการตั้งค่ามุมมองตัวเลือกโฆษณาอื่นๆ ที่กำหนดเอง ไอคอนตัวเลือกโฆษณาอื่นๆ จะแสดงภายใน 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:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

ตัวควบคุมการเล่นแบบกำหนดเอง

คำเตือน: การเข้าถึงฟีเจอร์นี้ถูกจำกัด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์การเข้าถึง

ซึ่งจะช่วยให้คุณขอตัวควบคุมอินพุตวิดีโอที่กำหนดเองเพื่อเล่น หยุดชั่วคราว หรือปิดเสียงได้ ในการสร้างสรรค์วิดีโอ

ตั้งค่า GADVideoOptions customControlsRequested ด้วยค่า BOOL

• ตัวควบคุมการเล่นแบบกำหนดเองจะปิดใช้อยู่โดยค่าเริ่มต้น

• เมื่อปิดใช้ วิดีโอจะแสดงตัวควบคุมอินพุตที่แสดงผลด้วย SDK

• เมื่อเปิดใช้แล้ว คุณจะใช้ GADVideoController play ได้ GADVideoController pause และ GADVideoController setMute เพื่อควบคุมโฆษณาวิดีโอ

• หากโฆษณามีเนื้อหาวิดีโอและเปิดใช้การควบคุมที่กำหนดเอง คุณควร จากนั้นแสดงการควบคุมที่กำหนดเองพร้อมกับโฆษณา เนื่องจากโฆษณาจะไม่แสดง ควบคุมตัวเองได้ จากนั้นตัวควบคุมจะสามารถเรียกใช้เมธอดที่เกี่ยวข้องบน GADVideoController

ตัวอย่างต่อไปนี้แสดงวิธีขอวิดีโอด้วยตัวควบคุมการเล่นที่กำหนดเอง

GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.customControlsRequested = YES;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           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:@"ca-app-pub-3940256099942544/3986624511"
      rootViewController:self
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ swipeGestureOptions ]];

คำเตือน: หากบัญชีของคุณไม่ได้เปิดใช้ท่าทางสัมผัสการคลิกที่กำหนดเอง คำขอโฆษณา จะส่งกลับคำที่ไม่มีการส่งโฆษณา

ฟังเหตุการณ์ท่าทางสัมผัสการปัด

เมื่อมีการบันทึกการคลิกด้วยท่าทางสัมผัสการปัด SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google จะเรียกใช้ 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 Mobile เท่านั้น การแสดงผล SDK โฆษณา แหล่งที่มาของโฆษณาที่ ต้องใช้ SDK ของบุคคลที่สามสำหรับ ไม่ตอบสนองต่อการตั้งค่าเส้นทางการคลิกที่กำหนดเอง