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

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

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