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

iOS+ Android

หมายเหตุ: หากใช้ Unity SDK ให้เลือกตัวเลือกแพลตฟอร์มด้านบน (iOS+ หรือ Android) สำหรับเป้าหมายการสร้าง

หน้านี้อธิบายฟีเจอร์ที่ 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 ได้ ให้ใช้ ข้อกำหนดย่อยต่อไปนี้แทน pod 'FirebaseAnalytics'

pod 'FirebaseAnalytics/Core'

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

• ความเป็นส่วนตัวของผู้ใช้และการใช้ข้อมูล
• ความโปร่งใสในการติดตามแอป

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

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

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

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

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

• แนะนํา: เปิดหรือปิดใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้แบบไดนามิกโดย เคารพตัวเลือกความยินยอมของผู้ใช้ ใช้ API ของโหมดความยินยอมของ Google

• เปิดหรือปิดใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้ในระดับผู้ใช้ ควบคุมการปรับโฆษณาตามโปรไฟล์ของผู้ใช้เป็นพร็อพเพอร์ตี้ผู้ใช้

• เปิดหรือปิดใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้ที่ระดับพร็อพเพอร์ตี้ Analytics ปิดใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้ต่อภูมิภาคทางภูมิศาสตร์ในพร็อพเพอร์ตี้ Analytics

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

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

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

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

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

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

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

หมายเหตุ: หากผู้ใช้เพิกถอนความยินยอมที่ให้ไว้ก่อนหน้านี้สำหรับ Analytics หรือ Ad Storage ทาง Google Analytics จะลบล้างพร็อพเพอร์ตี้ผู้ใช้ทั้งหมด ซึ่งรวมถึงความยินยอมสำหรับ ad personalization หากต้องการรักษาตัวเลือกความยินยอมของผู้ใช้สำหรับการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ ให้คืนค่าก่อนหน้าสำหรับการปรับโฆษณาตามโปรไฟล์ของผู้ใช้โดยใช้ setConsent (Swift | Obj-C)

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

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