คู่มือนี้อธิบายวิธีให้ข้อมูลการกำหนดเป้าหมายแก่ Google Mobile Ads SDK
หากต้องการดูตัวอย่างที่ใช้งานได้ ให้ดาวน์โหลดแอปเดโม Android APIวิชาบังคับก่อน
ก่อนดำเนินการต่อ ให้ตั้งค่า Google Mobile Ads SDK
RequestConfiguration
RequestConfiguration
รวบรวมข้อมูลการกำหนดเป้าหมายที่ใช้กับคำขอโฆษณาทุกรายการทั่วโลก ดูแท็กการกำหนดเป้าหมายที่ใช้ได้ในเอกสารประกอบของ
RequestConfiguration.Builder
หากต้องการอัปเดตการกำหนดค่าคำขอ ให้รับเครื่องมือสร้างจากการกำหนดค่าที่มีอยู่ ทำการอัปเดตที่เลือก แล้วตั้งค่าดังนี้
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);หากต้องการให้คำขอโฆษณาทั้งหมดใช้การเปลี่ยนแปลงการกำหนดค่าคำขอ ให้ตั้งค่าการกำหนดค่าคำขอก่อนที่จะเริ่มต้น 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 จะใช้การดูแลที่เข้มงวดมากที่สุด
การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย
แทนสำหรับวัตถุประสงค์ของกฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (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)Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setTagForChildDirectedTreatment(
RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);ผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้
คุณทำเครื่องหมายให้กับคำขอโฆษณาเพื่อรับการปฏิบัติสำหรับผู้ใช้ใน เขตเศรษฐกิจยุโรป (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)Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);แท็กเพื่อเปิดใช้การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย และ setTagForUnderAgeOfConsent() ไม่ควรตั้งค่าเป็น true พร้อมกัน ในกรณีที่เป็น "true" พร้อมกัน การตั้งค่าที่ระบุว่ามีเด็กเป็นกลุ่มเป้าหมายจะมีผลเหนือกว่า
การกรองเนื้อหาโฆษณา
เพื่อให้เป็นไปตามนโยบายโฆษณาที่ไม่เหมาะสมของ Google Play ซึ่งรวมถึงข้อเสนอที่เกี่ยวข้องภายในโฆษณา โฆษณาทั้งหมดและข้อเสนอที่เกี่ยวข้อง ซึ่งแสดงภายในแอปของคุณต้องเหมาะสมกับการจัดประเภทเนื้อหาของ แอป แม้ว่าตัวเนื้อหาเองจะเป็นไปตามนโยบายของ Google Play อยู่แล้วก็ตาม
เครื่องมืออย่างการจัดประเภทเนื้อหาโฆษณาสูงสุดจะช่วยให้คุณควบคุม เนื้อหาของโฆษณาที่แสดงต่อผู้ใช้ได้มากขึ้น คุณสามารถกำหนดการจัดประเภทเนื้อหาสูงสุดได้เพื่อช่วยในการปฏิบัติตามนโยบายแพลตฟอร์ม
แอปสามารถกำหนดการจัดประเภทเนื้อหาโฆษณาสูงสุดสำหรับคำขอโฆษณาได้โดยใช้เมธอด
setMaxAdContentRating
โฆษณา AdMob ที่แสดงเมื่อมีการกำหนดค่านี้จะมีการจัดประเภทเนื้อหาที่ระดับนั้นหรือต่ำกว่า
ค่าที่เป็นไปได้สำหรับข้อมูลเพิ่มเติมของเครือข่ายนี้อิงตามการจัดประเภทป้ายกำกับเนื้อหาดิจิทัล และต้องเป็นสตริงใดสตริงหนึ่งต่อไปนี้
MAX_AD_CONTENT_RATING_GMAX_AD_CONTENT_RATING_PGMAX_AD_CONTENT_RATING_TMAX_AD_CONTENT_RATING_MA
โค้ดต่อไปนี้จะกำหนดค่าออบเจ็กต์ RequestConfiguration เพื่อระบุว่าเนื้อหาโฆษณาที่แสดงควรสอดคล้องกับการกำหนดป้ายกำกับเนื้อหาดิจิทัลไม่สูงกว่า G
Kotlin
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);โปรดดูข้อมูลเพิ่มเติมดังต่อไปนี้
การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา (เบต้า)
API การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา
(PPT) เป็นเครื่องมือที่ไม่บังคับซึ่งช่วยให้แอประบุว่าจะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมดโดยใช้วิธีการ
setPublisherPrivacyPersonalizationState()
หรือไม่ เมื่อใช้ฟีเจอร์นี้ ระบบจะรวมพารามิเตอร์การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา (PPT)
ไว้ในคำขอโฆษณาทั้งหมดในอนาคตสำหรับเซสชันที่เหลือ
โดยค่าเริ่มต้น คำขอโฆษณาไปยัง Google จะแสดงโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ โค้ดต่อไปนี้ จะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมด
Kotlin
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(
RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setPublisherPrivacyPersonalizationState(
RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);คำขอโฆษณา
ออบเจ็กต์
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)Java
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);