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

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

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

ตั้งค่ากลุ่มทดสอบตามอายุสำหรับเด็ก

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

Swift

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

Objective-C

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

ตั้งค่ากลุ่มทดสอบสำหรับวัยรุ่น

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

Swift

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

Objective-C

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

ตั้งค่าไม่ให้มีการดูแลตามอายุที่เฉพาะเจาะจง

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

Swift

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

Objective-C

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

ย้ายข้อมูลจากการดูแลให้เหมาะสมกับเด็ก (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

แทน

สำหรับวัตถุประสงค์ของกฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (Children’s Online Privacy Protection Act หรือ 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 แล้ว แต่ให้ตั้งค่าพร็อพเพอร์ตี้ 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 ใหม่

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

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