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

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

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

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

ดาวน์โหลดเดโม API

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

ทำตามคู่มือเริ่มต้นใช้งาน

GADRequestConfiguration

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

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

หากต้องการให้คำขอโฆษณาทั้งหมดใช้การเปลี่ยนแปลงการกำหนดค่าคำขอ ให้ตั้งค่าการกำหนดค่าคำขอก่อนที่จะเริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่

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

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