ข้ามไปยังเนื้อหา
เอกสารสำหรับนักพัฒนา คู่มือวิธีการ การสนับสนุน ขอสาธิต เข้าสู่ระบบ
Pushwoosh.com

แสดง In-App ก่อนหน้าต่างขออนุญาตพุช

In-App ขออนุญาตล่วงหน้าคือข้อความที่คุณแสดงก่อนที่ระบบจะแสดงหน้าต่างขออนุญาตพุช ใช้เพื่ออธิบายว่าทำไม push notifications ถึงมีประโยชน์ จากนั้นจึงขออนุญาตหลังจากที่ผู้ใช้ตอบว่าใช่ใน In-App ของคุณแล้วเท่านั้น

บน iOS หน้าต่างของระบบจะปรากฏเพียงครั้งเดียวต่อการติดตั้ง หากผู้ใช้แตะ ไม่อนุญาต แอปจะไม่สามารถแสดงหน้าต่างนั้นได้อีก พุชจะถูกปิดไว้จนกว่าผู้ใช้จะไปเปิดการแจ้งเตือนใน Settings การถามใน In-App ก่อนหมายความว่าคุณจะใช้โอกาสเพียงครั้งเดียวนั้นกับผู้ใช้ที่ตอบว่าใช่กับคุณแล้วเท่านั้น

ใช้คู่มือนี้หากคุณต้องการออกแบบหน้าต่าง HTML แบบ cross-platform ใน Control Panel และทริกเกอร์ด้วย event ทั้งบน iOS และ Android

ใช้คู่มืออื่นหาก:

  • ทีมของคุณจะสร้างหน้าต่างสำหรับ iOS เท่านั้นในโค้ดของแอป (ไม่สามารถแก้ไขใน Control Panel, ไม่ได้เริ่มโดย Journey event): iOS push primer
  • คุณต้องการกระตุ้นผู้ใช้ที่ปิดใช้งานพุชไปแล้วหรือยังไม่เคยให้สิทธิ์ (สำหรับการกู้คืนเท่านั้น ไม่ใช่การขอครั้งแรก): สร้างป๊อปอัปเพื่อกู้คืนการ opt-out

ก่อนที่คุณจะเริ่ม

Anchor link to

Pushwoosh จะไม่แสดงกล่องโต้ตอบขออนุญาตของระบบด้วยตัวเอง ไม่มีอะไรต้องกำหนดค่าใน Control Panel เพื่อหน่วงเวลามัน กล่องโต้ตอบจะปรากฏขึ้นเมื่อผู้ใช้แตะปุ่มยอมรับใน In-App ของคุณเท่านั้น

ทำงานร่วมกับทีมพัฒนาของคุณในข้อกำหนดเบื้องต้นเหล่านี้:

  1. ยืนยันว่าแอปไม่ได้ขออนุญาตพุชก่อนหน้านี้ (รวมถึงในการเปิดใช้งานครั้งแรก)
  2. ตกลงชื่อ event ที่กำหนดเองและเวลาที่จะยิง event ตัวอย่างเช่น onboarding_completed ทันทีหลังจาก onboarding หรือ locked_feature_tapped เมื่อผู้ใช้แตะฟีเจอร์ที่ต้องใช้การแจ้งเตือน ทีมของคุณจะเรียกใช้ postEvent ด้วยชื่อนั้น เรียนรู้เพิ่มเติมเกี่ยวกับ events

สร้าง In-App

Anchor link to

ปุ่มในคู่มือนี้ทำงานด้วย JavaScript ที่กำหนดเอง ซึ่งจะทำงานได้ในเทมเพลต In-App ที่เป็น HTML เท่านั้น เทมเพลต In-App แบบเนทีฟ ไม่สามารถรันโค้ดนี้ได้ ดังนั้นอย่าสร้างเทมเพลตด้วย Native in-app

  1. ไปที่ Content → In-Apps และคลิก Create in-app เพื่อเปิด editor ในตัว โดยตรง

  2. ป้อนชื่อเทมเพลต

  3. เปิดแท็บ Blocks ในแผงด้านขวาและเพิ่มบล็อกข้อความหรือหัวเรื่องพร้อมกับข้อความเชิญชวนให้เปิดใช้งานพุช

