กําหนดค่าการรวบรวมและการใช้ข้อมูล 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 'FirebaseAnalytics' ลงใน Podfile ของแอป และต้องการปิดใช้การเก็บรวบรวม IDFA (ตัวระบุการโฆษณาของอุปกรณ์) ในแอป Apple โปรดตรวจสอบว่าเฟรมเวิร์ก AdSupport ไม่ได้รวมอยู่ในแอป

หากต้องการติดตั้ง Firebase โดยไม่สามารถใช้การเก็บรวบรวม IDFA ได้ ให้ใช้ subspec ต่อไปนี้แทน pod 'FirebaseAnalytics'

pod 'FirebaseAnalytics/Core'

ดูข้อมูลเพิ่มเติมเกี่ยวกับ 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);

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

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 ชั่วโมง