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



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

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

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

ปิดใช้การรวบรวมข้อมูลชั่วคราว

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

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

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

Swift

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

Objective-C

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

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

Swift

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

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

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

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

หากต้องการปิดใช้งานการรวบรวมข้อมูลของ Analytics อย่างถาวรในเวอร์ชัน โปรดตั้งค่า FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED เป็น YES (บูลีน) ใน Info.plist ของแอป กำลังตั้งค่า FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED เป็น YES (บูลีน) มีลำดับความสำคัญเหนือทุกค่าสำหรับ 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 ของแอป

ควบคุมการเก็บรวบรวมข้อมูลสําหรับโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้

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

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

ปิดใช้ฟีเจอร์โฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ผ่านพร็อพเพอร์ตี้ผู้ใช้

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

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

หากต้องการปิดใช้ลักษณะการทำงานของโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้โดยค่าเริ่มต้น ให้กำหนดค่า GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS ถึง NO (บูลีน) ในไฟล์ Info.plist ของแอป

เปิดใช้ฟีเจอร์โฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้อีกครั้งผ่านพร็อพเพอร์ตี้ผู้ใช้

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

Swift

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

Objective-C

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

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

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

Swift

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

Objective-C

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

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

ยืนยันการตั้งค่า

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

ดูการเปลี่ยนแปลงการกําหนดค่า

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