แชร์ความคิดเห็นเกี่ยวกับ GMA Next-Gen SDK ในแชแนล #gma-next-gen-sdk ของเซิร์ฟเวอร์ชุมชนการโฆษณาและการวัดผลของ Google ใน Discord

กำหนดค่า URL ของความโปร่งใสเกี่ยวกับโฆษณา

URL ความโปร่งใสของโฆษณาช่วยให้คุณปรับแต่งไอคอน AdChoices ที่แสดงในโฆษณาบางรายการได้ โดยค่าเริ่มต้น ไอคอนนี้จะปรากฏต่อผู้ใช้ผ่านประสบการณ์ความโปร่งใสและการควบคุมโฆษณา (AT&C) ที่ Google แสดง ซึ่งมีข้อมูลต่างๆ เช่น ผู้ลงโฆษณาและตัวโฆษณาเอง

คุณขอ URL ความโปร่งใสของโฆษณาได้โดยส่งคำขอโฆษณาไปยัง Google Mobile Ads SDK และรับการตอบกลับที่มี URL ความโปร่งใสของโฆษณา หลังจากได้รับ URL ภายในแอปแล้ว คุณสามารถผสานรวมไอคอนที่ปรับเปลี่ยนในแบบของคุณซึ่งเป็นไปตามการออกแบบของโฆษณา และนำเสนอประสบการณ์ AT&C ของคุณเองต่อผู้ใช้

หน้านี้ครอบคลุมวิธีขอ แยกวิเคราะห์ และตรวจสอบ URL ความโปร่งใสของโฆษณา

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

ก่อนดำเนินการต่อ โปรดตรวจสอบว่าคุณได้ทำสิ่งต่อไปนี้แล้ว

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

ขอ URL

หากต้องการให้ GMA Next-Gen SDK แสดง URL ความโปร่งใสของโฆษณา คุณต้องเพิ่มพารามิเตอร์คำขอเพิ่มเติมในคำขอโฆษณาเนทีฟ พารามิเตอร์นี้จะส่งสัญญาณ ว่าแอปของคุณพร้อมและเตรียมรับไอคอนที่ปรับเปลี่ยนในแบบของคุณแล้ว

ในคำขอ คุณต้องเพิ่มคีย์ "ad_transparency_url_requested" ที่มีค่า "1" ลงในแพ็กเกจเสริมของเครือข่าย ดูรายละเอียดเกี่ยวกับเครือข่ายเพิ่มเติมได้ที่ setGoogleExtrasBundle

ตัวอย่างต่อไปนี้จะตั้งค่าคีย์และค่านี้เพื่อขอ URL ความโปร่งใสของโฆษณา

Java

private void loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation.
  Bundle extras = new Bundle();
  extras.putString("ad_transparency_url_requested", "1");
  NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
      .setGoogleExtrasBundle(extras)
      .build();
}

Kotlin

private fun loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation
  val extras = Bundle()
  extras.putString("ad_transparency_url_requested", "1");
  val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
}

แทนที่ AD_UNIT_ID ด้วยรหัสหน่วยโฆษณา เช่น ca-app-pub-3940256099942544/2247696110 สำหรับโฆษณาเนทีฟ

แยกวิเคราะห์ URL

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

คุณเข้าถึง URL เพื่อความโปร่งใสของโฆษณาได้ภายในคีย์ "ad_transparency_url" จากข้อมูลพิเศษในการตอบกลับ ตัวอย่างต่อไปนี้จะรับ URL ความโปร่งใสของโฆษณาใน ออบเจ็กต์ข้อมูลการตอบกลับ

Java

nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");

Kotlin

nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")

ตรวจสอบ URL

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

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

https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID