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

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

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

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

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

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

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

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

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

การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา (เบต้า)

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

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

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