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

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

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

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

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

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

Swift

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

หากต้องการระบุการดูแลตามอายุสำหรับวัยรุ่นหรือไม่ได้ระบุ ให้แทนที่.childการตั้งค่า ด้วยการตั้งค่าต่อไปนี้

  • .teen
  • .unspecified

Objective-C

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

หากต้องการระบุการดูแลตามอายุสำหรับวัยรุ่นหรือไม่ได้ระบุ ให้แทนที่การตั้งค่า 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 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 (โฆษณา Line) 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

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

แทน

เพื่อวัตถุประสงค์ของกฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (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 ของคุณสิ้นสุดลง

แทน

คุณทำเครื่องหมายให้กับคำขอโฆษณาเพื่อรับการปฏิบัติสำหรับผู้ใช้ใน เขตเศรษฐกิจยุโรป (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 Publisher Privacy Treatment (PPT) เป็นเครื่องมือที่ไม่บังคับซึ่งช่วยให้แอประบุว่าจะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมดโดยใช้พร็อพเพอร์ตี้ publisherPrivacyPersonalizationState ของ GADRequestConfiguration หรือไม่ เมื่อใช้ฟีเจอร์นี้ ระบบจะรวมพารามิเตอร์การปฏิบัติด้านความเป็นส่วนตัวของผู้เผยแพร่โฆษณา (PPT) ไว้ในคำขอโฆษณาทั้งหมดในอนาคตสำหรับช่วงเวลาที่เหลือของเซสชัน

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

ออบเจ็กต์ GAMRequest จะรวบรวมข้อมูลการกำหนดเป้าหมายเพื่อส่งพร้อมกับคำขอโฆษณา

เพิ่มข้อมูลเพิ่มเติมของเครือข่าย

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

ข้อมูลโค้ดต่อไปนี้จะตั้งค่าคีย์พารามิเตอร์เพิ่มเติมเป็น 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 = AdManagerRequest()
request.contentURL = "https://www.example.com"

Objective-C

GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";

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

เมื่อกำหนดค่าคู่คีย์-ค่าใน UI ของ Ad Manager แล้ว ให้ตั้งค่า การกำหนดเป้าหมายที่กำหนดเองด้วยคีย์-ค่าในคำขอโฆษณา จากนั้นรายการโฆษณาที่กำหนดเป้าหมายคีย์ ค่าเหล่านั้นจะมีสิทธิ์แสดงสำหรับคำขอโฆษณาดังกล่าว หากต้องการกำหนดเป้าหมายค่าหลายค่า สำหรับคีย์เดียว ให้ป้อนค่าเป็นสตริงที่คั่นด้วยคอมมา

Swift

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective-C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

ความปลอดภัยของแบรนด์ (เบต้า)

แอปที่แสดงเนื้อหาแบบไดนามิกซึ่งมีไว้สำหรับกลุ่มเป้าหมายที่แตกต่างกันสามารถระบุ รายการ URL สั้นๆ ผ่านพร็อพเพอร์ตี้ neighboringContentURLs ได้ URL เนื้อหาที่เกี่ยวข้องแตกต่างจากพร็อพเพอร์ตี้ contentURL ตรงที่ใช้เพื่อความปลอดภัยของแบรนด์เท่านั้น

สมมติว่าแอปของคุณแสดงเนื้อหาจาก URL 4 รายการในฟีดที่มีโฆษณาด้วย คุณขอโฆษณาที่มีการจัดประเภทเนื้อหาคล้ายกับ URL เหล่านั้นได้โดย ส่ง URL ดังนี้

Swift

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective-C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

ตัวระบุที่ผู้เผยแพร่โฆษณามีให้

คุณสามารถตั้งค่าตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) เพื่อใช้ในการกำหนดความถี่สูงสุด การแบ่งกลุ่มและการกำหนดเป้าหมายผู้ชม การหมุนเวียนโฆษณาตามลำดับ และการควบคุมการแสดงโฆษณาตามกลุ่มผู้ชมแบบอื่นๆ ในทุกอุปกรณ์

การตั้งค่า PPID ทำได้ผ่าน GAMRequest โดยทำดังนี้

Swift

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

ดูตัวอย่าง PPID ของ Ad Manager เพื่อดูการใช้งานตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) ในแอปเดโม iOS API ดังนี้

Swift Objective-C

สัญญาณที่ได้จากผู้เผยแพร่โฆษณา

คุณสามารถส่งข้อมูลกลุ่มเป้าหมายและข้อมูลตามบริบทเป็นสัญญาณที่ได้จากผู้เผยแพร่โฆษณา (PPS) ในคำขอโฆษณาได้ PPS ช่วยให้คุณใช้ข้อมูลผู้ใช้เพื่อปรับปรุงการสร้างรายได้แบบเป็นโปรแกรมได้โดยการสื่อสารลักษณะกลุ่มเป้าหมายของคุณกับผู้เสนอราคาในประเภทธุรกรรมทั้งหมดโดยใช้การจัดหมวดหมู่มาตรฐานโดยไม่ต้องแชร์ตัวระบุผู้ใช้ ลักษณะกลุ่มเป้าหมายของคุณอาจรวมถึงข้อมูลตามพฤติกรรมและความสนใจ ( การจัดหมวดหมู่กลุ่มเป้าหมายของ IAB 1.1) และ ข้อมูลตามบริบท ( การจัดหมวดหมู่เนื้อหาของ IAB 2.2)

Swift

let extras = Extras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = AdManagerRequest()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

คำถามที่พบบ่อย

ระบบใช้การกำหนดเป้าหมายใดเมื่อโฆษณารีเฟรชโดยอัตโนมัติ
เมื่อโฆษณารีเฟรช ระบบจะใช้ออบเจ็กต์ GAMRequest ที่ระบุไว้ก่อนหน้านี้เพื่อกำหนดเป้าหมายอีกครั้ง หากต้องการกำหนดเป้าหมายใหม่ ให้เรียกใช้ loadRequest ใน GAMBannerView อย่างชัดเจนด้วยออบเจ็กต์ GAMRequest ใหม่
ฉันจะส่งพารามิเตอร์การกำหนดเป้าหมายเพิ่มเติมไปยังเครือข่ายสื่อกลางได้อย่างไร
ดูสื่อกลางเพื่อดูวิธีส่งการกำหนดเป้าหมายไปยัง เครือข่ายสื่อกลาง