เปิดเผยต่อผู้ใช้ในสหรัฐอเมริกา

คู่มือนี้จะอธิบายขั้นตอนที่จำเป็นในการรองรับข้อความเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกาซึ่งเป็นส่วนหนึ่งของ UMP SDK ใช้คำแนะนำเหล่านี้ร่วมกับตั้งค่า UMP SDK ซึ่งจะอธิบายวิธีทำให้แอปทำงานด้วย UMP SDK และตั้งค่าข้อความ คำแนะนำต่อไปนี้มีไว้สำหรับข้อความเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกาโดยเฉพาะ

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

โปรดตรวจสอบว่าคุณได้ดำเนินการต่อไปนี้ก่อนดำเนินการต่อ

  • อัปเดตเป็น UMP SDK เวอร์ชันล่าสุด สำหรับการรองรับการรับส่งข้อความเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกา เราขอแนะนำให้คุณใช้เวอร์ชัน 2.1.0 ขึ้นไป
  • ตั้งค่า UMP SDK อย่าลืมติดตั้งใช้งานจุดแรกเข้าของตัวเลือกความเป็นส่วนตัวและแสดงผลหากจำเป็น เมื่อทำตามคู่มือนี้จนเสร็จสมบูรณ์ คุณจะมีจุดแรกเข้าเพื่อแสดงข้อความเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกาต่อผู้ใช้
  • สร้างข้อความเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกาสำหรับแอป
  • หากคุณใช้ข้อความเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริการ่วมกับข้อความอื่นๆ โปรดดูประเภทข้อความสำหรับผู้ใช้ที่ใช้ได้เพื่อทำความเข้าใจว่าระบบจะแสดงข้อความต่างๆ ต่อผู้ใช้เมื่อใด

หากต้องการระบุว่าผู้ใช้มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้หรือไม่ ให้ตั้งค่า setTagForUnderAgeOfConsent (TFUA) เมื่อคุณตั้งค่า TFUA เป็น true, UMP SDK จะไม่ขอความยินยอมจากผู้ใช้ หากแอปมีกลุ่มเป้าหมายทั้งเด็กและผู้ใหญ่ ให้ตั้งค่าพารามิเตอร์นี้สำหรับผู้ใช้ที่เป็นเด็กเพื่อให้แน่ใจว่าระบบจะไม่ขอความยินยอม คุณมีหน้าที่รับผิดชอบในการตั้งค่าพารามิเตอร์นี้เมื่อจำเป็น เพื่อให้เป็นไปตามข้อกำหนด COPPA และกฎระเบียบอื่นๆ ที่เกี่ยวข้อง

ตัวอย่างต่อไปนี้ตั้งค่า TFUA เป็น "จริง" ในคำขอความยินยอมของ UMP

Java

ConsentRequestParameters params = new ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build();

consentInformation = UserMessagingPlatform.getConsentInformation(this);
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    (OnConsentInfoUpdateSuccessListener) () -> {
      // ...
    },
    (OnConsentInfoUpdateFailureListener) requestConsentError -> {
      // ...
    });

Kotlin

val params = ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build()

consentInformation = UserMessagingPlatform.getConsentInformation(this)
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    ConsentInformation.OnConsentInfoUpdateSuccessListener {
      // ...
    },
    ConsentInformation.OnConsentInfoUpdateFailureListener {
      requestConsentError ->
      // ...
    })

หลังจากที่ผู้ใช้ตัดสินใจเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกาแล้ว คุณสามารถอ่านตัวเลือกของผู้ใช้จากพื้นที่เก็บข้อมูลในเครื่องตามข้อกำหนดของ Global Privacy Platform (GPP) ดูรายละเอียดเพิ่มเติมได้ที่รายละเอียดแอป โปรดทราบว่า UMP SDK จะป้อนเฉพาะคีย์ IABGPP_GppSID และ IABGPP_HDR_GppString

ทดสอบการรับส่งข้อความเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกา

หากต้องการทดสอบการรับส่งข้อความเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกา ให้ใช้UMPDebugGeographyRegulatedUSState debugGeography เพื่อบังคับให้ UMP SDK ถือว่าอุปกรณ์ทดสอบของคุณอยู่ในรัฐที่มีการควบคุมในสหรัฐอเมริกา นอกจากนี้ คุณยังใช้ UMPDebugGeographyOther เพื่อบังคับให้ระงับข้อความเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกาได้ด้วย ดูรายละเอียดเพิ่มเติมเกี่ยวกับ debugGeography ได้ที่หัวข้อบังคับใช้ภูมิศาสตร์ หมายเหตุ: UMPDebugGeographyRegulatedUSState ใช้ได้เฉพาะใน UMP เวอร์ชัน 3.1.0 ขึ้นไป