Google Mobile Ads SDK อยู่ในโหมดการบำรุงรักษา หากต้องการทราบข้อมูลอัปเดตและฟีเจอร์ล่าสุด โปรดmigrateและตั้งค่า GMA Next-Gen SDK

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

ตั้งค่าฟีเจอร์ขั้นสูง

เลือกแพลตฟอร์ม: Android iOS Android (เดิม)

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

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

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

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

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

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

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

เรียก NativeAdOptions.Builder.setMediaAspectRatio() ด้วยค่า NativeAdOptions.MediaAspectRatio

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

ตัวอย่างต่อไปนี้จะสั่งให้ SDK เลือกรูปภาพหรือวิดีโอที่แสดงผลซึ่งมีสัดส่วนภาพที่เฉพาะเจาะจง

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder()
        .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
        .build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

แทนที่ AD_UNIT_ID ด้วยรหัสหน่วยโฆษณา

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

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

เรียกใช้ NativeAdOptions.Builder.setReturnUrlsForImageAssets() ด้วยค่า boolean

การควบคุมการดาวน์โหลดรูปภาพจะปิดอยู่โดยค่าเริ่มต้น
เมื่อปิดใช้ Google Mobile Ads SDK (Legacy) จะป้อนทั้งรูปภาพและ URI ให้คุณ
เมื่อเปิดใช้ SDK จะป้อนเฉพาะ URI แทน ซึ่งช่วยให้คุณดาวน์โหลดรูปภาพจริงได้ตามที่เห็นสมควร

ตัวอย่างต่อไปนี้จะสั่งให้ SDK แสดงผลเฉพาะ URI

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID")
        .withNativeAdOptions(nativeAdOptions)
        .forNativeAd(
            nativeAd -> {
              List<Uri> imageUris = new ArrayList<>();
              for (Image image : nativeAd.getImages()) {
                imageUris.add(image.getUri());
              }
            })
        .build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build()

val loader =
  AdLoader.Builder(context, "AD_UNIT_ID")
    .withNativeAdOptions(nativeAdOptions)
    .forNativeAd { nativeAd ->
      val imageUris = nativeAd.images.mapNotNull { it.uri }
    }
    .build()NativeAdOptionsSnippets.kt

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

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

เรียกใช้ NativeAdOptions.Builder.setRequestMultipleImages() ด้วยค่า boolean

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

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

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setRequestMultipleImages(true).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setRequestMultipleImages(true).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

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

ส่วนนี้จะอธิบายวิธีจัดตำแหน่งการวางซ้อนตัวเลือกโฆษณาอื่นๆ คุณสามารถเลือกตั้งค่าตำแหน่งโฆษณาเป็นมุมใดมุมหนึ่งจาก 4 มุมหรือแสดงผลภายในมุมมองที่กำหนดเอง

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

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

เรียก NativeAdOptions.Builder.setAdChoicesPlacement() ด้วยค่า NativeAdOption.AdChoicesPlacement

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

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

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder()
        .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
        .build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

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

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

เรียก NativeAdView.setAdChoicesView() ด้วยค่า AdChoicesView

ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่ามุมมองตัวเลือกโฆษณาอื่นๆ ที่กำหนดเอง โดยแสดงไอคอนตัวเลือกโฆษณาอื่นๆ ไว้ภายใน AdChoicesView

Java

NativeAdView nativeAdView = new NativeAdView(context);
AdChoicesView adChoicesView = new AdChoicesView(context);
nativeAdView.setAdChoicesView(adChoicesView);NativeAdOptionsSnippets.java

Kotlin

val nativeAdView = NativeAdView(context)
val adChoicesView = AdChoicesView(context)
nativeAdView.adChoicesView = adChoicesViewNativeAdOptionsSnippets.kt

การควบคุมวิดีโอ

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

ลักษณะการทำงานของการปิดเสียงเมื่อเริ่มต้น

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

เรียกใช้ VideoOptions.Builder.setStartMuted() ด้วยค่า boolean

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

ตัวอย่างต่อไปนี้แสดงวิธีเริ่มวิดีโอโดยเปิดเสียง

Java

VideoOptions videoOptions = new VideoOptions.Builder().setStartMuted(false).build();

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setVideoOptions(videoOptions).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val videoOptions = VideoOptions.Builder().setStartMuted(false).build()

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

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

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

