กำหนดค่าการเก็บรวบรวมและใช้ข้อมูล 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 เช่น

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 โปรดตรวจสอบว่าเฟรมเวิร์กการสนับสนุนโฆษณาไม่รวมอยู่ในแอปของคุณ

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

pod 'Firebase/AnalyticsWithoutAdIdSupport'

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

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

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

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

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