คู่มือนี้อธิบายวิธีระบุข้อมูลการกำหนดเป้าหมายให้กับคำขอโฆษณา
หากต้องการดูการกำหนดเป้าหมายโฆษณาในทางปฏิบัติ ให้ดาวน์โหลดแอป iOS API Demo ใน Swift หรือ Objective-C
ข้อกำหนดเบื้องต้น
ตั้งค่า Google Mobile Ads SDK ก่อนดำเนินการต่อ
GADRequestConfiguration
GADRequestConfiguration
เป็นออบเจ็กต์ที่รวบรวมข้อมูลการกำหนดเป้าหมายเพื่อนำไปใช้ทั่วโลกผ่านอินสแตนซ์ที่ใช้ร่วมกันของ
GADMobileAds ซึ่งเข้าถึงได้ด้วยรหัสต่อไปนี้
Swift
let requestConfiguration = MobileAds.shared.requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
ตั้งค่าการกำหนดค่าคำขอก่อนเริ่มต้น Google Mobile Ads SDK เพื่อให้คำขอโฆษณาทั้งหมดใช้การเปลี่ยนแปลงการกำหนดค่าคำขอ
ตั้งค่าการดูแลตามอายุ
Google Mobile Ads SDK มีการตั้งค่าการดูแลตามอายุเพื่อช่วยคุณจัดการการปฏิบัติตามกฎระเบียบด้านความเป็นส่วนตัวที่เกี่ยวข้องกับเด็กและวัยรุ่น การตั้งค่าการดูแลตามอายุช่วยให้คุณระบุได้ว่า Google Mobile Ads SDK ควรใช้การป้องกันการแสดงโฆษณาที่เฉพาะเจาะจงสำหรับเด็ก วัยรุ่น หรือผู้ใช้ที่ไม่ระบุอายุหรือไม่
คุณตั้งค่าการดูแลตามอายุได้ด้วยพร็อพเพอร์ตี้ ageRestrictedTreatment ใน GADRequestConfiguration
ตัวอย่างต่อไปนี้ระบุว่าคำขอโฆษณาควรได้รับการดูแลตามอายุของเด็ก
Swift
// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
หากต้องการระบุการดูแลตามอายุสำหรับวัยรุ่นหรือไม่ได้ระบุ ให้แทนที่การตั้งค่า .child ด้วยค่าต่อไปนี้
.teen.unspecified
Objective-C
// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
GADAgeRestrictedTreatmentChild;
หากต้องการระบุการดูแลตามอายุสำหรับวัยรุ่นหรือไม่ได้ระบุ ให้แทนที่การตั้งค่า GADAgeRestrictedTreatmentChild ด้วยค่าต่อไปนี้
GADAgeRestrictedTreatmentTeenGADAgeRestrictedTreatmentUnspecified
เมื่อใช้การตั้งค่านี้ Google Mobile Ads SDK จะรวมพารามิเตอร์ tfat ไว้ในคำขอโฆษณา โปรดปรึกษาที่ปรึกษาด้านกฎหมายเพื่อกำหนดการดูแลตามอายุที่เหมาะสมสำหรับผู้ใช้ตามภาระหน้าที่ทางกฎหมายและกฎระเบียบ ดูข้อมูลเพิ่มเติมได้ที่ติดแท็กคำขอโฆษณาเพื่อใช้การดูแลตามอายุ
ย้ายข้อมูลจากการดูแลตาม TFCD และ TFUA ไปเป็นการดูแลตามอายุ
การตั้งค่าการดูแลตามอายุจะแทนที่พร็อพเพอร์ตี้ที่เลิกใช้งานแล้วอย่าง tagForChildDirectedTreatment (TFCD) และ tagForUnderAgeOfConsent (TFUA)
ตารางต่อไปนี้แสดงการตั้งค่า tagForChildDirectedTreatment และ tagForUnderAgeOfConsent รวมถึงการดูแลตามอายุที่เทียบเท่ากัน
TFCD
tagForChildDirectedTreatment |
กลุ่มทดสอบอายุ |
|---|---|
tagForChildDirectedTreatment = true |
GADAgeRestrictedTreatmentChild |
tagForChildDirectedTreatment = false |
GADAgeRestrictedTreatmentUnspecified |
ไม่มีการกำหนดค่าให้กับ tagForChildDirectedTreatment |
GADAgeRestrictedTreatmentUnspecified |
| ไม่มีเวอร์ชันเทียบเท่า | GADAgeRestrictedTreatmentTeen |
TFUA
tagForUnderAgeOfConsent |
กลุ่มทดสอบอายุ |
|---|---|
tagForUnderAgeOfConsent = true |
GADAgeRestrictedTreatmentChild |
tagForUnderAgeOfConsent = false |
GADAgeRestrictedTreatmentUnspecified |
ไม่มีการกำหนดค่าให้กับ tagForUnderAgeOfConsent |
GADAgeRestrictedTreatmentUnspecified |
| ไม่มีเวอร์ชันเทียบเท่า | GADAgeRestrictedTreatmentTeen |
ทำความเข้าใจการโต้ตอบของการจัดการตามอายุกับ TFCD และ TFUA
หากคุณตั้งค่าการดูแลตามอายุและค่า TFCD หรือ TFUA, Google จะใช้การดูแลที่เข้มงวดมากที่สุด
ส่งต่อการดูแลตามอายุด้วยสื่อกลาง
หากคุณตั้งค่าการดูแลตามอายุโดยใช้ Google Mobile Ads SDK อะแดปเตอร์สื่อกลางจะส่งต่อสัญญาณการดูแลตามอายุไปยัง SDK ของบุคคลที่สามที่ใช้สื่อกลาง
ตารางต่อไปนี้แสดงเวอร์ชันอะแดปเตอร์สื่อกลางที่รองรับการส่งต่อสัญญาณการดูแลที่จำกัดอายุไปยัง SDK ของบุคคลที่สามที่ใช้สื่อกลาง
| ชื่ออะแดปเตอร์สื่อกลาง | เวอร์ชันต่ำสุดที่รองรับ |
|---|---|
| AppLovin | 13.6.3.0 |
| BidMachine | 3.6.1.1 |
| Bigo | 5.2.1.0 |
| Chartboost | 9.12.0.1 |
| DTExchange (Fyber) | 8.4.7.1 |
| i-mobile | 2.3.4.7 |
| InMobi | 11.2.0.1 |
| IronSource | 9.4.1.0.1 |
| Liftoff Monetize (Vungle) | 7.7.2.1 |
| LY Ads (Line Ads) | 3.0.1.1 |
| maio | 2.2.1.2 |
| Meta (Facebook) | 6.21.1.1 |
| Mintegral | 8.1.3.1 |
| Moloco | 4.6.1.1 |
| MyTarget | 5.43.0.0 |
| Pangle | 7.9.1.1.1 |
| PubMatic | 5.1.0.1 |
| Verve | 3.8.1.1 |
การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย
เพื่อให้เป็นไปตามกฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (Children’s Online Privacy Protection Act หรือ COPPA) จึงมีการตั้งค่าที่เรียกว่า tagForChildDirectedTreatment
เมื่อมีการส่งคำขอโฆษณา ในฐานะนักพัฒนาแอป คุณระบุได้ว่าต้องการให้ Google พิจารณาเนื้อหาของคุณว่าเป็นประเภทที่เหมาะสมกับเด็กหรือไม่ก็ได้ เมื่อคุณระบุว่าต้องการให้ Google พิจารณาเนื้อหาของคุณว่าเป็นประเภทที่เหมาะสมกับเด็ก Google จะดำเนินการปิดใช้ IBA และโฆษณารีมาร์เก็ตติ้งในคำขอโฆษณานั้น ตัวเลือกการตั้งค่ามีดังนี้
- ตั้งค่า
tagForChildDirectedTreatmentเป็นtrueเพื่อระบุว่าคุณต้องการให้ระบบพิจารณาเนื้อหาของคุณว่ามีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA ซึ่งจะป้องกันการส่งตัวระบุโฆษณา (IDFA) - ตั้งค่า
tagForChildDirectedTreatmentเป็นfalseเพื่อระบุว่าคุณไม่ต้องการให้ระบบพิจารณาเนื้อหาของคุณว่าเป็นประเภทที่มีเด็กเป็นกลุ่มเป้าหมายตามกฎ COPPA - อย่าตั้งค่า
tagForChildDirectedTreatmentหากคุณไม่ต้องการระบุว่าต้องการให้ Google ปฏิบัติต่อเนื้อหาอย่างไรในส่วนที่เกี่ยวกับ COPPA
ตัวอย่างต่อไปนี้แสดงว่าคุณต้องการให้ระบบพิจารณาเนื้อหาของคุณว่ามีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA
Swift
MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;
การตั้งค่าแท็กนี้เป็นการรับรองว่าการแจ้งเตือนนี้ถูกต้อง และคุณได้รับอนุญาตให้ดำเนินการในนามของเจ้าของแอป คุณเข้าใจว่าการใช้การตั้งค่านี้ในทางที่ผิดอาจส่งผลให้มีการสิ้นสุดการใช้งานบัญชี Google ของคุณ
ผู้ใช้ที่อายุต่ำกว่าอายุที่ให้ความยินยอมได้
คุณสามารถทำเครื่องหมายคำขอโฆษณาที่ต้องการขอรับการดูแลสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ ฟีเจอร์นี้ออกแบบมาเพื่อช่วยให้ปฏิบัติตามกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ได้สะดวก คุณอาจมีภาระหน้าที่ตามกฎหมายอื่นๆ ภายใต้ GDPR โปรดอ่านคำแนะนำของสหภาพยุโรปและปรึกษากับที่ปรึกษาด้านกฎหมายของคุณ เครื่องมือของ Google ได้รับการออกแบบมาเพื่อช่วยให้ปฏิบัติตามกฎระเบียบนี้ได้สะดวกเท่านั้น แต่ไม่ได้ลดทอนภาระหน้าที่ของผู้เผยแพร่โฆษณาตามที่กฎระเบียบดังกล่าวระบุไว้แต่อย่างใด ดูข้อมูลเพิ่มเติมว่า GDPR ส่งผลต่อผู้เผยแพร่โฆษณาอย่างไร
เมื่อใช้ฟีเจอร์นี้ ระบบจะรวมพารามิเตอร์แท็กสำหรับผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ในยุโรป (TFUA) ไว้ในคำขอโฆษณาทั้งหมดในอนาคต พารามิเตอร์นี้จะปิดใช้โฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้รวมถึงรีมาร์เก็ตติ้งสำหรับคำขอโฆษณาที่เฉพาะเจาะจงนั้น ทั้งยังปิดใช้คำขอที่ส่งไปยังผู้ให้บริการโฆษณาบุคคลที่สาม เช่น พิกเซลการวัดผลโฆษณาและเซิร์ฟเวอร์โฆษณาบุคคลที่สาม
การตั้งค่านี้ใช้ได้กับ Google Mobile Ads SDK ทุกเวอร์ชันโดยตั้งค่าพร็อพเพอร์ตี้ tagForUnderAgeOfConsent ในออบเจ็กต์ GADMobileAds.requestConfiguration และส่งใน true
- ตั้งค่า
tagForUnderAgeOfConsentเป็นtrueเพื่อระบุว่าคุณต้องการให้จัดการคำขอโฆษณาในลักษณะที่เหมาะสมสำหรับผู้ใช้ที่อายุต่ำกว่าอายุที่ให้ความยินยอมได้ นอกจากนี้ยังป้องกันการส่งตัวระบุโฆษณา (IDFA) ด้วย - การไม่ตั้งค่า
tagForUnderAgeOfConsentบ่งชี้ว่าคุณไม่ต้องการให้จัดการคำขอโฆษณาในลักษณะที่เหมาะสำหรับผู้ใช้ที่อายุต่ำกว่าอายุที่ให้ความยินยอมได้
ตัวอย่างต่อไปนี้แสดงว่าคุณต้องการรวม TFUA ไว้ในคำขอโฆษณา
Swift
MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;
ไม่ควรตั้งค่าแท็กเพื่อเปิดใช้การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมายและ tagForUnderAgeOfConsent เป็น true พร้อมกัน
ในกรณีที่เป็น "true" พร้อมกัน การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมายจะมีลำดับความสำคัญเหนือกว่า
การกรองเนื้อหาโฆษณา
แอปสามารถกำหนดการจัดประเภทเนื้อหาโฆษณาสูงสุดให้กับคำขอโฆษณาทั้งหมดได้โดยใช้พร็อพเพอร์ตี้ maxAdContentRating ของ GADRequestConfiguration การตั้งค่านี้จะมีผลกับคำขอโฆษณาทั้งหมดในอนาคตสำหรับเซสชันที่เหลือ ค่าที่เป็นไปได้สำหรับพร็อพเพอร์ตี้นี้จะอิงตามการจัดประเภทป้ายกำกับเนื้อหาดิจิทัล และควรเป็นค่าคงที่ค่าใดค่าหนึ่งต่อไปนี้
GADMaxAdContentRatingGeneralGADMaxAdContentRatingParentalGuidanceGADMaxAdContentRatingTeenGADMaxAdContentRatingMatureAudience
โค้ดต่อไปนี้จะกำหนดค่าคำขอโฆษณาทั้งหมดเพื่อระบุว่าเนื้อหาโฆษณาที่แสดงควรสอดคล้องกับการกำหนดป้ายกำกับเนื้อหาดิจิทัลที่ไม่สูงกว่า GADMaxAdContentRatingGeneral
Swift
MobileAds.shared.requestConfiguration.maxAdContentRating =
GADMaxAdContentRating.general
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา (เบต้า)
API การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา (PPT) เป็นเครื่องมือที่ไม่บังคับซึ่งช่วยให้แอปสามารถระบุว่าจะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมดหรือไม่โดยใช้พร็อพเพอร์ตี้ publisherPrivacyPersonalizationState ของ GADRequestConfiguration เมื่อใช้ฟีเจอร์นี้ พารามิเตอร์การดูแลด้านความเป็นส่วนตัวของผู้เผยแพร่โฆษณา (PPT) จะรวมอยู่ในคำขอโฆษณาทั้งหมดในอนาคตสำหรับเซสชันที่เหลือ
โดยค่าเริ่มต้น คำขอโฆษณาที่ส่งไปยัง Google จะแสดงโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ โค้ดต่อไปนี้จะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมด
Swift
MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
.disabled
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
GADPublisherPrivacyPersonalizationStateDisabled;
GAMRequest
ออบเจ็กต์ GAMRequest จะรวบรวมข้อมูลการกำหนดเป้าหมายเพื่อส่งไปพร้อมกับคำขอโฆษณา
เพิ่มข้อมูลเพิ่มเติมของเครือข่าย
ข้อมูลเพิ่มเติมของเครือข่ายคือรายละเอียดเพิ่มเติมที่ส่งพร้อมกับคำขอโฆษณาซึ่งเจาะจงสำหรับแหล่งที่มาของโฆษณาแหล่งเดียว
ข้อมูลโค้ดต่อไปนี้จะตั้งค่าคีย์พารามิเตอร์เพิ่มเติมของ collapsible โดยมีค่าเป็น bottom ไปยัง Google
Swift
let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)
Objective-C
GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];
URL สำหรับเนื้อหา
เมื่อขอโฆษณา แอปจะส่ง URL ของเนื้อหาที่แสดงได้ ซึ่งจะช่วยให้การกำหนดเป้าหมายจากคีย์เวิร์ดจับคู่โฆษณากับเนื้อหาได้
ตัวอย่างเช่น หากแอปขอโฆษณาขณะแสดงเนื้อหาจาก https://www.example.com คุณสามารถส่ง URL นี้เพื่อกำหนดเป้าหมายคีย์เวิร์ดที่เกี่ยวข้องได้ ดังนี้
Swift
let request = AdManagerRequest()
request.contentURL = "https://www.example.com"
Objective-C
GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";
การกำหนดเป้าหมายเอง
เมื่อกำหนดค่าคู่คีย์-ค่าใน UI ของ Ad Manager แล้ว ให้ตั้งค่าการกำหนดเป้าหมายเองด้วยคีย์-ค่าในคำขอโฆษณา จากนั้นรายการโฆษณาที่กำหนดเป้าหมายคีย์-ค่าเหล่านั้นจะมีสิทธิ์แสดงสำหรับคำขอโฆษณาดังกล่าว หากต้องการกำหนดเป้าหมายหลายค่าสำหรับคีย์เดียว ให้ป้อนค่าเป็นสตริงที่คั่นด้วยคอมมา
Swift
let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];
Objective-C
GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};
ความปลอดภัยของแบรนด์ (เบต้า)
แอปที่แสดงเนื้อหาแบบไดนามิกซึ่งมีไว้สำหรับกลุ่มเป้าหมายที่แตกต่างกันสามารถระบุรายการ URL สั้นๆ ผ่านพร็อพเพอร์ตี้ neighboringContentURLs ได้ URL ของเนื้อหาที่อยู่ใกล้เคียงแตกต่างจากพร็อพเพอร์ตี้ contentURL ตรงที่ใช้เพื่อความปลอดภัยของแบรนด์เท่านั้น
สมมติว่าแอปแสดงเนื้อหาจาก URL 4 รายการในฟีดที่มีโฆษณาด้วย คุณสามารถขอโฆษณาที่มีการจัดประเภทเนื้อหาคล้ายกับ URL เหล่านั้นได้โดยส่ง URL ดังนี้
Swift
let request = AdManagerRequest()
request.neighboringContentURLs =
["https://www.example1.com", "https://www.example2.com",
"https://www.example3.com", "https://www.example4.com"]
Objective-C
GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
@[@"https://www.example1.com", @"https://www.example2.com",
@"https://www.example3.com", @"https://www.example4.com"];
ตัวระบุที่ผู้เผยแพร่โฆษณามีให้
คุณสามารถตั้งค่าตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) เพื่อใช้ในการกำหนดความถี่สูงสุด การแบ่งกลุ่มเป้าหมายและการกำหนดเป้าหมาย การหมุนเวียนโฆษณาตามลำดับ และการควบคุมการแสดงโฆษณาตามกลุ่มเป้าหมายแบบอื่นๆ ในทุกอุปกรณ์
การตั้งค่า PPID ทำได้ผ่าน GAMRequest ดังนี้
Swift
let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"
Objective-C
GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";
ดูตัวอย่าง PPID ของ Ad Manager สำหรับการใช้งานตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) ในแอป iOS API Demo ดังนี้
สัญญาณที่ได้จากผู้เผยแพร่โฆษณา
คุณสามารถส่งข้อมูลกลุ่มเป้าหมายและข้อมูลบริบทเป็นสัญญาณที่ได้จากผู้เผยแพร่โฆษณา (PPS) ในคำขอโฆษณาได้ PPS ช่วยให้คุณใช้ข้อมูลผู้ใช้เพื่อปรับปรุงการสร้างรายได้แบบเป็นโปรแกรมได้โดยการสื่อสารลักษณะของกลุ่มเป้าหมายกับผู้เสนอราคาในธุรกรรมทุกประเภทโดยใช้การจัดหมวดหมู่มาตรฐาน โดยไม่จำเป็นต้องแชร์ตัวระบุผู้ใช้ ลักษณะของกลุ่มเป้าหมายอาจรวมถึงข้อมูลตามพฤติกรรมและความสนใจ (การจัดหมวดหมู่กลุ่มเป้าหมายของ IAB 1.1) และข้อมูลบริบท (การจัดหมวดหมู่เนื้อหาของ IAB 2.2)
Swift
let extras = Extras()
extras.additionalParameters = [
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
"IAB_AUDIENCE_1_1": [6, 284],
// Set the content to sedan, station wagon and SUV automotive values.
"IAB_CONTENT_2_2": [4, 5, 6]
]
let request = AdManagerRequest()
request.register(extras)
Objective-C
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
@"IAB_AUDIENCE_1_1":@[@6, @284],
// Set the content to sedan, station wagon and SUV automotive values.
@"IAB_CONTENT_2_2":@[@4,@5,@6]
};
GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];
คำถามที่พบบ่อย
- ระบบจะใช้การกำหนดเป้าหมายใดเมื่อโฆษณารีเฟรชโดยอัตโนมัติ
- เมื่อรีเฟรชโฆษณา ระบบจะใช้ออบเจ็กต์
GAMRequestที่ระบุไว้ก่อนหน้านี้สำหรับการกำหนดเป้าหมายอีกครั้ง หากต้องการตั้งค่าการกำหนดเป้าหมายใหม่ ให้เรียกใช้loadRequestในGAMBannerViewอย่างชัดเจนด้วยออบเจ็กต์GAMRequestใหม่ - ฉันจะส่งพารามิเตอร์การกำหนดเป้าหมายเพิ่มเติมไปยังเครือข่ายสื่อกลางได้อย่างไร
- ดูสื่อกลางเพื่อดูวิธีส่งการกำหนดเป้าหมายไปยังเครือข่ายสื่อกลาง