Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. 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 ของแอป จากนั้นใช้วิธีการที่อธิบายด้านล่างเพื่อลบล้างการทำงานเริ่มต้นนั้น

ตัวยึด34

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

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

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

ตัวยึด37

หากต้องการเปิดใช้คุณลักษณะการโฆษณาส่วนบุคคลอีกครั้งสำหรับผู้ใช้ในเวลาทำงาน เช่น หลังจากที่ผู้ใช้ปลายทางให้ความยินยอม ให้ใช้เมธอด 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 อาจใช้เวลาสักครู่ในการปรับใช้ในแอปของคุณ หากแอปของคุณใช้งานได้ กระบวนการปรับใช้ทั้งหมดอาจใช้เวลาถึงหนึ่งชั่วโมงจึงจะเสร็จสมบูรณ์