คู่มือนี้จะอธิบายถึงวิธีระบุข้อมูลการกำหนดเป้าหมายให้กับคำขอโฆษณา สำหรับตัวอย่างที่ใช้งานได้ ให้ดาวน์โหลดแอปเดโม Android API
วิชาบังคับก่อน
- ทำตามคู่มือเริ่มต้นใช้งาน
RequestConfiguration
RequestConfiguration
เป็นออบเจ็กต์ที่รวบรวมข้อมูลการกำหนดเป้าหมายเพื่อนำไปใช้ทั่วโลกผ่านเมธอด MobileAds
แบบคงที่
หากต้องการอัปเดตการกำหนดค่าคำขอ ให้รับเครื่องมือสร้างจากการกำหนดค่าที่มีอยู่ จากนั้นดำเนินการอัปเดตที่ต้องการ แล้วตั้งค่าดังต่อไปนี้
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย
เราได้มีการตั้งค่าที่เรียกว่า "แท็กการดูแลให้เหมาะสมกับเด็ก" ตามวัตถุประสงค์ของกฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (Children’s Online Privacy Protection Act หรือ COPPA) การตั้งค่าแท็กนี้หมายความว่าคุณรับรองว่าการแจ้งเตือนนี้ถูกต้อง และได้รับสิทธิ์ให้ดำเนินการในนามของเจ้าของแอป คุณเข้าใจว่าการละเมิดการตั้งค่านี้อาจส่งผลให้บัญชี Google สิ้นสุดลง
เมื่อมีการส่งคำขอโฆษณา ในฐานะนักพัฒนาแอป คุณระบุได้ว่าต้องการให้ Google พิจารณาเนื้อหาของคุณว่าเป็นประเภทที่เหมาะสมกับเด็กหรือไม่ก็ได้ หากคุณระบุว่าต้องการให้ Google พิจารณาเนื้อหาของคุณว่ามีเด็กเป็นกลุ่มเป้าหมาย เราจะทำตามขั้นตอนเพื่อปิดใช้ IBA และโฆษณารีมาร์เก็ตติ้งในคำขอโฆษณานั้น
การตั้งค่านี้ใช้ได้กับ SDK บริการ Google Play ทุกเวอร์ชันผ่าน RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)
ดังนี้
โทรติดต่อ
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
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
ผู้ใช้ที่อายุต่ำกว่าอายุที่ให้ความยินยอมได้
คุณสามารถทำเครื่องหมายคำขอโฆษณาเพื่อรับการปฏิบัติสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ ฟีเจอร์นี้ออกแบบมาเพื่อช่วยให้ปฏิบัติตามกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ได้สะดวกยิ่งขึ้น โปรดทราบว่าคุณอาจมีภาระหน้าที่อื่นๆ ทางกฎหมายภายใต้ GDPR โปรดอ่านคำแนะนำของสหภาพยุโรปและปรึกษา ที่ปรึกษาด้านกฎหมายของคุณ โปรดทราบว่าเครื่องมือของ Google ได้รับการออกแบบมาเพื่อช่วยให้ปฏิบัติตามกฎระเบียบนี้ได้สะดวก แต่ไม่ได้ลดภาระหน้าที่ของผู้เผยแพร่โฆษณาที่กฎระเบียบดังกล่าวระบุไว้ ดูข้อมูลเพิ่มเติมว่า GDPR ส่งผลต่อผู้เผยแพร่โฆษณาอย่างไร
เมื่อใช้ฟีเจอร์นี้ พารามิเตอร์แท็กสำหรับผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ในยุโรป (TFUA) จะรวมอยู่ในคำขอโฆษณา พารามิเตอร์นี้จะปิดใช้โฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้รวมถึงรีมาร์เก็ตติ้งสำหรับคำขอโฆษณาทั้งหมด ทั้งยังปิดใช้คำขอที่ส่งไปยังผู้ให้บริการโฆษณาบุคคลที่สาม เช่น พิกเซลการวัดผลโฆษณา และเซิร์ฟเวอร์โฆษณาบุคคลที่สาม
การตั้งค่าพารามิเตอร์ TFUA จะมีวิธีการใน
RequestConfiguration.Builder
เช่นเดียวกับการตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย
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 รวมอยู่ในคำขอโฆษณา
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
แท็กเพื่อเปิดใช้การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมายและ setTagForUnderAgeOfConsent()
ไม่ควรตั้งค่าทั้ง 2 แท็กเป็น 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
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
โปรดดูข้อมูลเพิ่มเติมดังต่อไปนี้
การดูแลความเป็นส่วนตัวของผู้เผยแพร่โฆษณา (เบต้า)
การดูแลความเป็นส่วนตัวของผู้เผยแพร่โฆษณา
(PPT) API เป็นเครื่องมือเสริมที่ช่วยให้แอประบุได้ว่าจะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมดโดยใช้เมธอด setPublisherPrivacyPersonalizationState()
หรือไม่
เมื่อใช้ฟีเจอร์นี้ พารามิเตอร์การดูแลความเป็นส่วนตัวของผู้เผยแพร่โฆษณา (PPT) จะรวมอยู่ในคำขอโฆษณาในอนาคตทั้งหมดตลอดระยะเวลาที่เหลือของเซสชัน
โดยค่าเริ่มต้น คำขอโฆษณาไปยัง Google จะแสดงโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ โค้ดต่อไปนี้จะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมด
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
คำขอโฆษณา
ออบเจ็กต์ AdManagerAdRequest
จะรวบรวมข้อมูลการกำหนดเป้าหมายเพื่อส่งไปกับคำขอโฆษณา
การกำหนดเป้าหมายเอง
คุณส่งคู่คีย์-ค่าที่กำหนดเองเพื่อกำหนดเป้าหมายแคมเปญ Google Ad Manager (รายการโฆษณา) ผ่าน AdManagerAdRequest.Builder.addCustomTargeting()
ได้โดยทำดังนี้
Java
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCustomTargeting("age", "25")
.build();
Kotlin
// Example: Pass custom targeting "age=25".
var newRequest = AdManagerAdRequest.Builder()
.addCustomTargeting("age", "25")
.build()
คุณส่งผ่านค่าหลายค่าสำหรับคีย์เป็นรายการสตริงได้ เช่น กำหนดเป้าหมายเป็นบุคคลที่มีอายุระหว่าง 20 ปี แทนที่จะแค่ 25 ปี
.addCustomTargeting("age", Arrays.asList("24", "25", "26"))
ดูตัวอย่างการกำหนดเป้าหมายเองของ Ad Manager สำหรับการติดตั้งใช้งานการกำหนดเป้าหมายเองในแอปเดโม Android API
การยกเว้นหมวดหมู่
คุณเพิ่มระดับการยกเว้นหมวดหมู่ระดับช่องโฆษณาลงในคําขอได้โดยใช้เมธอด addCategoryExclusion()
ที่ AdManagerAdRequest.Builder
จัดเตรียมไว้ให้
Java
// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build();
Kotlin
// Example: Exclude "automobile" and "boat" categories.
var newRequest = AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build()
ดูตัวอย่างการยกเว้นหมวดหมู่ของ Ad Manager สำหรับการใช้งานการยกเว้นหมวดหมู่ในแอปเดโม Android API
ตัวระบุที่ผู้เผยแพร่โฆษณามีให้
คุณตั้งค่าตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) เพื่อใช้ในการกำหนดความถี่สูงสุด การแบ่งกลุ่มเป้าหมายและการกำหนดเป้าหมาย การหมุนเวียนโฆษณาตามลำดับ และการควบคุมการแสดงโฆษณาตามกลุ่มเป้าหมายแบบอื่นๆ ในทุกอุปกรณ์
ตัวอย่างการตั้งค่า PPID
Java
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build();
Kotlin
var adRequest = AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build()
ดูตัวอย่าง PPID ของ Ad Manager สำหรับการติดตั้งใช้งานตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) ในแอปเดโม Android API
สัญญาณที่ได้จากผู้เผยแพร่โฆษณา
คุณส่งกลุ่มเป้าหมายและข้อมูลบริบทเป็นสัญญาณที่ได้จากผู้เผยแพร่โฆษณา (PPS) ในคำขอโฆษณาได้ PPS ช่วยให้คุณสามารถใช้ข้อมูลผู้ใช้เพื่อปรับปรุงการสร้างรายได้แบบเป็นโปรแกรมด้วยการสื่อสารลักษณะเฉพาะของผู้ชมให้โปรแกรมเสนอราคาในประเภทธุรกรรมทุกประเภท โดยใช้การจัดหมวดหมู่มาตรฐานโดยไม่จำเป็นต้องแชร์ตัวระบุผู้ใช้ ลักษณะเฉพาะของกลุ่มเป้าหมายอาจรวมถึงข้อมูลตามพฤติกรรมและความสนใจ (การจัดหมวดหมู่กลุ่มเป้าหมายของ IAB 1.1) และข้อมูลบริบท (การจัดหมวดหมู่เนื้อหาของ IAB 2.2)
Java
Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build()
Kotlin
val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))
val request = AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
URL เนื้อหา
หากต้องการระบุ URL เนื้อหาสำหรับโฆษณาที่กำหนดเป้าหมายจากเนื้อหาและความปลอดภัยของแบรนด์ คุณสามารถเรียกใช้ setContentUrl()
เมื่อสร้าง AdManagerAdRequest
:
Java
AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();
Kotlin
val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()
ความปลอดภัยของแบรนด์ (เบต้า)
แอปพลิเคชันที่แสดงเนื้อหาแบบไดนามิกที่มีไว้สำหรับกลุ่มเป้าหมายที่แตกต่างกันสามารถระบุรายการ URL สั้นๆ ได้โดยใช้เมธอด setNeighboringContentUrls()
เมื่อสร้าง AdManagerAdRequest
ดังนี้
Java
ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
.setNeighboringContentUrls(urls)
.build();
Kotlin
var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
"https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
var requestWithContent = AdManagerAdRequest.Builder()
.setNeighboringContentUrls(urls)
.build()
.setNeighboringContentUrls()
แตกต่างจาก .setContentUrl()
ตรงที่ใช้เพื่อความปลอดภัยของแบรนด์เท่านั้น