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

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

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

หากต้องการดูการกำหนดเป้าหมายโฆษณาในการทำงานจริง ให้ดาวน์โหลดแอป iOS API Demo ใน 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 แทน

ตามวัตถุประสงค์ของ Children's Online Privacy Protection Act (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