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

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

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

ดาวน์โหลดการสาธิต API

สิ่งที่ต้องดำเนินการก่อน

ทำตามคู่มือเริ่มต้นใช้งานให้เสร็จสมบูรณ์

GADRequestConfiguration

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

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

การตั้งค่าที่เหมาะสมกับเด็ก

ตามวัตถุประสงค์ของกฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (Children’s Online Privacy Protection Act หรือ COPPA) มีการตั้งค่าที่เรียกว่า tagForChildDirectedTreatment

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

  • ตั้งค่า tagForChildDirectedTreatment เป็น true เพื่อระบุว่าคุณต้องการให้เนื้อหามีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA ซึ่งจะป้องกันการส่งตัวระบุโฆษณา หรือ IDFA
  • ตั้งค่า tagForChildDirectedTreatment เป็น false เพื่อระบุว่าคุณไม่ต้องการให้ระบบพิจารณาว่าเนื้อหาของคุณมีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA
  • อย่าตั้งค่า tagForChildDirectedTreatment หากไม่ต้องการระบุวิธีที่ต้องการให้ระบบดำเนินการกับเนื้อหาในส่วนที่เกี่ยวกับ COPPA

ตัวอย่างต่อไปนี้ระบุว่าคุณต้องการให้เนื้อหาของคุณมีการดูแลให้เหมาะสมกับเด็กตามวัตถุประสงค์ของ COPPA

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

การตั้งค่าแท็กนี้หมายความว่าคุณรับรองว่าการแจ้งเตือนนี้ถูกต้อง และได้รับสิทธิ์ให้ดำเนินการในนามของเจ้าของแอป คุณเข้าใจว่าการใช้การตั้งค่านี้ในทางที่ผิดอาจส่งผลให้บัญชี Google ของคุณสิ้นสุดลง

คุณทำเครื่องหมายให้กับคำขอโฆษณาเพื่อรับการปฏิบัติสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ ฟีเจอร์นี้ออกแบบมาเพื่อช่วยให้ปฏิบัติตามกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ได้สะดวก โปรดทราบว่าคุณอาจมีภาระหน้าที่ทางกฎหมายอื่นๆ ภายใต้ GDPR โปรดอ่านคำแนะนำของสหภาพยุโรปและปรึกษากับที่ปรึกษาด้านกฎหมายของคุณ โปรดทราบว่าเครื่องมือของ Google ได้รับการออกแบบมาเพื่อช่วยให้ปฏิบัติตามกฎระเบียบนี้ได้สะดวก แต่ไม่ได้ลดภาระหน้าที่ของผู้เผยแพร่โฆษณาที่กฎระเบียบดังกล่าวระบุไว้ ดูข้อมูลเพิ่มเติมว่า GDPR ส่งผลต่อผู้เผยแพร่โฆษณาอย่างไร

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

การตั้งค่านี้ใช้ได้กับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ทุกเวอร์ชันโดยการตั้งค่าพร็อพเพอร์ตี้ tagForUnderAgeOfConsent ในออบเจ็กต์ GADMobileAds.requestConfiguration และการส่งใน true

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

ตัวอย่างต่อไปนี้ระบุว่าคุณต้องการรวม TFUA ไว้ในคําขอโฆษณา

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

แท็กที่เปิดใช้การตั้งค่าการดูแลให้เหมาะสมกับเด็กและ tagForUnderAgeOfConsent ไม่ควรตั้งค่าเป็น true พร้อมกัน หากใช่ การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมายจะมีความสำคัญเหนือกว่า

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

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

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

URL เนื้อหา

เมื่อขอโฆษณา แอปสามารถส่ง URL ของเนื้อหาที่แสดง ซึ่งจะทำให้การกำหนดเป้าหมายจากคีย์เวิร์ดจับคู่โฆษณากับเนื้อหาได้

ตัวอย่างเช่น หากแอปขอโฆษณาขณะแสดงเนื้อหาจาก https://www.example.com คุณสามารถส่ง URL นี้เพื่อกำหนดเป้าหมายคีย์เวิร์ดที่เกี่ยวข้องได้

Swift

let request = GAMRequest()
request.contentURL = "https://www.example.com"

Objective-C

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

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

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

Swift

let request = GAMRequest()
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 เหล่านี้ใช้สำหรับความปลอดภัยของแบรนด์เท่านั้น

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

Swift

let request = GAMRequest()
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 = GAMRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

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

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

Swift Objective-C

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

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

Swift

let extras = GADExtras()
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 = GAMRequest()()
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 ใหม่
ฉันจะส่งผ่านพารามิเตอร์การกำหนดเป้าหมายเพิ่มเติมไปยังเครือข่ายสื่อกลางได้อย่างไร
โปรดดูสื่อกลางเพื่อดูวิธีส่งการกำหนดเป้าหมายไปยังเครือข่ายสื่อกลาง