การกำหนดเป้าหมาย

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

คู่มือนี้อธิบายวิธีระบุข้อมูลการกำหนดเป้าหมายให้กับ Google Mobile Ads SDK

หากต้องการดูตัวอย่างการทำงาน ให้ดาวน์โหลดแอปเดโม Android API

ดาวน์โหลด API Demo

วิชาบังคับก่อน

โปรดตั้งค่า Google Mobile Ads SDK (Legacy) ก่อนดำเนินการต่อ

RequestConfiguration

RequestConfiguration จะรวบรวมข้อมูลการกำหนดเป้าหมายที่ใช้กับคำขอโฆษณาทุกรายการทั่วโลก โปรดดูแท็กการกำหนดเป้าหมายที่ใช้ได้ใน RequestConfiguration.Builder เอกสารประกอบ

หากต้องการอัปเดตการกำหนดค่าคำขอ ให้รับ Builder จากการกำหนดค่าที่มีอยู่ ทำการอัปเดตที่เลือก แล้วตั้งค่าดังนี้

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

โปรดตั้งค่าการกำหนดค่าคำขอก่อนที่จะ เริ่มต้น Google Mobile Ads SDK (Legacy)เพื่อให้คำขอโฆษณาทั้งหมดใช้การเปลี่ยนแปลงการกำหนดค่าคำขอ

ตั้งค่ากลุ่มทดสอบตามอายุ

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

คุณสามารถตั้งค่ากลุ่มทดสอบตามอายุด้วยเมธอด setAgeRestrictedTreatment() ด้วย RequestConfiguration.Builder API

ตัวอย่างต่อไปนี้ระบุว่าคำขอโฆษณาควรได้รับการดูแลตามอายุของเด็ก

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

หากต้องการระบุการดูแลตามอายุของวัยรุ่นหรืออายุที่ไม่ได้ระบุ ให้แทนที่การตั้งค่า CHILD ด้วยการตั้งค่าต่อไปนี้

• TEEN
• UNSPECIFIED

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

ย้ายข้อมูลไปยังการดูแลตามอายุจาก TFCD และ TFUA

การตั้งค่าการดูแลตามอายุจะแทนที่การตั้งค่า .setTagForChildDirectedTreatment() (TFCD) และ .setTagForUnderAgeOfConsent() (TFUA) ที่เลิกใช้งานแล้ว

ตารางต่อไปนี้แสดงการตั้งค่า TFCD และ TFUA และการตั้งค่าการดูแลตามอายุที่เทียบเท่า

TFCD

TFCD	การดูแลตามอายุ
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
ไม่มีการกำหนดค่า .setTagForChildDirectedTreatment()	AgeRestrictedTreatment.UNSPECIFIED
ไม่มีเวอร์ชันเทียบเท่า	AgeRestrictedTreatment.TEEN

TFUA

TFUA	การดูแลตามอายุ
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
ไม่มีการกำหนดค่า .setTagForUnderAgeOfConsent()	AgeRestrictedTreatment.UNSPECIFIED
ไม่มีเวอร์ชันเทียบเท่า	AgeRestrictedTreatment.TEEN

ทำความเข้าใจการโต้ตอบของการดูแลตามอายุกับ TFCD และ TFUA

หากคุณตั้งค่าการดูแลตามอายุและค่า TFCD หรือ TFUA ไว้ Google จะใช้การดูแลที่เข้มงวดมากที่สุด

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

ส่งต่อการดูแลตามอายุด้วยสื่อกลาง AdMob

หากคุณตั้งค่าการดูแลตามอายุโดยใช้Google Mobile Ads SDK (Legacy)อะแดปเตอร์สื่อกลางจะส่งต่อสัญญาณการดูแลตามอายุไปยังบุคคลที่สามที่ใช้สื่อกลาง SDK

ตารางต่อไปนี้แสดงรายการเวอร์ชันอะแดปเตอร์สื่อกลางที่รองรับการส่งต่อสัญญาณการดูแลแบบจำกัดอายุไปยัง SDK บุคคลที่สามที่ใช้สื่อกลาง

