คู่มือนี้อธิบายวิธีระบุข้อมูลการกำหนดเป้าหมายให้กับ 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
การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย
ตามกฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (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);คำขอโฆษณา
ออบเจ็กต์
AdManagerAdRequest จะรวบรวมข้อมูลการกำหนดเป้าหมายเพื่อส่ง
ไปพร้อมกับคำขอโฆษณา
เพิ่มข้อมูลเพิ่มเติมของเครือข่าย
ข้อมูลเพิ่มเติมของเครือข่ายคือรายละเอียดเพิ่มเติมที่ส่งไปพร้อมกับคำขอโฆษณาซึ่งเฉพาะเจาะจงกับแหล่งที่มาของโฆษณาแหล่งเดียว
ข้อมูลโค้ดต่อไปนี้จะตั้งค่าคีย์พารามิเตอร์เพิ่มเติมเป็น 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);การกำหนดเป้าหมายเอง
คุณสามารถส่งคู่คีย์-ค่าที่กำหนดเองเพื่อกำหนดเป้าหมายแคมเปญ (รายการโฆษณา) ของ Google Ad Manager ได้ ตัวอย่างต่อไปนี้จะส่งคู่คีย์-ค่าที่กำหนดเองในคำขอโฆษณา
Kotlin
// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build()Java
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest =
new AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build();คุณสามารถส่งค่าหลายค่าสำหรับคีย์เป็นรายการสตริงได้ เช่น กำหนดเป้าหมายบุคคลที่มีอายุ 20 กว่าปีแทนที่จะกำหนดเป้าหมายเฉพาะบุคคลที่มีอายุ 25 ปี
Kotlin
.addCustomTargeting("age", listOf("24", "25", "26"))Java
.addCustomTargeting("age", Arrays.asList("24", "25", "26"))การยกเว้นหมวดหมู่
คุณสามารถเพิ่มระดับการยกเว้นหมวดหมู่ระดับสล็อตลงในคำขอได้โดยใช้
addCategoryExclusion()
เมธอด ดังนี้
Kotlin
// Example: Exclude "automobile" and "boat" categories.
val newRequest =
AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build()Java
// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest =
new AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build();ดูตัวอย่างการยกเว้นหมวดหมู่ของ Ad Manager เพื่อดูการใช้งานการยกเว้นหมวดหมู่ในแอป Android API เดโม
ตัวระบุที่ผู้เผยแพร่โฆษณามีให้
คุณสามารถตั้งค่าตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) เพื่อใช้กำหนดความถี่สูงสุด การแบ่งกลุ่มและกำหนดเป้าหมายผู้ชม การหมุนเวียนโฆษณาตามลำดับ และการควบคุมการแสดงโฆษณาตามกลุ่มผู้ชมแบบอื่นๆ ในทุกอุปกรณ์
ตัวอย่างการตั้งค่า PPID มีดังนี้
Kotlin
val adRequest = AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build()Java
AdManagerAdRequest adRequest =
new AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build();ดูตัวอย่าง PPID ของ Ad Manager เพื่อดูการใช้งานตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) ในแอป Android API เดโม
สัญญาณที่ได้จากผู้เผยแพร่โฆษณา
คุณสามารถส่งข้อมูลกลุ่มเป้าหมายและข้อมูลตามบริบทเป็น สัญญาณที่ได้จากผู้เผยแพร่โฆษณา (PPS) ในคำขอโฆษณาได้ PPS ช่วยให้คุณใช้ข้อมูลผู้ใช้เพื่อปรับปรุง การสร้างรายได้แบบเป็นโปรแกรมได้โดยการสื่อสารลักษณะของกลุ่มเป้าหมายกับ ผู้เสนอราคาใน ธุรกรรมทุกประเภทโดยใช้ การจัดหมวดหมู่มาตรฐาน โดยไม่จำเป็นต้องแชร์ตัวระบุผู้ใช้ ลักษณะของกลุ่มเป้าหมาย อาจรวมถึงข้อมูลตามพฤติกรรมและความสนใจ (การจัดหมวดหมู่กลุ่มเป้าหมายของ IAB เวอร์ชัน 1.1) และข้อมูลตามบริบท (การจัดหมวดหมู่เนื้อหาของ IAB เวอร์ชัน 2.2)
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 =
AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()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", new ArrayList<>(Arrays.asList(6, 284)));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", new ArrayList<>(Arrays.asList(4, 5, 6)));
AdManagerAdRequest request =
new AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();URL เนื้อหา
หากต้องการระบุ URL เนื้อหาสำหรับโฆษณาที่กำหนดเป้าหมายตามเนื้อหาและความปลอดภัยของแบรนด์ ให้เพิ่มข้อมูลต่อไปนี้
Kotlin
val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()Java
AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();ความปลอดภัยของแบรนด์ (เบต้า)
แอปพลิเคชันที่แสดงเนื้อหาแบบไดนามิกซึ่งมีไว้สำหรับกลุ่มเป้าหมายที่แตกต่างกันจะสามารถระบุรายการ URL สั้นๆ ได้ดังนี้
Kotlin
val urls =
mutableListOf(
"https://www.mycontenturl1.com",
"https://www.mycontenturl2.com",
"https://www.mycontenturl3.com",
"https://www.mycontenturl4.com",
)
val requestWithContent = AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build()Java
List<String> urls =
Arrays.asList(
"https://www.mycontenturl1.com",
"https://www.mycontenturl2.com",
"https://www.mycontenturl3.com",
"https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent =
new AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build();.setNeighboringContentUrls() แตกต่างจาก .setContentUrl() ตรงที่ใช้สำหรับความปลอดภัยของแบรนด์เท่านั้น