แสดงแบนเนอร์ความยินยอมในการวิเคราะห์

ในภูมิภาคสหภาพยุโรปและ EEA กฎระเบียบ DMA ด้านล่างนี้มีผลบังคับใช้ตั้งแต่วันที่ 6 มีนาคม 2024

ผู้เฝ้าประตู เช่น Alphabet, Amazon, Apple, ByteDance, Meta และ Microsoft ต้องได้รับความยินยอมอย่างชัดแจ้งจากผู้ใช้เมื่อรวบรวมข้อมูลส่วนบุคคลเพื่อจัดทำโฆษณาที่ปรับแต่งเอง

ดังนั้น หากคุณส่งข้อมูลไปยัง Google ผ่าน Firebase หรือเครื่องมือระบุแหล่งที่มาทางการตลาดในภูมิภาค EU และ EEA คุณต้องได้รับความยินยอมในการให้ข้อมูลจากผู้ใช้ในภูมิภาคเหล่านั้น

Hive SDK มีฟีเจอร์การแสดงแบนเนอร์การยินยอมที่ช่วยให้คุณตรวจสอบว่าคุณยินยอมต่อการเก็บรวบรวมข้อมูลส่วนบุคคลหรือไม่

กระบวนการทำงานพื้นฐาน¶

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

1. ข้อตกลงและเงื่อนไขที่แสดงระหว่างการเริ่มต้น SDK และการเข้าสู่ระบบ
2. การแสดงป๊อปอัปการยินยอม CMP เช่น ADIZ
3. แสดง UI การเก็บข้อมูลส่วนบุคคลตามเงื่อนไขโดยการเรียกใช้ Analytics.showConsentModeIfRequire() - หากผู้ใช้ได้ให้ความยินยอมแล้ว แบนเนอร์การยินยอมจะไม่แสดงและจะแสดงเฉพาะเมื่อหมดเวลา หรือเมื่อมีความจำเป็นต้องขอความยินยอมเพิ่มเติม
4. โดยการเรียกใช้ Analytics.showConsentMode() UI สำหรับการเก็บข้อมูลส่วนบุคคลจะถูกแสดงเสมอ
   - หากมีการให้ความยินยอมก่อนหน้านี้ UI จะถูกแสดงพร้อมกับสถานะการยินยอมที่ตั้งค่าตามค่า - เมื่อพารามิเตอร์วัตถุ [ConsentMode] ถูกตั้งค่าเป็น null, Hive SDK จะสร้างรายการการยินยอมโดยอัตโนมัติตามว่ามีเครื่องมือการติดตามการตลาดจากบุคคลที่สามถูกเพิ่มเข้ามาหรือไม่ - ปุ่มตั้งค่าสามารถกำหนดค่าได้ภายในแอปเพื่อให้ผู้ใช้สามารถให้ความยินยอมใหม่ได้ตลอดเวลาและตรวจสอบสถานะการยินยอมของ SDK Hive จากบุคคลที่สาม

การเปิดเผย UI แบนเนอร์การยินยอม¶

Hive SDK ให้ฟีเจอร์การแสดง UI แบนเนอร์การยินยอมผ่านอ็อบเจ็กต์คลาส ContentMode ของ Analytics.

การตั้งค่า UI แบนเนอร์การยินยอมจะแบ่งออกเป็น ‘UI แบนเนอร์การยินยอมเริ่มต้น’ และ ‘UI แบนเนอร์การยินยอมแบบกำหนดเอง’ ขึ้นอยู่กับการตั้งค่าพารามิเตอร์ฟังก์ชันของวัตถุ ContentMode.

• UI แบนเนอร์การยินยอมเริ่มต้น: รวม UI และข้อความที่จัดเตรียมไว้ตามค่าเริ่มต้นใน SDK
• UI แบนเนอร์การยินยอมแบบกำหนดเอง: รวม UI และข้อความที่สามารถปรับเปลี่ยนได้เพื่อให้เหมาะสมกับบุคลิกของแอปผู้ใช้

การตั้งค่า UI แบนเนอร์ความยินยอมเริ่มต้น¶

หากคุณป้อนพารามิเตอร์วัตถุ [ConsentMode] เป็น null รายการความยินยอมพื้นฐานด้านล่างจะถูกสร้างขึ้นโดยอัตโนมัติตามว่ามีหรือไม่มีเครื่องมือการติดตามการตลาดของบุคคลที่สามที่ใช้ใน Hive SDK ถูกเพิ่มเข้ามา

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

