Catch up on highlights from Firebase at Google I/O 2023. Learn more

กำหนดค่าการเก็บรวบรวมข้อมูลและการใช้งานของ Analytics

Google Analytics มีคุณลักษณะที่ช่วยให้คุณควบคุมการรวบรวมและการใช้ข้อมูล Analytics

ปิดใช้งานการรวบรวมข้อมูล Analytics

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

ปิดการรวบรวมชั่วคราว

หากคุณต้องการปิดใช้งานการรวบรวม Analytics ชั่วคราว เช่น ขอความยินยอมจากผู้ใช้ปลายทางก่อนที่จะรวบรวมข้อมูล คุณสามารถตั้งค่า FIREBASE_ANALYTICS_COLLECTION_ENABLED เป็น NO (บูลีน) ในไฟล์ Info.plist ของแอป ตัวอย่างเช่น ดูใน XML ต้นทาง:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key>
<false/>

หากต้องการเปิดใช้การรวบรวมอีกครั้ง เช่น หลังจากที่ผู้ใช้ปลายทางให้ความยินยอม ให้เรียกเมธอดอินสแตนซ์ setAnalyticsCollectionEnabled ของ Analytics ตัวอย่างเช่น:

สวิฟต์

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS
Analytics.setAnalyticsCollectionEnabled(true)

วัตถุประสงค์-C

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

หากต้องการระงับการเรียกเก็บอีกครั้งไม่ว่าด้วยเหตุผลใดๆ ก็ตาม คุณสามารถโทร

สวิฟต์

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS
Analytics.setAnalyticsCollectionEnabled(false)

วัตถุประสงค์-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

และการรวบรวมจะถูกระงับจนกว่าคุณจะเปิดใช้งานอีกครั้ง ค่าที่กำหนดโดยเมธอด setAnalyticsCollectionEnabled ยังคงมีอยู่ในการดำเนินการของแอป และแทนที่ค่าสำหรับ FIREBASE_ANALYTICS_COLLECTION_ENABLED ในไฟล์ Info.plist ของแอป เมื่อคุณตั้งค่าสำหรับ setAnalyticsCollectionEnabled แล้ว คอลเลกชัน Analytics จะยังคงอยู่ในสถานะนั้นจนกว่าจะเรียก setAnalyticsCollectionEnabled อีกครั้ง แม้ว่าผู้ใช้จะปิดและเปิดแอปของคุณใหม่อีกครั้ง

ปิดใช้งานคอลเลกชันอย่างถาวร

หากคุณต้องการปิดใช้งานคอลเลกชัน Analytics อย่างถาวรในเวอร์ชันของแอป ให้ตั้งค่า FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED เป็น YES (Boolean) ใน Info.plist file ของแอป การตั้งค่า FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED เป็น YES (Boolean) มีความสำคัญเหนือค่าใดๆ สำหรับ FIREBASE_ANALYTICS_COLLECTION_ENABLED ใน Info.plist ของแอป รวมถึงค่าใดๆ ที่กำหนดด้วย setAnalyticsCollectionEnabled

หากต้องการเปิดใช้งานการรวบรวมอีกครั้ง ให้ลบ FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED ออกจาก Info.plist ของคุณ การตั้งค่า FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED เป็น NO (บูลีน) จะไม่มีผลกระทบและให้ผลลัพธ์ในลักษณะเดียวกับที่ไม่ได้ตั้งค่า FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED ในไฟล์ Info.plist ของคุณ

ปิดใช้งานการรวบรวม IDFA

หากคุณติดตั้ง Firebase ผ่าน CocoaPods โดยเพิ่ม pod 'Firebase/Analytics' ลงใน Podfile ของแอปและต้องการปิดใช้การรวบรวม IDFA (ตัวระบุโฆษณาของอุปกรณ์) ในแอป Apple ของคุณ ตรวจสอบให้แน่ใจว่าเฟรมเวิร์ก AdSupport ไม่ได้รวมอยู่ในแอปของคุณ

หากต้องการติดตั้ง Firebase โดยไม่มีความสามารถในการรวบรวม IDFA ให้ใช้ข้อมูลจำเพาะย่อยต่อไปนี้แทน pod 'Firebase/Analytics' :

pod 'Firebase/AnalyticsWithoutAdIdSupport'

เรียนรู้เพิ่มเติมเกี่ยวกับ IDFA ในเอกสารประกอบของ Apple:

ปิดใช้งานการรวบรวม IDFV

หากคุณต้องการปิดใช้งานการรวบรวม IDFV (ตัวระบุสำหรับผู้ขาย) ในแอป Apple ให้ตั้งค่า GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED เป็น NO (บูลีน) ในไฟล์ Info.plist ของแอป

กำหนดค่าการใช้ข้อมูล Analytics

ปิดใช้งานคุณสมบัติการโฆษณาส่วนบุคคล

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

หากต้องการควบคุมทางโปรแกรมว่าควรใช้ข้อมูล Analytics ของผู้ใช้สำหรับการโฆษณาที่ปรับให้เหมาะกับแต่ละบุคคลหรือไม่ ให้ตั้งค่าลักษณะการทำงานเริ่มต้นที่เหมาะสมในไฟล์ AndroidManifest.xml ของแอป จากนั้นใช้วิธีการที่อธิบายด้านล่างเพื่อลบล้างการทำงานเริ่มต้นนั้น

หากต้องการตั้งค่าพฤติกรรมการโฆษณาส่วนบุคคลเริ่มต้น ให้ตั้งค่า GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS เป็น NO (บูลีน) ในไฟล์ Info.plist ของแอป

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

เปิดใช้คุณลักษณะการโฆษณาส่วนบุคคลอีกครั้ง

หากต้องการเปิดใช้คุณลักษณะการโฆษณาส่วนบุคคลอีกครั้งสำหรับผู้ใช้ในเวลาทำงาน เช่น หลังจากที่ผู้ใช้ปลายทางให้ความยินยอม ให้ใช้เมธอด setUserProperty ดังที่แสดงด้านล่าง:

สวิฟต์

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

วัตถุประสงค์-C

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

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

สวิฟต์

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

วัตถุประสงค์-C

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

ยืนยันการตั้งค่าของคุณ

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

ดูการเปลี่ยนแปลงการกำหนดค่าของคุณ

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