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

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

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

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

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

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

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

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

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

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

เรียก NativeAdRequest.Builder.setMediaAspectRatio() ด้วยค่า NativeAd.NativeMediaAspectRatio

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

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

Kotlin

val adRequest = NativeAdRequest.Builder(
  "/21775744923/example/native",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
  .build()

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "/21775744923/example/native",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
  .build();

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

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

โทร NativeAdRequest.Builder.disableImageDownloading()

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

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

Kotlin

val adRequest = NativeAdRequest.Builder(
    "/21775744923/example/native",
    listOf(NativeAd.NativeAdType.NATIVE))
    .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
    .disableImageDownloading()
    .build()

val adCallback: NativeAdLoaderCallback =
  object : NativeAdLoaderCallback {
    override fun onNativeAdLoaded(nativeAd: NativeAd) {
      // Get the image uri.
      val imageUri = nativeAd.image?.uri
    }
  };

// Load the native ad with the ad request and callback.
NativeAdLoader.load(adRequest, adLoaderCallback);

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "/21775744923/example/native",
  List.of(NativeAd.NativeAdType.NATIVE))
  .disableImageDownloading()
  .build();

NativeAdLoaderCallback adLoaderCallback =
  new NativeAdLoaderCallback() {
    @Override
    public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
      // Get the image uri.
      Uri imageUri = nativeAd.getImage().getUri();
    }
  };

// Load the native ad with the ad request and callback.
NativeAdLoader.load(adRequest, adLoaderCallback);

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

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

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

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

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

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

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

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

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

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

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

Kotlin

val adRequest = NativeAdRequest.Builder(
  "/21775744923/example/native",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
  .build()

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "/21775744923/example/native",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
  .build();

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

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

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

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

Kotlin

override fun onNativeAdLoaded(nativeAd: NativeAd) {
  val nativeAdView = NativeAdView(applicationContext)
  val adChoicesView = AdChoicesView(this)
  nativeAdView.adChoicesView = adChoicesView
}

Java

public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
  NativeAdView nativeAdView = new NativeAdView(getApplicationContext());
  AdChoicesView adChoicesView = new AdChoicesView(this);
  nativeAdView.setAdChoicesView(adChoicesView);
}

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

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

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

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

เรียก VideoOptions.Builder.setStartMuted() ด้วยค่า boolean และเรียก NativeAdOptions.Builder.setVideoOptions()

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

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

Kotlin

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

val adRequest = NativeAdRequest.Builder(
  "/21775744923/example/native",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

Java

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

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "/21775744923/example/native",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

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

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

หากต้องการตั้งค่าสถานะปิดเสียงเริ่มต้นของโฆษณา ให้เรียกใช้ VideoOptions.Builder.setCustomControlsRequested()

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

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

VideoOptions.Builder.setCustomControlsRequested()

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

Kotlin

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

val adRequest = new NativeAdRequest.Builder(
  "/21775744923/example/native",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

Java

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

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "/21775744923/example/native",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

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

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

Kotlin

  val adCallback: NativeAdLoaderCallback =
    object : NativeAdLoaderCallback {
      override fun onNativeAdLoaded(nativeAd: NativeAd) {
        val mediaContent = nativeAd.mediaContent;
        if (mediaContent != null) {
          val videoController = mediaContent.videoController;
          val canShowCustomControls = videoController?.isCustomControlsEnabled();
        }
      }
    };

Java

NativeAdLoaderCallback adCallback =
  new NativeAdLoaderCallback() {
    @Override
    public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
      MediaContent mediaContent = nativeAd.getMediaContent();
      if (mediaContent != null) {
        VideoController videoController = mediaContent.getVideoController();
        if (videoController != null) {
          boolean canShowCustomControls = videoController.isCustomControlsEnabled();
        }
      }
    }
  };

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

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

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

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

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

เรียกใช้ NativeAdRequest.Builder.enableCustomClickGestureDirection() ด้วย NativeAd.SwipeGestureDirection และค่า boolean

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

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

Kotlin

val adRequest =
  NativeAdRequest.Builder(AD_UNIT_ID, listOf(NativeAdType.NATIVE))
    .enableCustomClickGestureDirection(
      SwipeGestureDirection.RIGHT,
      /* customClickGestureAllowTaps= */ true,
    )
    .build()

Java

NativeAdRequest adRequest =
    new NativeAdRequest.Builder(AD_UNIT_ID, List.of(NativeAdType.NATIVE))
        .enableCustomClickGestureDirection(
            SwipeGestureDirection.RIGHT, /* customClickGestureAllowTaps= */ true)
        .build();

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

หากต้องการฟังเหตุการณ์ท่าทางสัมผัสแบบปัด ให้เรียกใช้ NativeAd.setAdEventCallback() ด้วย NativeAdEventCallback และใช้เมธอด onAdSwipeGestureClicked()

Kotlin

  val adCallback: NativeAdLoaderCallback =
    object : NativeAdLoaderCallback {
      override fun onNativeAdLoaded(nativeAd: NativeAd) {
        // Implement the onAdSwipeGestureClicked() method.
        val nativeAdCallback: NativeAdEventCallback = object : NativeAdEventCallback {
          override fun onAdSwipeGestureClicked() {
            // A swipe gesture click has occurred.
          }
        }
      }
    }
  // Load the native ad with the ad request and callback.
  NativeAdLoader.load(adRequest, adCallback)

Java

  NativeAdLoaderCallback adCallback =
    new NativeAdLoaderCallback() {
      @Override
      public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
        // Implement the onAdSwipeGestureClicked() method.
        NativeAdEventCallback nativeAdCallback = new NativeAdEventCallback() {
          @Override
          public void onAdSwipeGestureClicked() {
            // A swipe gesture click has occurred.
          }
        };
      }
    };
  // Load the native ad with the ad request and callback.
  NativeAdLoader.load(adRequest, adCallback);

สื่อกลาง

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