• [ConsentMode.ConsentForm.providerName]: * "main": รายการที่ตกลงกันทั่วไป * "google", "adjust", "appsflyer", "singular" "airbridge: รายการผู้ให้บริการที่รวมอยู่ในแบนเนอร์การยินยอมเริ่มต้น

การตั้งค่า UI แบนเนอร์การยินยอมที่กำหนดเอง¶

แตกต่างจาก UI แบนเนอร์การยินยอมพื้นฐานที่จัดเตรียมโดย Hive SDK มันรวม UI และข้อความที่ตรงกับบุคลิกของแอปของผู้ใช้ กรุณาใส่ข้อความการแก้ไขที่แมพไปยังแต่ละพารามิเตอร์ที่จัดเตรียมโดย [ContentMode] อ็อบเจ็กต์ตามที่แสดงด้านล่าง

• ConsentMode.title: ข้อความที่แสดงที่ด้านบนของแบนเนอร์การยินยอม
• ConsentMode.companyName: เมื่อเปิดเผยเป็นข้อมูลพื้นฐาน ชื่อบริษัทจะถูกตั้งค่าใน dataUsageDescription ของ mainForm พร้อมกับชื่อเรื่องที่จำเป็น
• ConsentMode.privacyPolicy: นี่คือ URL ที่ทำงานเมื่อคุณคลิกปุ่ม ‘นโยบายความเป็นส่วนตัว’ ที่ด้านล่างของแบนเนอร์การยินยอม
• ConsentMode.mainForm: กำหนดเป็นรายการการยินยอมเริ่มต้น หากคุณไม่เห็นด้วยกับ mainForm คุณไม่สามารถยินยอมต่อรายการอื่นได้
• ConsentMode.formList: รายการการยินยอมสำหรับแต่ละบริษัทในการแชร์ข้อมูลส่วนบุคคล
• ConsentForm.providerName: ชื่อผู้ให้บริการที่ตรงกับหัวข้อการยินยอม หากตั้งค่าเป็น "main" การตั้งค่าจะแสดงเหมือนกับการตั้งค่า ConsentMode.mainForm
• ConsentForm.dataUsageTitle: ข้อความชื่อเรื่องเกี่ยวกับการแชร์ข้อมูลอุปกรณ์กับ providerName
• ConsentForm.dataUsageDescription: รายละเอียดของ dataUsageTitle
• ConsentForm.personalizationTitle: วลีชื่อเรื่องที่เห็นด้วยในการให้ข้อมูลโฆษณาที่ปรับแต่ง
• ConsentForm.personalizationDescription: รายละเอียดของ personalizationTitle
• ConsentStatus.providerName: ชื่อผู้ให้บริการที่ตรงกับหัวข้อการยินยอม หากไม่ได้ตั้งค่าแยกต่างหาก จะมีการตั้งค่าเป็นหนึ่งใน "main", * "google", "adjust", "appsflyer", "singular" "airbridge"
• ConsentStatus.consentForDataUsage: ว่าจะแชร์ข้อมูลอุปกรณ์กับ [providerName] หรือไม่ ขึ้นอยู่กับการยินยอมของผู้ใช้ ค่าจะถูกตั้งเป็น [Analytics.CONSENT_GRANTED] หรือ [Analytics.CONSENT_DENIED] หากไม่มีการตั้งค่าสำหรับครั้งแรก จะเป็น "not-set" หรือสตริงว่าง
• ConsentStatus.consentForPersonalization: ว่าจะแชร์ข้อมูลโฆษณาที่ปรับแต่งกับ [providerName] หรือไม่ ขึ้นอยู่กับการยินยอมของผู้ใช้ ค่าจะถูกตั้งเป็น [Analytics.CONSENT_GRANTED] หรือ [Analytics.CONSENT_DENIED] หากไม่มีการตั้งค่าสำหรับครั้งแรก จะเป็น "not-set" หรือสตริงว่าง

รวมเข้ากับแพลตฟอร์มการจัดการความยินยอมของบุคคลที่สาม (CMP)¶