พื้นที่ทำงานของ Editor พร้อมหัวเรื่อง Stay in the loop และข้อความเชิญชวนที่เพิ่มเข้ามา โดยแท็บ Blocks เปิดอยู่ในแผงด้านขวา
  1. เพิ่มบล็อกปุ่มสำหรับการกระทำยอมรับและอีกปุ่มสำหรับการกระทำปฏิเสธ ปุ่มทั้งสองสามารถรัน JavaScript ได้ทันทีที่ In-App โหลด โดยไม่ต้องรออะไรอีก
พื้นที่ทำงานของ Editor พร้อมข้อความเชิญชวนและปุ่ม Enable notifications และ Not now ที่เพิ่มเข้ามา
  1. เลือกปุ่มยอมรับและตั้งค่า Action type เป็น Custom Javascript
  2. วางเฉพาะโค้ดด้านล่างลงใน onClick
pushwoosh.registerForPushNotifications();
pushwoosh.closeInApp();
  1. เลือกปุ่มปฏิเสธและตั้งค่า Action type เป็น Custom Javascript
  2. วางเฉพาะโค้ดนี้ลงใน onClick:
pushwoosh.closeInApp();

หลังจากที่คุณบันทึกเทมเพลต:

  • ปุ่มยอมรับ: กล่องโต้ตอบขออนุญาตของระบบจะปรากฏขึ้น
  • ปุ่มปฏิเสธ: In-App จะปิดลงและไม่มีกล่องโต้ตอบของระบบปรากฏขึ้น
In-App ขออนุญาตล่วงหน้าแบบ bottom sheet พร้อมปุ่ม Enable notifications และ Not now แสดงอยู่บนหน้าจอแอปบน iOS
In-App ขออนุญาตล่วงหน้าที่แสดงก่อนหน้าต่างของระบบ

ข้ามหน้าต่างสำหรับผู้ใช้ที่เลือกรับแล้ว

Anchor link to

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

  1. ในแผง Layers คลิกบล็อกแรก จากนั้นกด Shift ค้างไว้แล้วคลิกบล็อกอื่นๆ ทั้งหมดเพื่อเลือกเทมเพลตทั้งหมดพร้อมกัน
  2. เปิด Show this block conditionally กฎที่คุณตั้งค่าด้านล่างจะนำไปใช้กับส่วนที่เลือกทั้งหมดในครั้งเดียว
  3. ตั้งกฎเป็น Push Alerts Enabled is false
  4. ภายใต้ If value is unknown เลือก Show block การติดตั้งใหม่ที่ยังไม่มีค่า Tag ควรยังคงเห็นหน้าต่างนี้
บล็อกทั้งหมดถูกเลือกพร้อมกันใน editor โดยเปิด Show this block conditionally, ตั้งกฎเป็น Push Alerts Enabled is false, และตั้งค่า If value is unknown เป็น Show block

ทริกเกอร์ In-App ก่อนที่จะมีการขออนุญาต

Anchor link to

อุปกรณ์ที่ยังไม่ได้ลงทะเบียนจะไม่มี push token ดังนั้นคุณจึงไม่สามารถเข้าถึงได้ด้วย push notification ทริกเกอร์ In-App ด้วย event ที่กำหนดเองที่คุณตกลงไว้กับทีมพัฒนา

  1. ขอให้ทีมพัฒนาของคุณเรียกใช้ postEvent ด้วยชื่อ event ที่ตกลงกันไว้ในขณะที่คุณต้องการขอ
  2. ไปที่ Customer Journey Builder → Create Campaign และเริ่มต้นด้วย Trigger-based entry ที่รอรับ event นั้น
  3. เพิ่มองค์ประกอบ In-app และเลือกเทมเพลตที่คุณสร้างขึ้น เรียนรู้เพิ่มเติมเกี่ยวกับการส่ง In-Apps ผ่าน Customer Journey
  4. เปิดใช้งาน Journey เมื่อคุณพร้อมที่จะแสดงหน้าต่าง

