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

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

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

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

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

Swift

// Indicate that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child

Objective-C

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

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

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

Swift

// Indicate that ad requests should have teenage treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .teen

Objective-C

// Indicate that ad requests should have teenage treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentTeen;

ตั้งค่ากลุ่มทดสอบแบบไม่เฉพาะเจาะจงตามอายุ

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

Swift

// Indicate that ad requests should have unspecified age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .unspecified

Objective-C

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

ย้ายข้อมูลไปยังการดูแลตามอายุจาก 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 จะใช้การดูแลที่เข้มงวดที่สุด

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

กฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (COPPA) มีการตั้งค่าที่เรียกว่า Children's Online Privacy Protection Act (COPPA), there is a setting called 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 ของคุณสิ้นสุดลง

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

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

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

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

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

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;

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