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

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

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

คู่มือนี้อธิบายวิธีให้ข้อมูลการกำหนดเป้าหมายแก่ 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() โดยใช้ API RequestConfiguration.Builder

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

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 จะใช้การดูแลที่เข้มงวดมากที่สุด

ส่งต่อการดูแลตามอายุด้วยสื่อกลาง 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

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

เพื่อวัตถุประสงค์ของกฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (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

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

แทน

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

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

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

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

คำขอโฆษณา

ออบเจ็กต์ 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