แท็ก Push Permission Status

Push Permission Status คือแท็กเริ่มต้นที่จัดเก็บสถานะสิทธิ์การแจ้งเตือนแบบพุชบนอุปกรณ์ ใช้แท็กนี้เพื่อสร้างเซกเมนต์ตามความสามารถในการเข้าถึงของผู้ใช้ที่แฟล็กเปิด/ปิดธรรมดาแยกไม่ได้ เช่น ผู้ใช้ที่คุณยังขอสิทธิ์ได้ และผู้ใช้ที่ปฏิเสธไปแล้ว

ค่าของ Push Permission Status

แท็กนี้เป็นแท็กประเภท String ที่จัดเก็บค่าใดค่าหนึ่งด้านล่างสำหรับแต่ละอุปกรณ์ในแต่ละแอปพลิเคชัน แต่ละแพลตฟอร์มรายงานเพียงบางค่าเท่านั้น ดูค่าที่แต่ละแพลตฟอร์มรายงาน

ค่า	ความหมาย
`not_determined`	ผู้ใช้ยังไม่ได้ตอบหน้าต่างขออนุญาต แอปจึงยังขอได้
`granted_explicit`	ผู้ใช้อนุญาตการแจ้งเตือนในหน้าต่างขออนุญาต
`granted_default`	อนุญาตการแจ้งเตือนแล้ว แต่ไม่ได้มาจากการตอบหน้าต่างขออนุญาตของ Pushwoosh SDK เฉพาะ Android
`provisional`	อนุญาตการแจ้งเตือนแบบชั่วคราว การแจ้งเตือนจะเข้าไปยังศูนย์การแจ้งเตือนแบบเงียบ โดยไม่มีการแจ้งเตือนแบบป๊อปอัป เสียง หรือแบนเนอร์ เฉพาะ iOS
`ephemeral`	อนุญาตการแจ้งเตือนในระยะเวลาจำกัด เช่น สำหรับ App Clip เฉพาะ iOS
`denied`	ผู้ใช้ปิดการแจ้งเตือน ไม่ว่าจะในหน้าต่างขออนุญาตหรือภายหลังในการตั้งค่าอุปกรณ์หรือเบราว์เซอร์
`unsupported`	เบราว์เซอร์ไม่สามารถรับการแจ้งเตือนแบบพุชบนเว็บได้ เฉพาะ Web

แท็กนี้ไม่มีค่าบน tvOS และ macOS และบนอุปกรณ์ที่ใช้ SDK เวอร์ชันเก่ากว่า:

แพลตฟอร์ม	SDK เวอร์ชันขั้นต่ำ
iOS	7.2.10
Android	6.17.0
Web	3.95.0

เมื่อใดที่แท็กอัปเดต

SDK จะรายงานสถานะปัจจุบันในช่วงเวลาต่อไปนี้:

ทุกครั้งที่เปิดแอป
เมื่ออุปกรณ์ลงทะเบียนรับการแจ้งเตือนแบบพุช
ทันทีหลังจากผู้ใช้ตอบหน้าต่างขออนุญาต

หากผู้ใช้เปลี่ยนสิทธิ์ในการตั้งค่าอุปกรณ์หรือเบราว์เซอร์ แท็กจะอัปเดตในภายหลัง ขึ้นอยู่กับแพลตฟอร์ม:

แพลตฟอร์ม	เมื่อใดที่แท็กอัปเดต
iOS	ครั้งถัดไปที่เปิดแอป
Android	ครั้งถัดไปที่เปิดแอปหรือแอปกลับมาทำงานเบื้องหน้า
Web: เบราว์เซอร์ที่ใช้ Chromium และ Firefox	ทันทีที่เบราว์เซอร์รายงานการเปลี่ยนแปลง
Web: Safari	เมื่อโหลดหน้าครั้งถัดไป

เมื่อคำขอเข้ามาโดยไม่มีสถานะ เช่น จาก SDK เวอร์ชันเก่า แท็กจะคงค่าล่าสุดไว้

ค่าที่แต่ละแพลตฟอร์มรายงาน

แต่ละแพลตฟอร์มอ่านสิทธิ์จาก API ของระบบตัวเอง ชุดค่าจึงแตกต่างกันไปตามแพลตฟอร์ม

iOS

iOS SDK จับคู่สถานะการอนุญาตของระบบสำหรับแอปเข้ากับแท็กโดยตรง

สถานะการอนุญาตของ iOS	Push Permission Status
Not determined	`not_determined`
Authorized	`granted_explicit`
Provisional	`provisional`
Ephemeral	`ephemeral`
Denied	`denied`

Android

Android 13 ขึ้นไปกำหนดให้ผู้ใช้อนุญาตการแจ้งเตือนในหน้าต่างขออนุญาต เวอร์ชันก่อนหน้าจะอนุญาตการแจ้งเตือนโดยค่าเริ่มต้นหลังติดตั้ง Android SDK จึงแยกการตอบรับอย่างชัดแจ้งออกจากการอนุญาตโดยค่าเริ่มต้น:

granted_explicit: ผู้ใช้อนุญาตการแจ้งเตือนในหน้าต่างขออนุญาตที่ Pushwoosh SDK แสดง บน Android 13 ขึ้นไป ในแอปที่กำหนดเป้าหมายเป็น Android 13 (API level 33) ขึ้นไป
granted_default: อนุญาตการแจ้งเตือนด้วยวิธีอื่นใดก็ตาม ซึ่งรวมถึง Android 12 และเก่ากว่า แอปที่กำหนดเป้าหมาย API level ต่ำกว่า 33 สิทธิ์ที่ได้รับอนุญาตอยู่แล้วเมื่อ SDK ตรวจสอบครั้งแรก และสิทธิ์ที่อนุญาตจากหน้าต่างขออนุญาตของคุณเองหรือจากการตั้งค่าระบบ
not_determined: บน Android 13 ขึ้นไป การแจ้งเตือนปิดอยู่และผู้ใช้ยังไม่ได้ตอบหน้าต่างขออนุญาต รวมถึงกรณีที่ผู้ใช้ปิดหน้าต่างโดยไม่ได้เลือก
denied: การแจ้งเตือนปิดอยู่หลังจากผู้ใช้ปฏิเสธหน้าต่างขออนุญาต หรือหลังจากที่เคยอนุญาตไว้ก่อนหน้า บน Android 12 และเก่ากว่า อุปกรณ์ใดก็ตามที่ปิดการแจ้งเตือนจะรายงาน denied

Web

เบราว์เซอร์อนุญาตการแจ้งเตือนหลังจากผู้ใช้คลิกอนุญาตเท่านั้น อุปกรณ์เว็บจึงไม่เคยรายงาน granted_default

สิทธิ์ของเบราว์เซอร์	Push Permission Status
ยังไม่เคยขอ (`default`)	`not_determined`
อนุญาต (`granted`)	`granted_explicit`
บล็อก (`denied`)	`denied`
เบราว์เซอร์ไม่รองรับพุชบนเว็บ	`unsupported`

สร้างเซกเมนต์ตามความสามารถในการเข้าถึง

รวมค่าต่างๆ ไว้ในตัวกรอง Push Permission Status ตัวเดียวด้วยโอเปอเรเตอร์ เป็นหนึ่งใน เพื่อกำหนดเป้าหมายผู้ใช้ตามวิธีที่คุณเข้าถึงพวกเขาได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างเซกเมนต์ตามแท็ก

เซกเมนต์	ตัวกรอง	วิธีใช้
ผู้ใช้ที่เห็นการแจ้งเตือนแบบพุช	เป็นหนึ่งใน `granted_explicit`, `granted_default`	ส่งการแจ้งเตือนแบบพุชที่เร่งด่วนตามเวลา
ส่งแบบเงียบเท่านั้น	เป็นหนึ่งใน `provisional`, `ephemeral`	คาดว่าการมองเห็นจะต่ำกว่า และเชิญผู้ใช้กลุ่มนี้ให้อนุญาตการแจ้งเตือนแบบเต็ม
ผู้ใช้ที่คุณยังขอสิทธิ์ได้	เป็นหนึ่งใน `not_determined`	แสดง In-App ก่อนหน้าต่างขออนุญาตพุช
ผู้ใช้ที่ปฏิเสธ	เป็นหนึ่งใน `denied`	เข้าถึงพวกเขาผ่านอีเมล SMS หรือข้อความ In-App หรือใช้ป๊อปอัปเพื่อกู้คืนผู้ใช้ที่เลือกไม่รับการแจ้งเตือน
เบราว์เซอร์ที่ไม่รองรับพุชบนเว็บ	เป็นหนึ่งใน `unsupported`	ใช้ช่องทางอื่นสำหรับผู้ใช้เว็บกลุ่มนี้

หากต้องการค้นหาอุปกรณ์ที่ยังไม่รายงานแท็กนี้ ให้ใช้โอเปอเรเตอร์ ไม่ได้ตั้งค่า อุปกรณ์เหล่านี้ใช้ SDK เวอร์ชันเก่า จึงควรกำหนดเป้าหมายด้วย Push Alerts Enabled แทน สำหรับความแตกต่างระหว่างสองแท็กนี้ ดู Push Permission Status กับ Push Alerts Enabled

Push Permission Status กับ Push Alerts Enabled

สองแท็กนี้ตอบคำถามที่แตกต่างกัน:

Push Alerts Enabled (Boolean): อุปกรณ์นี้แสดงการแจ้งเตือนแบบพุชได้ในตอนนี้หรือไม่
Push Permission Status (String): สิทธิ์อยู่ในสถานะใด แท็กนี้แยกสถานะที่ Push Alerts Enabled รายงานเป็น false เหมือนกัน เช่น ยังไม่เคยขอ และปฏิเสธแล้ว

ตารางนี้เปรียบเทียบวิธีที่สองแท็กรายงานสถานะทั่วไป

	Push Alerts Enabled	Push Permission Status
ประเภท	Boolean	String
ยังไม่เคยขอสิทธิ์	`false`	`not_determined`
ปฏิเสธสิทธิ์	`false`	`denied`
สิทธิ์ชั่วคราวหรือจำกัดเวลาบน iOS	ขึ้นอยู่กับการตั้งค่าการแจ้งเตือนแบบป๊อปอัป เสียง และ badge	`provisional` หรือ `ephemeral`
การอนุญาตอย่างชัดแจ้งหรือโดยค่าเริ่มต้น	`true` เมื่ออุปกรณ์แสดงการแจ้งเตือน	`granted_explicit` หรือ `granted_default`
อุปกรณ์ที่ใช้ SDK เวอร์ชันเก่า	รายงานในทุกเวอร์ชันของ SDK	ไม่ได้ตั้งค่า

เลือกแท็กตามคำถามที่คุณต้องการคำตอบ:

ใช้ Push Alerts Enabled เพื่อนับจำนวนผู้ใช้ที่ opt-in อย่างรวดเร็วในทุกเวอร์ชันของ SDK
ใช้ Push Permission Status เมื่อขั้นตอนถัดไปของคุณขึ้นอยู่กับเหตุผลที่เข้าถึงผู้ใช้ไม่ได้ เช่น ขอสิทธิ์จากผู้ใช้ที่ยังไม่เคยถูกขอ และไม่รบกวนผู้ใช้ที่ปฏิเสธแล้ว