ชื่ออะแดปเตอร์สื่อกลาง	เวอร์ชันต่ำสุดที่รองรับ
AppLovin	13.6.3.0
BidMachine	3.7.1.1
Bigo	5.9.0.1
Chartboost	9.12.1.1
DTExchange (Fyber)	8.4.5.1
i-mobile	2.3.2.4
InMobi	11.3.0.1
IronSource	9.4.3.0
Liftoff Monetize (Vungle)	7.7.4.2
LY (Line)	3.1.1.1
maio	2.0.9.0
Meta (Facebook)	6.21.0.4
Mintegral	17.1.61.1
Moloco	4.10.0.0
MyTarget	5.47.1.1
Pangle	8.1.0.3.1
PubMatic	5.1.2.2
Verve	3.9.0.0

การตั้งค่า "มีเด็กเป็นกลุ่มเป้าหมาย"

คำเตือน: เมธอด setTagForChildDirectedTreatment() เลิกใช้งานแล้ว ให้ตั้งค่าเมธอด setAgeRestrictedTreatment()

แทน

ตามวัตถุประสงค์ของ กฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (Children's Online Privacy Protection Act หรือ COPPA), มีการตั้งค่าที่เรียกว่า "แท็กสำหรับการดูแลให้เหมาะสมกับเด็ก" การตั้งค่าแท็กนี้แสดงว่าคุณรับรองว่าการแจ้งเตือนนี้ถูกต้องและคุณได้รับอนุญาตให้ดำเนินการในนามของเจ้าของแอป คุณเข้าใจว่าการนำการตั้งค่านี้ไปใช้ในทางที่ผิดอาจส่งผลให้บัญชี Google ของคุณสิ้นสุดลง

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

คุณสามารถใช้การตั้งค่า "มีเด็กเป็นกลุ่มเป้าหมาย" ผ่าน setTagForChildDirectedTreatment() ได้ดังนี้

• เรียก setTagForChildDirectedTreatment ด้วย TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE เพื่อระบุว่าต้องการให้เนื้อหาของคุณมีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA ซึ่งจะป้องกันการส่ง ตัวระบุโฆษณา Android (AAID)

• เรียก setTagForChildDirectedTreatment ด้วย TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE เพื่อระบุว่าไม่ต้องการให้เนื้อหาของคุณได้รับการดูแลให้มีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA

• เรียก setTagForChildDirectedTreatment ด้วย TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED หากไม่ต้องการระบุวิธีที่ต้องการให้เนื้อหาของคุณได้รับการดูแลตาม COPPA ในคำขอโฆษณา

ตัวอย่างต่อไปนี้ระบุว่าคุณต้องการให้เนื้อหาของคุณได้รับการดูแลให้มีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForChildDirectedTreatment(
            RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

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

ผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้

คำเตือน: เมธอด setTagForUnderAgeOfConsent() เลิกใช้งานแล้ว ให้ตั้งค่าเม0}เมธอด แทนsetAgeRestrictedTreatment()

คุณทำเครื่องหมายให้กับคำขอโฆษณาเพื่อรับการปฏิบัติสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ยินยอมได้ ฟีเจอร์นี้ ออกแบบมาเพื่อช่วยให้ปฏิบัติตามกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR)ได้สะดวก คุณอาจมีภาระหน้าที่อื่นๆ ตามกฎหมายภายใต้ GDPR โปรดอ่านหลักเกณฑ์ของสหภาพยุโรปและปรึกษาที่ปรึกษาด้านกฎหมาย เครื่องมือของ Google ได้รับการออกแบบมาเพื่อช่วยให้ปฏิบัติตามกฎระเบียบนี้ได้สะดวกเท่านั้น แต่ไม่ได้ลดทอนภาระหน้าที่ของผู้เผยแพร่โฆษณาตามที่กฎระเบียบดังกล่าวระบุไว้แต่อย่างใด ดูข้อมูลเพิ่มเติมเพื่อให้เข้าใจว่า GDPR ส่งผลต่อผู้เผยแพร่โฆษณาอย่างไร

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

