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

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

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

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

ดาวน์โหลด API สาธิต

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

ตั้งค่า 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
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 ซึ่งจะป้องกันการส่งตัวระบุโฆษณา (IDFA)
• ตั้งค่า tagForChildDirectedTreatment เป็น false เพื่อระบุว่าคุณไม่ต้องการให้ระบบพิจารณาเนื้อหาของคุณว่าเป็นประเภทที่มีเด็กเป็นกลุ่มเป้าหมายตามกฎ COPPA
• อย่าตั้งค่า tagForChildDirectedTreatment หากคุณไม่ต้องการระบุว่าต้องการให้ Google ปฏิบัติต่อเนื้อหาอย่างไรในส่วนที่เกี่ยวกับ COPPA

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

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

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

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

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

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

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

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

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

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

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;

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

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

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