โดยการใช้ไฟล์ที่สอดคล้องกับมาตรฐาน TCF ซึ่งถูกสร้างขึ้นเมื่อแสดงป๊อปอัพแบนเนอร์การยินยอม คุณสามารถตั้งค่าให้ UI แบนเนอร์การยินยอมไม่ถูกเปิดเผยซ้ำซ้อนกับแพลตฟอร์มการจัดการการยินยอมของบุคคลที่สาม (CMP)

เมื่อเรียกใช้ Analytics.showConsentModeIfRequire() หากพารามิเตอร์ checkCmp เป็นจริง หากมีไฟล์ที่บันทึกตามมาตรฐาน TCF ไฟล์จะถูกอ่านและบริษัทในไฟล์จะเห็นด้วยกับการตั้งค่า จะถือว่าตามนั้น ค่าเริ่มต้นของพารามิเตอร์ checkCmp คือจริง

ตัวอย่างเช่น หากคุณใช้ Adiz คุณสามารถเข้าถึงคอนโซล Google AdMob สร้างข้อความ GDPR และจากนั้นลองรีเซ็ต Adiz

เพื่อหลีกเลี่ยงการแสดงแบนเนอร์การยินยอมซ้ำใน CMP ให้ดำเนินการตั้งค่าพันธมิตรตามลำดับต่อไปนี้ ตั้งค่าบริษัทที่ต้องการการยินยอมก่อนที่จะตั้งค่าเป็นพันธมิตร สำหรับรายละเอียดเกี่ยวกับการตั้งค่า โปรดดูที่ HIVE ADIZ > การสร้างข้อความ GDPR

1. คลิก ความเป็นส่วนตัว & ข้อความ ในเมนูด้านซ้าย.- - ในเมนูข้อบังคับของยุโรป คลิกที่ ‘GDPR’ การตั้งค่า จากนั้นกรอกข้อความของคุณและไปที่หน้าที่คุณสามารถตั้งค่าบริษัทคู่ค้าได้.

   ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump\_파트너-설정\_1.png){width="700"px}
   

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

   ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump\_파트너-설정\_2.png){width="700"px}
   
   ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump\_파트너-설정\_3.png){width="700"px}
   

3. ตรวจสอบชื่อบริษัทที่ต้องการความยินยอม (รายการพันธมิตรไม่มีฟังก์ชันการค้นหา ดังนั้นจึงสะดวกในการค้นหาด้วย Ctrl+F.)

4. ต้องการความยินยอมจาก AppsFlyer → ตรวจสอบ Appsflyer<

5. ปรับความยินยอมที่ต้องการ → ตรวจสอบ Adjust GmbH

6. ต้องการความยินยอมแบบเอกพจน์ → ตรวจสอบ Singular Labs Inc. * ※ Google ถูกเลือกโดยอัตโนมัติ * ※ Airbridge ไม่ได้ถูกระบุว่าเป็นพันธมิตรในขณะนี้

   ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump_파트너-설정_4.png){width="700px"}
   

7. หลังจากบันทึกแล้ว คุณจะเห็นว่าบริษัทพันธมิตรที่เลือกไว้ปรากฏในรายการ

   ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump_파트너-설정_5.png){width="450px"}
   

การตั้งค่า Hive แบนเนอร์การยินยอมการวิเคราะห์ SDK¶

อธิบายวิธีการตั้งค่าการแสดงแบนเนอร์การยินยอมการวิเคราะห์ในสภาพแวดล้อมการพัฒนา SDK ของ Hive

Hive SDK Unity¶

1. เปิดหน้าต่าง Hive Dependencies จาก Hive > Hive Dependencies ในเมนูด้านบนของโปรเจกต์ Unity
2. เปิดใช้งานตัวเลือก Analytics Consent-Mode โดยการทำเครื่องหมายและบันทึกตามที่แสดงด้านล่าง

Hive SDK Android เนทีฟ¶

ประกาศไลบรารี 'Analytics Consent-Mode' ใน build.gradle ที่ระดับแอป

implementation "com.com2us.android.hive:hive-analytics-consent-mode:${HIVE_SDK_VERSION}" // Enter SDK version if not using BoM

Hive SDK iOS native¶

ประกาศกรอบ 'Analytics Consent-Mode' ใน Podfile ของคุณ.

pod 'HiveAnalyticsConsentMode', '${HIVE_SDK_VERSION}' # Enter SDK version