สถานการณ์ตัวอย่าง: ขออนุญาตพุชทันทีหลัง onboarding

Anchor link to

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

  1. สร้าง event onboarding_completed และยืนยันว่าทีมพัฒนาของคุณยิง event นี้เมื่อผู้ใช้เสร็จสิ้นขั้นตอนการ onboarding เรียนรู้เพิ่มเติมเกี่ยวกับการสร้าง events
  2. ตั้งค่า onboarding_completed เป็นทริกเกอร์สำหรับ Journey ของคุณ โดยใช้ Trigger-based entry
  3. เพิ่มองค์ประกอบ In-app และเลือก เทมเพลตขออนุญาตล่วงหน้าที่คุณสร้างขึ้น
  4. เปิดใช้งาน Journey

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

ตรวจสอบว่าใช้งานได้

Anchor link to

หน้าต่างของระบบจะแสดงเพียงครั้งเดียว ดังนั้นการทดสอบทั้งสองปุ่มต้องใช้อุปกรณ์ทดสอบสองเครื่อง (หรือการติดตั้งใหม่สองครั้ง) ที่ยังไม่เคยให้สิทธิ์หรือปฏิเสธพุชมาก่อน โดยใช้เครื่องหนึ่งสำหรับแต่ละปุ่ม ในแต่ละอุปกรณ์:

  1. ยิง event ที่ตกลงกันไว้จากแอป
  2. เปิดแอปอีกครั้งและยืนยันว่า Journey ส่ง In-App ของคุณ

จากนั้น:

  1. บนอุปกรณ์เครื่องแรก แตะปุ่มยอมรับและยืนยันว่ากล่องโต้ตอบขออนุญาตของระบบปรากฏขึ้น
  2. บนอุปกรณ์เครื่องที่สอง แตะปุ่มปฏิเสธและยืนยันว่า In-App ปิดลงโดยไม่มีกล่องโต้ตอบของระบบ
  3. หลังจากการเปิดแอปครั้งถัดไป ยืนยันว่า Push Alerts Enabled ตรงกับสถานะการอนุญาตในแต่ละอุปกรณ์

สร้าง segment ของผู้ใช้ที่ยังคงปิดใช้งานพุช

Anchor link to

กรองด้วย Push Alerts Enabled เพื่อค้นหาผู้ใช้ที่ปฏิเสธหรือยังไม่เคยให้สิทธิ์ Tag จะเป็น false เมื่อยังไม่ได้รับอนุญาตพุช รวมถึงก่อนที่ผู้ใช้จะเห็นกล่องโต้ตอบของระบบ ดังนั้นอุปกรณ์ที่ยังไม่ได้รับอนุญาตจะอยู่ใน segment นี้แล้ว

  1. ในเครื่องมือสร้าง segment เพิ่มตัวกรองด้วย Tag Push Alerts Enabled
  2. ตั้งค่า operator เป็น is false เรียนรู้เพิ่มเติมเกี่ยวกับการสร้าง segments ด้วย tags

ใช้ segment นี้เพื่อยับยั้งการแสดงหน้าต่างซ้ำสำหรับผู้ใช้ที่ยังไม่ได้เปิดใช้งานพุช หรือเพื่อรัน Journey เพื่อดึงดูดผู้ใช้กลับมาเป็นระยะ ดู segment การกู้คืนการ opt-out สำหรับตัวอย่างที่ใช้งานได้จริงด้วย Tag เดียวกัน

ดูเพิ่มเติม

Anchor link to