การกำหนดเป้าหมาย

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

คู่มือนี้อธิบายวิธีระบุข้อมูลการกำหนดเป้าหมายให้กับคำขอโฆษณา

หากต้องการดูการกำหนดเป้าหมายโฆษณาในการทำงานจริง ให้ดาวน์โหลดแอปเดโม iOS API ใน Swift หรือ Objective-C

ดาวน์โหลด API Demo

ข้อกำหนดเบื้องต้น

ตั้งค่า 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 การตั้งค่าการดูแลตามอายุช่วยให้คุณระบุได้ว่า Google Mobile Ads SDK ควรใช้ การป้องกันการแสดงโฆษณาที่เฉพาะเจาะจงสำหรับเด็ก วัยรุ่น หรืออายุที่ไม่ได้ระบุหรือไม่

คุณสามารถตั้งค่าการดูแลตามอายุด้วยพร็อพเพอร์ตี้ ageRestrictedTreatment ใน GADRequestConfiguration

ตัวอย่างต่อไปนี้ระบุว่าคำขอโฆษณาควรได้รับการดูแลตามอายุของเด็ก

Swift

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

หากต้องการระบุการดูแลตามอายุของวัยรุ่นหรืออายุที่ไม่ได้ระบุ ให้แทนที่การตั้งค่า .child ด้วยการตั้งค่าต่อไปนี้

• .teen
• .unspecified

Objective-C

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;
RequestConfigurationSnippets.m

หากต้องการระบุการดูแลตามอายุของวัยรุ่นหรืออายุที่ไม่ได้ระบุ ให้แทนที่การตั้งค่า GADAgeRestrictedTreatmentChild ด้วยการตั้งค่าต่อไปนี้

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

เมื่อใช้การตั้งค่านี้ 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 ที่จัดการด้วย Family Link จะมีเนื้อหาทั้งหมดได้รับการดูแลให้มีเด็กเป็นกลุ่มเป้าหมายโดยอัตโนมัติสำหรับคำขอโฆษณาทั้งหมด

ส่งต่อการดูแลตามอายุด้วยสื่อกลาง AdMob

หากคุณตั้งค่าการดูแลตามอายุโดยใช้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

การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย

คำเตือน: พร็อพเพอร์ตี้ tagForChildDirectedTreatment เลิกใช้งานแล้ว ให้ตั้งค่าพร็อพเพอร์ตี้ ageRestrictedTreatment แทน

ตามวัตถุประสงค์ของ กฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (COPPA), มีการตั้งค่าที่เรียกว่า tagForChildDirectedTreatment

เมื่อมีการส่งคำขอโฆษณา ในฐานะนักพัฒนาแอป คุณระบุได้ว่าต้องการให้ Google พิจารณาเนื้อหาของคุณว่าเป็นประเภทที่มีเด็กเป็นกลุ่มเป้าหมายหรือไม่ก็ได้ เมื่อคุณระบุว่าต้องการให้ Google พิจารณาเนื้อหาของคุณว่าเป็นประเภทที่มีเด็กเป็นกลุ่มเป้าหมาย Google จะทำตามขั้นตอนเพื่อปิดใช้ IBA และโฆษณารีมาร์เก็ตติ้งในคำขอโฆษณานั้น ตัวเลือกการตั้งค่ามีดังนี้

• ตั้งค่า tagForChildDirectedTreatment เป็น true เพื่อระบุว่าต้องการให้ระบบพิจารณาเนื้อหาของคุณว่าเป็นประเภทที่มีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA ซึ่งจะป้องกันการส่งตัวระบุโฆษณา (Advertising Identifier) หรือ IDFA
• ตั้งค่า tagForChildDirectedTreatment เป็น false เพื่อระบุว่าไม่ต้องการให้ระบบพิจารณาเนื้อหาของคุณว่าเป็นประเภทที่มีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA
• อย่าตั้งค่า tagForChildDirectedTreatment หากไม่ต้องการระบุวิธีที่ต้องการให้ระบบพิจารณาเนื้อหาของคุณตาม COPPA

ตัวอย่างต่อไปนี้ระบุว่าคุณต้องการให้ระบบพิจารณาเนื้อหาของคุณว่าเป็นประเภทที่มีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

