กําหนดค่าการรวบรวมและการใช้ข้อมูล 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 เช่น

Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

Analytics.setAnalyticsCollectionEnabled(false)

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

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

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

pod 'Firebase/AnalyticsWithoutAdIdSupport'

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

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

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

Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

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

ยืนยันการตั้งค่า

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

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

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