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