การตั้งค่าแท็กนี้ถือเป็นการรับรองว่าการแจ้งเตือนนี้ถูกต้องและคุณได้รับอนุญาตให้ดำเนินการในนามของเจ้าของแอป คุณเข้าใจว่าการนำการตั้งค่านี้ไปใช้ในทางที่ผิดอาจส่งผลให้บัญชี Google ของคุณสิ้นสุดลง

ผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้

คำเตือน: พร็อพเพอร์ตี้ tagForUnderAgeOfConsent เลิกใช้งานแล้ว ให้ตั้งค่าพร็อพเพอร์ตี้ set the ageRestrictedTreatment แทน

คุณทำเครื่องหมายให้กับคำขอโฆษณาเพื่อรับการปฏิบัติสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ยินยอมได้ ฟีเจอร์นี้ ออกแบบมาเพื่อช่วยให้ปฏิบัติตามกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR)ได้สะดวก คุณอาจมีภาระหน้าที่ทางกฎหมายอื่นๆ ภายใต้ GDPR โปรดอ่านหลักเกณฑ์ของสหภาพยุโรปและปรึกษาที่ปรึกษาทางกฎหมาย เครื่องมือของ Google ได้รับการออกแบบมาเพื่อช่วยให้ปฏิบัติตามกฎระเบียบนี้ได้สะดวกเท่านั้น แต่ไม่ได้ลดทอนภาระหน้าที่ของผู้เผยแพร่โฆษณาตามที่กฎระเบียบดังกล่าวระบุไว้แต่อย่างใด ดูข้อมูลเพิ่มเติมเพื่อให้เข้าใจว่า GDPR ส่งผลต่อ ผู้เผยแพร่โฆษณาอย่างไร

เมื่อใช้ฟีเจอร์นี้ ระบบจะรวมพารามิเตอร์แท็กสำหรับผู้ใช้ในยุโรปที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ (TFUA) ไว้ในคำขอโฆษณาทั้งหมดในอนาคต พารามิเตอร์นี้จะปิดใช้โฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้รวมถึงรีมาร์เก็ตติ้งสำหรับคำขอโฆษณาที่เฉพาะเจาะจงนั้น ทั้งยังปิดใช้คำขอที่ส่งไปยังผู้ให้บริการโฆษณาบุคคลที่สาม เช่น พิกเซลการวัดผลโฆษณา และเซิร์ฟเวอร์โฆษณาบุคคลที่สาม

คุณสามารถใช้การตั้งค่านี้กับ Google Mobile Ads SDK ทุกเวอร์ชันได้โดย ตั้งค่า tagForUnderAgeOfConsent พร็อพเพอร์ตี้ใน GADMobileAds.requestConfiguration ออบเจ็กต์และส่งค่า true

• ตั้งค่า tagForUnderAgeOfConsent เป็น true เพื่อระบุว่าต้องการให้จัดการคำขอโฆษณาในลักษณะที่เหมาะสมกับผู้ใช้ที่มีอายุต่ำกว่าอายุที่ยินยอมได้ นอกจากนี้ยังป้องกันการส่งตัวระบุโฆษณา (Advertising Identifier) หรือ IDFA
• การไม่ตั้งค่า tagForUnderAgeOfConsent จะบ่งบอกว่าคุณไม่ต้องการให้จัดการคำขอโฆษณาในลักษณะที่เหมาะสมกับผู้ใช้ที่มีอายุต่ำกว่าอายุที่ยินยอมได้

ตัวอย่างต่อไปนี้ระบุว่าคุณต้องการให้รวม TFUA ไว้ในคำขอโฆษณา

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

แท็กเพื่อเปิดใช้การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย และ ไม่ควรตั้งค่าเป็น tagForUnderAgeOfConsent พร้อมกันtrue ในกรณีที่เป็น "true" พร้อมกัน การตั้งค่ามีเด็กเป็นกลุ่มเป้าหมายจะมีผลเหนือกว่า

ประเด็นสำคัญ: ระบบ tagForUnderAgeOfConsent _จะไม่_ ส่งต่อพารามิเตอร์นี้ไปยัง อะแดปเตอร์สื่อกลางสำหรับแหล่งที่มาของโฆษณาบุคคลที่สาม คุณมีหน้าที่รับผิดชอบในการตรวจสอบว่าเครือข่ายโฆษณาของบุคคลที่สามแต่ละเครือข่ายในแอปของคุณแสดงโฆษณาที่เหมาะสมกับผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ตาม GDPR

