โฆษณาเนทีฟมีฟีเจอร์ขั้นสูงมากมายที่ช่วยให้คุณ การปรับแต่งและทำให้ประสบการณ์โฆษณาดีที่สุดเท่าที่จะเป็นไปได้ คู่มือนี้จะแสดง วิธีใช้ฟีเจอร์ขั้นสูงของโฆษณาเนทีฟ
ข้อกำหนดเบื้องต้น
- ผสานรวมรูปแบบโฆษณาเนทีฟ
การควบคุมชิ้นงาน
การควบคุมสัดส่วนภาพของสื่อที่ต้องการ
การควบคุมสัดส่วนภาพสื่อช่วยให้คุณระบุค่ากำหนดสำหรับสัดส่วนภาพ ครีเอทีฟโฆษณา
โทร NativeAdOptions.Builder.setMediaAspectRatio()
กับ NativeAdOptions.MediaAspectRatio
เมื่อไม่ได้ตั้งค่า โฆษณาที่ส่งคืนจะมีสัดส่วนภาพของสื่อเท่าใดก็ได้
เมื่อตั้งค่าแล้ว คุณจะสามารถปรับปรุงประสบการณ์ของผู้ใช้ได้โดยการระบุ ของสัดส่วนภาพที่ต้องการ
ตัวอย่างต่อไปนี้บอก SDK ว่าต้องการส่งคืนรูปภาพหรือวิดีโอที่มี สัดส่วนภาพที่เฉพาะเจาะจง
NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
.setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
.build();
AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(nativeAdOptions)
.build();
การควบคุมการดาวน์โหลดรูปภาพ
การควบคุมการดาวน์โหลดรูปภาพช่วยให้คุณเลือกได้ว่าจะให้ชิ้นงานรูปภาพหรือเฉพาะ URI SDK แสดงอีกครั้ง
โทรNativeAdOptions.Builder.setReturnUrlsForImageAssets()
ด้วยค่า boolean
การควบคุมการดาวน์โหลดรูปภาพจะปิดใช้อยู่โดยค่าเริ่มต้น
เมื่อปิดใช้ Google Mobile Ads SDK จะเติมทั้งรูปภาพและ URI ให้คุณ
เมื่อเปิดใช้ SDK จะป้อนเพียง URI แทน ซึ่งจะช่วยให้คุณดาวน์โหลดได้ ภาพจริงตามการพิจารณาตามที่เห็นสมควร
ตัวอย่างต่อไปนี้สั่งให้ SDK แสดงผลเฉพาะ URI
NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
.setReturnUrlsForImageAssets(true)
.build();
AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(nativeAdOptions)
.forNativeAd(nativeAd -> {
List<Uri> imageUris = new ArrayList<>();
for (Image image : nativeAd.getImages()) {
imageUris.add(image.getUri());
}
})
.build();
การควบคุมเพย์โหลดรูปภาพ
โฆษณาบางรายการจะมีชุดรูปภาพ ไม่ใช่แค่ชุดเดียว ใช้ฟีเจอร์นี้เพื่อ เพื่อระบุว่าแอปของคุณพร้อมที่จะแสดงรูปภาพทั้งหมดหรือเพียงรูปเดียว
โทรNativeAdOptions.Builder.setRequestMultipleImages()
ด้วยค่า boolean
การควบคุมเพย์โหลดรูปภาพจะปิดใช้อยู่โดยค่าเริ่มต้น
เมื่อปิดใช้ แอปของคุณจะสั่งให้ SDK แสดงเฉพาะ รูปภาพแรกสำหรับเนื้อหาที่มีชุด
เมื่อเปิดใช้ แอปของคุณจะระบุว่าพร้อมแสดงรูปภาพทั้งหมด สำหรับเนื้อหาที่มีมากกว่า 1 ไฟล์
ตัวอย่างต่อไปนี้จะสั่งให้ SDK แสดงชิ้นงานรูปภาพหลายรายการ
NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
.setRequestMultipleImages(true)
.build();
AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(nativeAdOptions)
.build();
ตำแหน่ง "ตัวเลือกโฆษณาอื่นๆ"
การควบคุมตำแหน่งตัวเลือกโฆษณาอื่นๆ
ส่วนควบคุมตำแหน่งของตัวเลือกโฆษณาอื่นๆ ช่วยให้คุณเลือกมุมที่จะแสดง ไอคอนตัวเลือกโฆษณาอื่นๆ
โทร NativeAdOptions.Builder.setAdChoicesPlacement()
กับ NativeAdOption.AdChoicesPlacement
หากไม่ได้ตั้งค่า ระบบจะตั้งค่าตำแหน่งไอคอนตัวเลือกโฆษณาอื่นๆ ที่ด้านขวาบน
หากตั้งค่าไว้ ระบบจะวางตัวเลือกโฆษณาอื่นๆ ที่ตำแหน่งที่กำหนดเองตามคำขอ
ตัวอย่างต่อไปนี้แสดงวิธีกำหนดตำแหน่งรูปภาพตัวเลือกโฆษณาอื่นๆ ที่กำหนดเอง
NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
.setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
.build();
AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(nativeAdOptions)
.build();
มุมมองที่กำหนดเองของตัวเลือกโฆษณาอื่นๆ
คุณลักษณะมุมมองที่กำหนดเองของตัวเลือกโฆษณาอื่นๆ ช่วยให้คุณวางตำแหน่งไอคอนตัวเลือกโฆษณาอื่นๆ เป็น ตำแหน่งที่กำหนดเอง ซึ่งแตกต่างจากการควบคุมอันดับของตัวเลือกโฆษณาอื่นๆ ซึ่ง อนุญาตให้ระบุมุมใดมุมหนึ่งจาก 4 มุมได้
โทรNativeAdView.setAdChoicesView()
กับ AdChoicesView
ตัวอย่างต่อไปนี้แสดงวิธีการตั้งค่ามุมมองตัวเลือกโฆษณาอื่นๆ ที่กำหนดเอง
ไอคอนตัวเลือกโฆษณาอื่นๆ จะแสดงภายใน AdChoicesView
public void onNativeAdLoaded(NativeAd ad) {
NativeAdView nativeAdView = new NativeAdView(getApplicationContext());
AdChoicesView adChoicesView = new AdChoicesView(this);
nativeAdView.setAdChoicesView(adChoicesView);
}
การควบคุมวิดีโอ
เริ่มลักษณะการทำงานของการปิดเสียง
ลักษณะการทำงานที่ปิดเสียงเมื่อเริ่มต้นจะทำให้คุณสามารถปิดหรือเปิดใช้เสียงเริ่มต้นของวิดีโอได้
โทรVideoOptions.Builder.setStartMuted()
ด้วยค่า boolean
ระบบจะเปิดใช้ลักษณะการทำงานที่ปิดเสียงเมื่อเริ่มต้นไว้โดยค่าเริ่มต้น
เมื่อปิดใช้งาน แอปของคุณจะขอให้วิดีโอขึ้นต้นด้วย เสียง
เมื่อเปิดใช้ แอปจะขอให้วิดีโอเริ่มต้นด้วยการปิดเสียง
ตัวอย่างต่อไปนี้แสดงวิธีเริ่มเล่นวิดีโอแบบไม่มีเสียง
VideoOptions videoOptions = new VideoOptions.Builder()
.setStartMuted(false)
.build();
NativeAdOptions adOptions = new NativeAdOptions.Builder()
.setVideoOptions(videoOptions)
.build();
AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(adOptions).build();
ตัวควบคุมการเล่นแบบกำหนดเอง
ซึ่งจะช่วยให้คุณขอตัวควบคุมอินพุตวิดีโอที่กำหนดเองเพื่อเล่น หยุดชั่วคราว หรือปิดเสียงได้ ในการสร้างสรรค์วิดีโอ
โทรVideoOptions.Builder.setCustomControlsRequested()
ด้วยค่า boolean
ตัวควบคุมการเล่นแบบกำหนดเองจะปิดใช้อยู่โดยค่าเริ่มต้น
เมื่อปิดใช้ วิดีโอจะแสดงตัวควบคุมอินพุตที่แสดงผลด้วย SDK
- หากโฆษณามีเนื้อหาวิดีโอและเปิดใช้การควบคุมที่กำหนดเอง คุณควร
จากนั้นแสดงการควบคุมที่กำหนดเองพร้อมกับโฆษณา เนื่องจากโฆษณาจะไม่แสดง
ควบคุมตัวเองได้ จากนั้นตัวควบคุมจะสามารถเรียกใช้เมธอดที่เกี่ยวข้องบน
VideoController
ตัวอย่างต่อไปนี้แสดงวิธีขอวิดีโอด้วยตัวควบคุมการเล่นที่กำหนดเอง
VideoOptions videoOptions = new VideoOptions.Builder()
.setCustomControlsRequested(true)
.build();
NativeAdOptions adOptions = new NativeAdOptions.Builder()
.setVideoOptions(videoOptions)
.build();
AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(adOptions).build();
ตรวจสอบว่าเปิดใช้การควบคุมที่กำหนดเองอยู่หรือไม่
เนื่องจากในขั้นตอนที่ขอ โฆษณาที่แสดงผลจะอนุญาต การควบคุมวิดีโอที่กำหนดเอง คุณต้องตรวจสอบว่าได้เปิดใช้การควบคุมที่กำหนดเองหรือไม่
Java
@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
MediaContent mediaContent = nativeAd.getMediaContent();
if (mediaContent != null) {
VideoController videoController = mediaContent.getVideoController();
boolean canShowCustomControls = videoController.isCustomControlsEnabled();
}
}
Kotlin
NativeAd.OnNativeAdLoadedListener { ad ->
val mediaContent = ad.mediaContent
if (mediaContent != null) {
val videoController = mediaContent.videoController
val canShowCustomControls = videoController.isCustomControlsEnabled
}
}
ท่าทางสัมผัสการคลิกที่กำหนดเอง
ท่าทางสัมผัสการคลิกที่กำหนดเองเป็นฟีเจอร์โฆษณาเนทีฟที่ช่วยให้สามารถปัดดูโฆษณาเพื่อ ที่ลงทะเบียนเป็นการคลิกโฆษณาได้ ออกแบบมาให้ใช้งานได้กับแอปที่ใช้การปัด การนำทางเนื้อหา คู่มือนี้แสดงวิธีเปิดใช้คลิกที่กำหนดเอง ในโฆษณาเนทีฟ
โทร NativeAdOptions.Builder.enableCustomClickGestureDirection()
กับ NativeAdOptions.SwipeGestureDirection
และ boolean
เพื่อระบุว่าคุณต้องการให้อนุญาตการแตะเป็นการคลิกหรือไม่
ท่าทางสัมผัสการคลิกที่กำหนดเองจะปิดใช้อยู่โดยค่าเริ่มต้น
เมื่อปิดใช้ แอปจะรองรับการคลิกปกติ
เมื่อเปิดใช้ แอปจะรองรับท่าทางสัมผัสการปัดที่กำหนดเอง
ตัวอย่างต่อไปนี้ใช้ท่าทางสัมผัสการปัดที่กำหนดเองและไปทางขวา รักษาลักษณะการทำงานปกติของแท็บไว้
NativeAdOptions adOptions = new NativeAdOptions
.Builder()
.enableCustomClickGestureDirection(NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT,
/* tapsAllowed= */ true)
.build();
// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
AdLoader.Builder builder = new AdLoader
.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(adOptions);
ฟังเหตุการณ์ท่าทางสัมผัสการปัด
เมื่อมีการบันทึกการคลิกด้วยท่าทางสัมผัสการปัด SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google จะเรียกใช้
onAdSwipeGestureClicked()
ใน AdListener
นอกเหนือจากเมธอดที่มีอยู่
onAdClicked()
วิธี
AdLoader adLoader = builder
.withAdListener(
new AdListener() {
// Called when a swipe gesture click is recorded.
@Override
public void onAdSwipeGestureClicked() {
Log.d(TAG, "A swipe gesture click has occurred.")
}
// Called when a swipe gesture click or a tap click is recorded, as
// configured in NativeAdOptions.
@Override
public void onAdClicked() {
Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
}
})
.build();
สื่อกลาง
ท่าทางสัมผัสการคลิกที่กำหนดเองใช้ได้กับโฆษณาเนทีฟที่ Google Mobile เท่านั้น การแสดงผล SDK โฆษณา แหล่งที่มาของโฆษณาที่ ต้องใช้ SDK ของบุคคลที่สามสำหรับ ไม่ตอบสนองต่อการตั้งค่าเส้นทางการคลิกที่กำหนดเอง