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

เลือกแพลตฟอร์ม: 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 นี้ไม่พร้อมใช้งานในเป้าหมาย watchOS 
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานในเป้าหมาย watchOS 
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

Swift

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานในเป้าหมาย watchOS 
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

หากคุณติดตั้งโมดูล FirebaseAnalytics ลงในแอปผ่าน SPM หรือ CocoaPods และต้องการปิดใช้การเก็บรวบรวม IDFA (ตัวระบุสำหรับการโฆษณาของอุปกรณ์) ในแอป Apple ให้ตรวจสอบว่าไม่ได้รวมเฟรมเวิร์ก AdSupport ไว้ในแอป

หากต้องการติดตั้ง Firebase โดยไม่ให้มีการเก็บรวบรวม IDFA ให้ใช้โค้ดต่อไปนี้แทนทรัพยากร Dependency FirebaseAnalytics

Swift Package Manager

  .target(
    name: "MyTargetName",
    dependencies: [
      .product(name: "FirebaseAnalyticsCore", package: "Firebase"),
      // ...
    ]
  ),

CocoaPods

pod 'FirebaseAnalytics/Core'

ดูข้อมูลเพิ่มเติมเกี่ยวกับ 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 นี้ไม่พร้อมใช้งานในเป้าหมาย watchOS 
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานในเป้าหมาย watchOS 
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Unity

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

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

Swift

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานในเป้าหมาย watchOS 
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

หมายเหตุ: ผลิตภัณฑ์ Firebase นี้ไม่พร้อมใช้งานในเป้าหมาย watchOS 
[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 ชั่วโมง