เช่นเดียวกับการตั้งค่า "มีเด็กเป็นกลุ่มเป้าหมาย" มีเมธอดใน RequestConfiguration.Builderสำหรับตั้งค่าพารามิเตอร์ TFUA: setTagForUnderAgeOfConsent(), พร้อมตัวเลือกต่อไปนี้

• เรียก setTagForUnderAgeOfConsent() ด้วย TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE เพื่อระบุว่าต้องการให้คำขอโฆษณาได้รับการดูแลสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ยินยอมได้ ซึ่งจะป้องกันการส่งตัวระบุโฆษณา Android (AAID)ด้วย

• เรียก setTagForUnderAgeOfConsent() ด้วย TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE เพื่อระบุว่าต้องการให้คำขอโฆษณา ไม่ ได้รับการดูแลสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ยินยอมได้

• เรียก setTagForUnderAgeOfConsent() ด้วย TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED เพื่อระบุว่าคุณไม่ได้ระบุว่าคำขอโฆษณาควรได้รับการดูแลสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ยินยอมได้หรือไม่

ตัวอย่างต่อไปนี้ระบุว่าคุณต้องการให้รวม TFUA ไว้ในคำขอโฆษณา

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

แท็กเพื่อเปิดใช้การตั้งค่า มีเด็กเป็นกลุ่มเป้าหมาย และ setTagForUnderAgeOfConsent() ไม่ควรตั้งค่าเป็น true พร้อมกัน หากตั้งค่าเป็น `true` พร้อมกัน การตั้งค่า "มีเด็กเป็นกลุ่มเป้าหมาย" จะมีผลเหนือกว่า

การกรองเนื้อหาโฆษณา

เพื่อให้เป็นไปตามนโยบายโฆษณาที่ไม่เหมาะสม ของ Google Play ซึ่งรวมถึงข้อเสนอที่เกี่ยวข้องภายในโฆษณา โฆษณาทั้งหมดและข้อเสนอที่เกี่ยวข้องที่แสดงภายในแอปต้องเหมาะสมกับการจัดประเภทเนื้อหาของ แอป แม้ว่าตัวเนื้อหาเองจะเป็นไปตามนโยบายของ Google Play อยู่แล้ว

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

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

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

โปรดดูข้อมูลเพิ่มเติมดังต่อไปนี้

• การกำหนดการจัดประเภทเนื้อหาสูงสุดให้กับคำขอโฆษณาแต่ละรายการ

• การกำหนดการจัดประเภทเนื้อหาโฆษณาสูงสุดสำหรับแอปหรือบัญชี

หมายเหตุ: การตั้งค่าตัวกรองการจัดประเภทเนื้อหาที่ระบุผ่าน Google Mobile Ads SDK (Legacy) จะลบล้างการตั้งค่าที่กำหนดค่าโดยใช้อินเทอร์เฟซผู้ใช้ AdMob

Publisher Privacy Treatment (เบต้า)

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

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setPublisherPrivacyPersonalizationState(
            RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

หมายเหตุ: สำหรับคำขอโฆษณาที่มีสัญญาณด้านความเป็นส่วนตัวของผู้ใช้หลายรายการ สัญญาณที่จำกัดสิทธิ์มากที่สุด จะมีลำดับความสำคัญสูงกว่า ดูตัวอย่างเฉพาะได้ในเอกสารประกอบเกี่ยวกับ Publisher Privacy Treatment API

คำขอโฆษณา

ออบเจ็กต์ AdRequest จะรวบรวมข้อมูลการกำหนดเป้าหมายเพื่อส่ง ไปพร้อมกับคำขอโฆษณา

เพิ่มข้อมูลเพิ่มเติมของเครือข่าย

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

ข้อมูลโค้ดต่อไปนี้จะตั้งค่าคีย์พารามิเตอร์เพิ่มเติมเป็น collapsible โดยมีค่าเป็น bottom ไปยัง Google

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)
AdRequestSnippets.kt

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);
AdRequestSnippets.java