DMA同意バナーの表示
มีผลตั้งแต่วันที่ 6 มีนาคม 2024 เพื่อเป็นไปตามข้อกำหนด DMA ที่บังคับใช้ในภูมิภาค EU และ EEA Google ต้องการความยินยอมจากผู้ใช้โดยชัดแจ้งเมื่อมีการส่งข้อมูลการโฆษณา/การวัดผลไปยัง Google ผ่าน Firebase หรือเครื่องมือการกำหนดการตลาดในภูมิภาคเหล่านี้
ผู้รักษาประตูเช่น Alphabet, Amazon, Apple, ByteDance, Meta และ Microsoft ต้องได้รับความยินยอมอย่างชัดเจนจากผู้ใช้เมื่อรวบรวมข้อมูลส่วนบุคคลเพื่อให้บริการโฆษณาที่ปรับให้เหมาะสม
เพื่อจัดการกับเรื่องนี้, SDK ของ Hive มีฟีเจอร์ การแสดงแบนเนอร์การยินยอม DMA เพื่อสนับสนุนการปฏิบัติตาม 'นโยบายการยินยอมของผู้ใช้ในสหภาพยุโรป' ของ Google.
เมื่อฟีเจอร์ การแสดงแบนเนอร์การยินยอม DMA ถูกนำไปใช้ คุณสามารถแสดงแบนเนอร์ที่ตรวจสอบความยินยอมของผู้ใช้สำหรับการเก็บข้อมูลส่วนบุคคลเพื่อวัตถุประสงค์ในการโฆษณาและการวัดผล
กระบวนการทำงานพื้นฐาน¶
เมื่อการเก็บข้อมูลส่วนบุคคลต้องได้รับความยินยอมในการใช้งานแอปของคุณ จะเริ่มดำเนินการตั้งแต่ ขั้นตอนที่ 3 ของการดำเนินการ SDK ดังต่อไปนี้
- แสดงเงื่อนไขการให้ความยินยอมในระหว่างการเริ่มต้น SDK และการเข้าสู่ระบบ
- แสดงป๊อปอัพการให้ความยินยอม CMP เช่น ADIZ
- เรียก
Analytics.showConsentModeIfRequire()เพื่อแสดง UI การเก็บข้อมูลส่วนบุคคลตามเงื่อนไข- หากผู้ใช้ได้ให้ความยินยอมแล้ว UI แบนเนอร์การให้ความยินยอมจะไม่แสดง มันจะแสดงเฉพาะเมื่อความยินยอมหมดอายุหรือจำเป็นต้องมีการให้ความยินยอมเพิ่มเติม
- เมื่อพารามิเตอร์วัตถุ
[ConsentMode]ถูกตั้งค่าเป็น null รายการความยินยอมจะถูกสร้างขึ้นโดยอัตโนมัติตามว่ามีการเพิ่มเครื่องมือการติดตามการตลาดของบุคคลที่สามลงใน SDK ของ Hive หรือไม่
- เรียก
Analytics.showConsentMode()เพื่อแสดง UI การเก็บข้อมูลส่วนบุคคลเสมอ- หากมีบันทึกการให้ความยินยอมก่อนหน้านี้ UI จะแสดงตามค่าที่ตั้งไว้
- ปุ่มการตั้งค่าในแอปสามารถกำหนดค่าได้เพื่อให้ผู้ใช้สามารถให้ความยินยอมอีกครั้งหรือเช็คสถานะความยินยอมได้ตลอดเวลา
- เมื่อพารามิเตอร์วัตถุ
[ConsentMode]ถูกตั้งค่าเป็น null รายการความยินยอมจะถูกสร้างขึ้นโดยอัตโนมัติตามว่ามีการเพิ่มเครื่องมือการติดตามการตลาดของบุคคลที่สามลงใน SDK ของ Hive หรือไม่
การแสดง UI แบนเนอร์การยินยอม¶
SDK ของ Hive มีฟังก์ชันการแสดง UI แบนเนอร์การยินยอมผ่านวัตถุคลาส ContentMode ของ Hive Analytics.
การกำหนดค่าหน้าจอแบนเนอร์การยินยอมจะแบ่งออกเป็น 'หน้าจอแบนเนอร์การยินยอมเริ่มต้น' และ 'หน้าจอแบนเนอร์การยินยอมแบบกำหนดเอง' ตามการตั้งค่าพารามิเตอร์ฟังก์ชันของวัตถุ ContentMode .
- UI แบนเนอร์การยินยอมเริ่มต้น: รวม UI และข้อความที่จัดเตรียมโดย SDK โดยค่าเริ่มต้น
- UI แบนเนอร์การยินยอมแบบกำหนดเอง: รวม UI และข้อความที่สามารถปรับเปลี่ยนได้ตามลักษณะของแอปของคุณ
การกำหนดค่าหน้าต่างการยินยอมเริ่มต้น¶
เมื่อพารามิเตอร์วัตถุ [ConsentMode] ถูกตั้งค่าเป็น null รายการ 'การยินยอมเริ่มต้น' ต่อไปนี้จะถูกสร้างขึ้นโดยอัตโนมัติตามว่ามีเครื่องมือการติดตามการตลาดของบุคคลที่สามถูกเพิ่มลงใน SDK หรือไม่
เมื่อผู้ใช้เสร็จสิ้นการเก็บรวบรวมข้อมูลส่วนบุคคลในแอป จะมีการส่งผลการยินยอมสำหรับแต่ละรายการผ่านการเรียกกลับจาก SDK ของ Hive
ค่าที่ส่งผ่านการเรียกกลับจะถูกจัดเตรียมเป็นรายการของวัตถุ ConsentStatus .
id: รหัสประจำตัวที่ไม่ซ้ำกันสำหรับรายการความยินยอม- วัตถุประสงค์
ad_user_data,ad_personalization,analytics_storage - ผู้ให้บริการ MMP แต่ละรายสำหรับวัตถุประสงค์
ad_personalization:google,adjust,appsflyer,singular,airbridge
- วัตถุประสงค์
granted: สถานะความยินยอมสำหรับรายการความยินยอมAnalytics.CONSENT_GRANTEDเมื่อได้รับความยินยอม,Analytics.CONSENT_DENIEDเมื่อถูกปฏิเสธ
consentDate: เวลาที่ผู้ใช้ตัดสินใจเกี่ยวกับความยินยอม (เป็นมิลลิวินาที)expiredDate: เวลาที่ความยินยอมหมดอายุ (เป็นมิลลิวินาที)
การกำหนดค่าหน้าต่างการยินยอมที่กำหนดเอง¶
แตกต่างจากหน้าต่างการยินยอมเริ่มต้นที่ให้โดย Hive SDK ซึ่งรวมถึง UI และข้อความที่สามารถปรับแต่งให้ตรงกับลักษณะของแอปของคุณ ป้อนข้อความที่แก้ไขแล้วซึ่งตรงกับแต่ละพารามิเตอร์ที่ให้โดยวัตถุ [ContentMode] ตามที่แสดงด้านล่าง.
ConsentMode.title: ข้อความที่แสดงที่ด้านบนของแบนเนอร์การยินยอมConsentMode.companyName: เมื่อแสดงข้อมูลพื้นฐาน ชื่อบริษัทจะต้องระบุและตั้งค่าในชื่อและเนื้อหาของ ConsentForm พร้อมกับชื่อConsentMode.privacyPolicy: URL ที่ทำงานเมื่อปุ่ม 'นโยบายความเป็นส่วนตัว' ที่ด้านล่างของแบนเนอร์การยินยอมถูกกดConsentMode.adUserData: รายการการยินยอมสำหรับการใช้ข้อมูลผู้ใช้โฆษณา (ad_user_data)ConsentMode.adPersonalization: รายการการยินยอมสำหรับการใช้โฆษณาที่ปรับให้เหมาะสม (ad_personalized)ConsentMode.analyticsStorage: รายการการยินยอมสำหรับการเก็บรวบรวมข้อมูลการวิเคราะห์และสถิติ (analytics_storage). (ปัจจุบันรองรับ "Google" เท่านั้น)ConsentForm.id: รหัสประจำตัวที่ไม่ซ้ำกันสำหรับรายการการยินยอม สามารถรวมวัตถุประสงค์ (ad_user_data, ad_personalization, analytics_storage) และผู้ขาย MMP แต่ละรายสำหรับวัตถุประสงค์การปรับให้เหมาะสมโฆษณา ("google", "adjust", "appsflyer", "singular", "airbridge")ConsentForm.title: ข้อความชื่อสำหรับรายการการยินยอมConsentForm.content: ข้อความคำอธิบายสำหรับรายการการยินยอมConsentStatus.id: รหัสประจำตัวที่ไม่ซ้ำกันสำหรับรายการการยินยอม อ้างอิงถึงเนื้อหา ConsentForm.idConsentStatus.granted: ค่าคสถานะการยินยอมสำหรับรายการการยินยอม Analytics.CONSENT_GRANTED เมื่อได้รับการยินยอม, Analytics.CONSENT_DENIED เมื่อถูกปฏิเสธ
การรวมเข้ากับแพลตฟอร์มการจัดการความยินยอมของบุคคลที่สาม (CMP)¶
เมื่อแสดงป๊อปอัปแบนเนอร์ความยินยอม คุณสามารถกำหนดค่าเพื่อหลีกเลี่ยงการแสดง UI แบนเนอร์ความยินยอมซ้ำกับแพลตฟอร์มการจัดการความยินยอมของบุคคลที่สาม (CMP) โดยการใช้ไฟล์ที่ปฏิบัติตามมาตรฐาน TCF
เมื่อเรียกใช้ Analytics.showConsentModeIfRequire() โดยตั้งค่าพารามิเตอร์ checkCmp เป็นจริง หากมีไฟล์ที่จัดเก็บตามมาตรฐาน TCF ไฟล์นั้นจะถูกอ่านและถือว่ามีการกำหนดความยินยอมแล้ว ค่าดีฟอลต์สำหรับพารามิเตอร์ checkCmp คือจริง
ตัวอย่างเช่น เมื่อใช้ ADIZ คุณสามารถเข้าถึงคอนโซล Google AdMob เพื่อสร้างข้อความ GDPR และจากนั้นเริ่มต้น ADIZ สำหรับข้อมูลการกำหนดค่าที่ละเอียด โปรดดูที่ Hive ADIZ > การสร้างข้อความ GDPR。
การกำหนดค่าการแสดงแบนเนอร์การยินยอม¶
ส่วนนี้อธิบายวิธีการกำหนดค่าการแสดงแบนเนอร์การยินยอมในสภาพแวดล้อมการพัฒนาสำหรับแต่ละเอนจิน Hive SDK.
Hive SDK Unity¶
- เปิดหน้าต่าง Hive Dependencies จากเมนูด้านบนของโปรเจกต์ Unity Hive > Hive Dependencies.
- ตรวจสอบและบันทึกตัวเลือก Analytics Consent-Mode ตามที่แสดงด้านล่างเพื่อเปิดใช้งานมัน.

Hive SDK Android¶
ประกาศไลบรารี 'Analytics Consent-Mode' ในไฟล์ build.gradle ระดับแอป
implementation "com.com2us.android.hive:hive-analytics-consent-mode:${HIVE_SDK_VERSION}" // Enter Hive SDK version when not using BoM
Hive SDK iOS¶
ประกาศเฟรมเวิร์ก 'Analytics Consent-Mode' ใน Podfile.
pod 'HiveAnalyticsConsentMode', '${HIVE_SDK_VERSION}' # Enter SDK version
