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

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

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

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

ดาวน์โหลด API Demo

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

ตั้งค่า Google Mobile Ads SDK ก่อนดำเนินการต่อ

RequestConfiguration

RequestConfiguration จะรวบรวมข้อมูลการกำหนดเป้าหมายที่ใช้กับคำขอโฆษณาทุกรายการทั่วโลก โปรดดูแท็กการกำหนดเป้าหมายที่ใช้ได้ใน RequestConfiguration.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

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

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

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

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

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

Java

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

Kotlin

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

ตั้งค่าการดูแลตามอายุของวัยรุ่น

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

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have teen age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have teen age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

ตั้งค่ากลุ่มทดสอบแบบไม่เฉพาะเจาะจงตามอายุ

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

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

ย้ายข้อมูลไปยังการดูแลตามอายุจาก 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 จะได้รับการดูแลเนื้อหาทั้งหมดให้มีเด็กเป็นกลุ่มเป้าหมายสำหรับคำขอโฆษณาทุกรายการโดยอัตโนมัติ

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

คำเตือน: เมธอด 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) ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ ซึ่งจะ ป้องกันการส่งตัวระบุโฆษณา (AAID)ของ Android ด้วย

• เรียก 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 จะลบล้างการตั้งค่าที่กำหนดค่าโดยใช้อินเทอร์เฟซผู้ใช้ AdMob

การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา (เบต้า)

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

หมายเหตุ: สำหรับคำขอโฆษณาที่มีสัญญาณความเป็นส่วนตัวของผู้ใช้หลายรายการ สัญญาณที่จำกัดมากที่สุด จะมีผลเหนือกว่า ดูตัวอย่างเฉพาะในเอกสารประกอบ 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