กําหนดค่าการรวบรวมและการใช้ข้อมูล 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 ให้ใช้โค้ดต่อไปนี้แทนการพึ่งพา 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 ชั่วโมง