สร้างโหมดความยินยอมสําหรับแอป

หน้านี้มีไว้สำหรับนักพัฒนาแอปที่ใช้ SDK ของ Google Analytics สำหรับ Firebase ในแอปและต้องการผสานรวมโหมดความยินยอม หากต้องการดูข้อมูลเบื้องต้นเกี่ยวกับโหมดความยินยอม โปรดอ่านภาพรวมของโหมดความยินยอม

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

ก่อนเริ่มต้น

คุณต้องติดตั้งใช้งานสิ่งต่อไปนี้ก่อนจึงจะจัดการความยินยอมของผู้ใช้ได้

  • SDK ของ Google Analytics สำหรับ Firebase

  • แบนเนอร์การตั้งค่าความยินยอมเพื่อบันทึกความยินยอมของผู้ใช้

สิ่งที่ต้องทำเพื่อตั้งค่าโหมดความยินยอม

  1. ตั้งค่าสถานะความยินยอมเริ่มต้น

ระบบจะไม่กำหนดค่าโหมดความยินยอมใดๆ โดยค่าเริ่มต้น วิธีตั้งค่าสถานะความยินยอมเริ่มต้นสำหรับแอป

  1. เปิดไฟล์ info.plist ของแอป

  2. เพิ่มคู่คีย์-ค่าของโหมดความยินยอม คีย์จะอธิบายประเภทความยินยอม และค่าจะระบุสถานะความยินยอม ค่าจะเป็น true ซึ่งหมายความว่าได้รับความยินยอม หรือ false ซึ่งหมายความว่าไม่ได้รับความยินยอม

    ตามการอัปเดตโหมดความยินยอมสำหรับการเข้าชมในเขตเศรษฐกิจยุโรป (EEA) คุณสามารถตั้งค่า eu_consent_policy สำหรับ ad_user_data และ ad_personalization ซึ่งหมายความว่าจะไม่ได้รับความยินยอมจากผู้ใช้ในภูมิภาคที่อยู่ภายใต้นโยบายความยินยอมของผู้ใช้ EU เท่านั้น

    ตั้งค่าต่อไปนี้

    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE
    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE
    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA
    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS

  3. บันทึกการเปลี่ยนแปลง จากนั้นติดตั้งใช้งานกลไกเพื่ออัปเดตค่าความยินยอม

ตัวอย่างวิธีตั้งค่าให้ได้รับความยินยอมสำหรับพารามิเตอร์ทั้งหมดโดยค่าเริ่มต้น

<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

หากต้องการอัปเดตค่าความยินยอมหลังจากเปิดให้บริการแอปแล้ว ให้เรียกใช้เมธอด setConsent

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

หากผู้ใช้ถอนความยินยอมที่เคยให้ไว้ก่อนหน้านี้สำหรับการจัดเก็บข้อมูลของ Analytics หรือโฆษณา Google Analytics จะลบพร็อพเพอร์ตี้ผู้ใช้ทั้งหมด รวมถึงความยินยอมสำหรับ ad_personalization หากต้องการเก็บตัวเลือกความยินยอมของผู้ใช้สำหรับการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ ให้กู้คืนค่าก่อนหน้าสำหรับการปรับโฆษณาตามโปรไฟล์ของผู้ใช้โดยใช้ setConsent (Swift | Obj-C) .

ตัวอย่างต่อไปนี้แสดงเมธอด setConsent ที่อัปเดตค่าความยินยอมต่างๆ เป็น granted

Swift

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

Objective-C

[FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

หากผู้ใช้ตัดสินใจเพิกถอนความยินยอม โปรดตรวจสอบว่าคุณได้อัปเดตสถานะความยินยอมตามนั้นแล้ว

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดตโหมดความยินยอมสำหรับการเข้าชมในเขตเศรษฐกิจยุโรป (EEA) ของ Google

ผู้ใช้โหมดความยินยอมต้องส่งพารามิเตอร์ใหม่ 2 รายการนอกเหนือจากการจัดเก็บข้อมูลโฆษณาและการจัดเก็บข้อมูลของ Analytics ดังนี้

  1. อัปเดต info.plist ของแอปให้มีสิ่งต่อไปนี้

    <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

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

    Swift

    Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])

    Objective-C

    [FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

คุณสามารถยืนยันว่าการตั้งค่าความยินยอมทำงานตามที่ต้องการโดยดูคอนโซลดีบักของ Xcode สำหรับแอป

โปรดทำตามขั้นตอนต่อไปนี้

  1. เปิดใช้การบันทึกแบบละเอียด ในอุปกรณ์

  2. ในคอนโซลดีบักของ Xcode ให้มองหาพารามิเตอร์ต่อไปนี้

    • ad_storage
    • analytics_storage
    • ad_user_data
    • ad_personalization

    ตัวอย่างเช่น หากเปิดใช้การจัดเก็บข้อมูลโฆษณา คุณจะเห็นข้อความต่อไปนี้

    ad_storage is granted.