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

เลิกใช้งานแล้ว: เราเลิกใช้งาน SDK C++ โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ในวันที่ 17 มิถุนายน 2024 และ ไม่ควรนำไปใช้ในโปรเจ็กต์ที่ยังไม่ได้ใช้ จะเข้าสู่ สิ้นสุดการบำรุงรักษา (EoM) ในวันที่ 17 มิถุนายน 2025 โปรดทราบว่า SDK เวอร์ชันที่เผยแพร่ก่อนวันที่สิ้นสุดการใช้งานจะยังคงทำงานต่อไป แต่จะไม่มีการแก้ไขข้อบกพร่องหรือการเปลี่ยนแปลงเพิ่มเติมหลังจากวันที่สิ้นสุดการใช้งาน

แทนการใช้ C++ SDK ของโฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ให้พิจารณาใช้ iOS และ SDK ของ Android จาก AdMob หากต้องการการสนับสนุน โปรดติดต่อ ฟอรัมทางเทคนิคเกี่ยวกับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

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

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

• ดำเนินการเริ่มต้นใช้งานให้เสร็จสมบูรณ์

RequestConfiguration

RequestConfiguration เป็นโครงสร้างที่รวบรวมข้อมูลการกำหนดเป้าหมายเพื่อเป็น ทั่วโลกผ่านฟังก์ชันทั่วโลกของ SetRequestConfiguration()

หากต้องการอัปเดตการกำหนดค่าคำขอ ให้รับการกำหนดค่าปัจจุบันก่อน ทำการอัปเดตที่ต้องการ และตั้งค่าดังนี้

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

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

สำหรับวัตถุประสงค์ของกฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (Children’s Online Privacy Protection Act) (COPPA) มีการตั้งค่าที่เรียกว่า "แท็กสำหรับการดูแลให้เหมาะสมกับเด็ก" โดยการตั้งค่านี้ คุณรับรองว่าการแจ้งเตือนนี้ถูกต้องและคุณได้รับอนุญาตให้ ดำเนินการในนามของเจ้าของแอป คุณเข้าใจว่าการใช้การตั้งค่านี้ในทางที่ผิด อาจส่งผลให้มีการสิ้นสุดการใช้งานบัญชี Google ของคุณ

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

การตั้งค่าสามารถกําหนดได้โดยมอบหมาย สมาชิก tag_for_child_directed_treatment ของโครงสร้าง RequestConfiguration ไปยัง ค่าที่แจกแจงค่าใดค่าหนึ่งต่อไปนี้

• มอบหมาย RequestConfiguration::tag_for_child_directed_treatment ให้ RequestConfiguration::kChildDirectedTreatmentTrue เพื่อบ่งชี้ว่าคุณต้องการ เนื้อหาของคุณที่มีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA
• กําหนด RequestConfiguration::tag_for_child_directed_treatment เป็น RequestConfiguration::kChildDirectedTreatmentFalse เพื่อระบุว่าคุณไม่ต้องการให้ระบบพิจารณาเนื้อหาของคุณเป็นประเภทที่มีเด็กเป็นกลุ่มเป้าหมายตามกฎ COPPA
• มอบหมาย RequestConfiguration::tag_for_child_directed_treatment ให้ RequestConfiguration::kChildDirectedTreatmentUnspecifiedหากไม่ต้องการ เพื่อระบุแนวทางที่คุณต้องการให้เนื้อหาดำเนินการในส่วนที่เกี่ยวข้องกับ COPPA ใน คำขอโฆษณา

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

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

หมายเหตุ: แอปในโปรแกรมออกแบบเพื่อครอบครัวที่ระบุว่าเป็นแอปที่มุ่งเน้นเด็กเป็นหลักและผู้ใช้ที่ลงชื่อเข้าใช้บัญชี Google ที่มีการจัดการด้วย Family Link จะมีระบบจัดการเนื้อหาทั้งหมด

โดยอัตโนมัติว่าเป็นเนื้อหาที่มุ่งเน้นเด็กสำหรับคำขอโฆษณาทั้งหมด

ผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้

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

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

เช่นเดียวกับการตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย จะมีสมาชิกใน RequestConfiguration สำหรับ กำลังกําหนดค่าพารามิเตอร์ TFUA: tag_for_under_age_of_consent ซึ่งอาจเป็น กำหนดค่าด้วยค่าที่แจกแจงต่อไปนี้

• มอบหมาย RequestConfiguration::tag_for_under_age_of_consent ให้ RequestConfiguration::kUnderAgeOfConsentTrue เพื่อระบุว่าต้องการให้ คำขอโฆษณาเพื่อรับการปฏิบัติสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าเกณฑ์
• กําหนด RequestConfiguration::tag_for_under_age_of_consent เป็น RequestConfiguration::kUnderAgeOfConsentFalse เพื่อระบุว่าไม่ต้องการให้คำขอโฆษณาได้รับการประมวลผลสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้
• กําหนด RequestConfiguration::tag_for_under_age_of_consent ให้กับ RequestConfiguration::kUnderAgeOfConsentUnspecified เพื่อระบุว่าคุณไม่ได้ระบุให้คำขอโฆษณาได้รับการปฏิบัติสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมหรือไม่

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

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

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

แอปสามารถกำหนดการจัดประเภทเนื้อหาโฆษณาสูงสุดสำหรับคำขอโฆษณาได้ผ่าน RequestConfiguration::max_ad_content_rating field โฆษณา AdMob แสดงผลเมื่อ กำหนดค่ารายการนี้ให้มีการจัดประเภทเนื้อหาเท่ากับหรือต่ำกว่าระดับดังกล่าว ความเป็นไปได้ ค่าสำหรับกรณีนี้ขึ้นอยู่กับการจัดประเภทป้ายกำกับเนื้อหาดิจิทัลและต้อง ค่าที่แจกแจงค่าใดค่าหนึ่งต่อไปนี้

• RequestConfiguration::kMaxAdContentRatingG
• RequestConfiguration::kMaxAdContentRatingPG
• RequestConfiguration::kMaxAdContentRatingT
• RequestConfiguration::kMaxAdContentRatingMA

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

AdRequest

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

URL เนื้อหา

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

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

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();