เรียกใช้ VideoOptions.Builder.setCustomControlsRequested() ด้วยค่า boolean

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

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

VideoController

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

Java

VideoOptions videoOptions = new VideoOptions.Builder().setCustomControlsRequested(true).build();

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setVideoOptions(videoOptions).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val videoOptions = VideoOptions.Builder().setCustomControlsRequested(true).build()

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

ตรวจสอบว่าได้เปิดใช้การควบคุมที่กำหนดเองหรือไม่

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

Java

MediaContent mediaContent = nativeAd.getMediaContent();
if (mediaContent != null) {
  VideoController videoController = mediaContent.getVideoController();
  boolean canShowCustomControls = videoController.isCustomControlsEnabled();
}NativeAdOptionsSnippets.java

Kotlin

val mediaContent = nativeAd.mediaContent
if (mediaContent != null) {
  val videoController = mediaContent.videoController
  val canShowCustomControls = videoController.isCustomControlsEnabled
}NativeAdOptionsSnippets.kt

แสดงผลตัวควบคุมวิดีโอที่กำหนดเอง

แสดงผลตัวควบคุมวิดีโอที่กำหนดเองโดยใช้แนวทางปฏิบัติแนะนำต่อไปนี้

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

ท่าทางสัมผัสการคลิกที่กำหนดเอง

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

เรียกใช้ NativeAdOptions.Builder.enableCustomClickGestureDirection() ด้วย NativeAdOptions.SwipeGestureDirection และ boolean เพื่อระบุว่าจะอนุญาตให้การแตะเป็นการคลิกหรือไม่

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

ตัวอย่างต่อไปนี้ใช้ท่าทางสัมผัสการปัดที่กำหนดเองไปทางขวาและคงลักษณะการแตะตามปกติไว้

Java

NativeAdOptions adOptions =
    new NativeAdOptions.Builder()
        .enableCustomClickGestureDirection(
            NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT, /* tapsAllowed= */ true)
        .build();

// ca-app-pub-3940256099942544/2247696110 is a sample ad unit ID that has custom click
// gestures enabled.
AdLoader.Builder builder =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(adOptions);NativeAdOptionsSnippets.java

Kotlin

val adOptions =
  NativeAdOptions.Builder()
    .enableCustomClickGestureDirection(NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT, true)
    .build()

val builder = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(adOptions)NativeAdOptionsSnippets.kt

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

เมื่อมีการบันทึกการคลิกด้วยท่าทางสัมผัสแบบปัด Google Mobile Ads SDK (Legacy) จะเรียกใช้เมธอด onAdSwipeGestureClicked() ใน AdListener นอกเหนือจากเมธอด onAdClicked() ที่มีอยู่

Java

AdLoader adLoader =
    new AdLoader.Builder(context, AD_UNIT_ID)
        .withAdListener(
            new AdListener() {
              // Called when a swipe gesture click is recorded.
              @Override
              public void onAdSwipeGestureClicked() {
                // Called when a swipe gesture click is recorded.
                Log.d(TAG, "A swipe gesture click has occurred.");
              }

              @Override
              public void onAdClicked() {
                // Called when a swipe gesture click or a tap click is recorded, as
                // configured in NativeAdOptions.
                Log.d(TAG, "A swipe gesture click or a tap click has occurred.");
              }
            })
        .build();NativeAdOptionsSnippets.java

Kotlin

val adLoader =
  AdLoader.Builder(context, AD_UNIT_ID)
    .withAdListener(
      object : AdListener() {
        override fun onAdSwipeGestureClicked() {
          // Called when a swipe gesture click is recorded.
          Log.d(TAG, "A swipe gesture click has occurred.")
        }

        override fun onAdClicked() {
          // Called when a swipe gesture click or a tap click is recorded, as
          // configured in NativeAdOptions.
          Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
        }
      }
    )
    .build()NativeAdOptionsSnippets.kt

สื่อกลาง

ท่าทางการคลิกที่กำหนดเองจะใช้ได้กับโฆษณาเนทีฟที่ Google Mobile Ads SDK แสดงผลเท่านั้น แหล่งที่มาของโฆษณาที่ต้องใช้ SDK ของบุคคลที่สามสำหรับการแสดงผลจะไม่ตอบสนองต่อการตั้งค่าเส้นทางการคลิกที่กำหนดเอง