การสนับสนุน 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 เท่านั้น

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

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