การสนับสนุน IAB ของสหรัฐอเมริกา

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

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

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

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

หากต้องการระบุว่าผู้ใช้มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้หรือไม่ ให้ตั้งค่า 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 เพื่อบังคับให้ SDK ของ UMP ถือว่าอุปกรณ์ทดสอบของคุณอยู่ในรัฐของสหรัฐอเมริกาที่มีการควบคุม นอกจากนี้ คุณยังใช้ UMPDebugGeographyOther เพื่อบังคับไม่ให้แสดงข้อความเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกาได้ด้วย ดูรายละเอียดเพิ่มเติมเกี่ยวกับ debugGeography ได้ที่ บังคับภูมิศาสตร์