การกรองเนื้อหาโฆษณา

แอปสามารถกำหนดการจัดประเภทเนื้อหาโฆษณาสูงสุดสำหรับคำขอโฆษณาทั้งหมดได้โดยใช้พร็อพเพอร์ตี้ maxAdContentRating ของ GADRequestConfiguration การตั้งค่านี้จะมีผลกับคำขอโฆษณาทั้งหมดในอนาคตสำหรับเซสชันที่เหลือ ค่าที่เป็นไปได้ สำหรับพร็อพเพอร์ตี้นี้อิงตามการจัดประเภทป้ายกำกับเนื้อหาดิจิทัลและควรเป็นค่าคงที่ค่าใดค่าหนึ่งต่อไปนี้

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

โค้ดต่อไปนี้กำหนดค่าคำขอโฆษณาทั้งหมดเพื่อระบุว่าเนื้อหาโฆษณาที่แสดงควรสอดคล้องกับการกำหนดป้ายกำกับเนื้อหาดิจิทัลที่ไม่สูงกว่า GADMaxAdContentRatingGeneral

**ประเด็นสำคัญ:** การตั้งค่าตัวกรองการจัดประเภทเนื้อหาที่ระบุผ่าน SDK จะลบล้าง การตั้งค่าที่กำหนดค่าโดยใช้อินเทอร์เฟซผู้ใช้ AdMob

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment (เบต้า)

Publisher Privacy Treatment (PPT) API เป็นเครื่องมือที่ไม่บังคับซึ่งช่วยให้แอประบุได้ว่าจะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมดหรือไม่ โดยใช้พร็อพเพอร์ตี้ publisherPrivacyPersonalizationState ของ GADRequestConfiguration เมื่อใช้ฟีเจอร์นี้ ระบบจะรวมพารามิเตอร์ Publisher Privacy Treatment (PPT) ไว้ในคำขอโฆษณาทั้งหมดในอนาคตสำหรับเซสชันที่เหลือ

โดยค่าเริ่มต้น คำขอโฆษณาที่ส่งไปยัง Google จะแสดงโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ โค้ดต่อไปนี้จะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมด

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

หมายเหตุ: สำหรับคำขอโฆษณาที่มีสัญญาณด้านความเป็นส่วนตัวของผู้ใช้หลายรายการ สัญญาณที่จำกัดสิทธิ์มากที่สุด จะมีลำดับความสำคัญสูงกว่า ดูตัวอย่างเฉพาะได้ในเอกสารประกอบ Publisher Privacy Treatment API

GADRequest

ออบเจ็กต์ GADRequest จะรวบรวมข้อมูลการกำหนดเป้าหมายเพื่อส่งไปพร้อมกับคำขอโฆษณา

เพิ่มข้อมูลเพิ่มเติมของเครือข่าย

ข้อมูลเพิ่มเติมของเครือข่ายคือรายละเอียดเพิ่มเติมที่ส่งไปพร้อมกับคำขอโฆษณาซึ่งเฉพาะเจาะจงกับแหล่งที่มาของโฆษณาแหล่งเดียว

ข้อมูลโค้ดต่อไปนี้จะตั้งค่าคีย์พารามิเตอร์พิเศษเป็น 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 = Request()
request.contentURL = "https://www.example.com"

Objective-C

GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";

คำถามที่พบบ่อย

ระบบใช้การกำหนดเป้าหมายใดเมื่อโฆษณารีเฟรชโดยอัตโนมัติ

เมื่อโฆษณารีเฟรช ระบบจะใช้ออบเจ็กต์ GADRequest ที่ระบุก่อนหน้านี้เพื่อกำหนดเป้าหมายอีกครั้ง หากต้องการตั้งค่าการกำหนดเป้าหมายใหม่ ให้เรียกใช้ loadRequest ใน GADBannerView อย่างชัดเจนด้วยออบเจ็กต์ GADRequest ใหม่

ฉันจะส่งพารามิเตอร์การกำหนดเป้าหมายเพิ่มเติมไปยังเครือข่ายสื่อกลางได้อย่างไร

ดูวิธีส่งการกำหนดเป้าหมายไปยัง เครือข่ายสื่อกลางได้ที่Mediation