เซกเมนต์ภายนอก

External segments ช่วยให้คุณสามารถกำหนดเป้าหมายผู้ใช้ที่จัดเก็บไว้ในฐานข้อมูลของคุณเอง เช่น CRM หรือ data warehouse ของคุณ แทนที่จะต้องส่งออกเป็นไฟล์ CSV แล้วอัปโหลดใหม่ทุกครั้งที่รายการมีการเปลี่ยนแปลง คุณเพียงแค่ให้ SQL query กับ Pushwoosh ที่จะส่งคืน User ID ที่ถูกต้อง และ Pushwoosh จะรัน query นั้นซ้ำๆ เพื่อให้เซกเมนต์เป็นปัจจุบันอยู่เสมอ เมื่อตั้งค่าเสร็จแล้ว คุณสามารถใช้ผู้ใช้เหล่านี้ได้เหมือนกับเซกเมนต์อื่นๆ

ต้องการความช่วยเหลือจากนักพัฒนา

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

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

• เตรียมผู้ใช้แบบ read-only (หรือสำหรับ BigQuery ให้ใช้ service account แบบ read-only)
• ยืนยัน query ที่คุณวางแผนจะใช้
• หากฐานข้อมูลอยู่หลัง firewall ให้สอบถามฝ่ายสนับสนุนของ Pushwoosh ว่าต้องอนุญาต IP address ใดบ้าง

สร้างเซกเมนต์ภายนอก

ตั้งชื่อเซกเมนต์และเลือกฐานข้อมูล

1. ไปที่ Audience → External Segments
2. คลิก Create external segment

3. ป้อน Name สำหรับเซกเมนต์ (สูงสุด 100 ตัวอักษร)
4. เลือก Database type: PostgreSQL, MySQL, Google BigQuery หรือ Microsoft SQL Server / Fabric

กรอกข้อมูลในช่องการเชื่อมต่อ

PostgreSQL และ MySQL

สำหรับ PostgreSQL และ MySQL ให้กรอกข้อมูลต่อไปนี้:

• Host และ Port: ที่อยู่ของเซิร์ฟเวอร์ฐานข้อมูลของคุณ Pushwoosh ต้องการ host ที่สามารถเข้าถึงได้แบบสาธารณะ และจะปฏิเสธที่อยู่ที่เป็น private, internal หรือ loopback เมื่อคุณตรวจสอบการเชื่อมต่อหรือบันทึกเซกเมนต์
• Database: ชื่อฐานข้อมูล
• User และ Password: ข้อมูลประจำตัวสำหรับบัญชีแบบ read-only
• SSL mode (สำหรับ PostgreSQL เท่านั้น เนื่องจาก MySQL connections ไม่ใช้ TLS) กำหนดวิธีการใช้ SSL/TLS ซึ่งเป็นโปรโตคอลที่เข้ารหัสการเชื่อมต่อกับฐานข้อมูลของคุณ สอบถามผู้ดูแลฐานข้อมูลของคุณว่าควรใช้โหมดใด:
  • Disable: ไม่มีการเข้ารหัส
  • Require: เข้ารหัสการเชื่อมต่อ แต่ไม่ตรวจสอบตัวตนของเซิร์ฟเวอร์ฐานข้อมูล
  • Verify CA: เข้ารหัสการเชื่อมต่อและตรวจสอบว่าใบรับรองของเซิร์ฟเวอร์ออกโดย certificate authority (CA) ที่เชื่อถือได้
  • Verify full: เหมือนกับ Verify CA และยังตรวจสอบว่าใบรับรองตรงกับ hostname ของฐานข้อมูลของคุณ เป็นตัวเลือกที่ปลอดภัยที่สุด
• สำหรับโหมดอื่นที่ไม่ใช่ Disable ให้ระบุ CA certificate ใต้ Certificate source (Upload files หรือ Paste PEM) พร้อมด้วย Client certificate และ Client key หากฐานข้อมูลของคุณต้องการ

BigQuery

สำหรับ Google BigQuery ให้กรอกข้อมูลต่อไปนี้:

• Project ID: GCP project ที่เก็บ dataset ของคุณ
• Service account JSON: คีย์สำหรับ service account ที่มีสิทธิ์อ่าน BigQuery
• Location: ภูมิภาคของ dataset (ตัวอย่างเช่น EU, US หรือ europe-west3) เว้นว่างไว้เพื่อให้ระบบค้นหาตำแหน่งจาก dataset โดยอัตโนมัติ

SQL Server / Fabric

สำหรับ Microsoft SQL Server / Fabric ให้กรอกข้อมูลต่อไปนี้:

• Host และ Port: ที่อยู่ของเซิร์ฟเวอร์ฐานข้อมูลของคุณ หรือ Fabric SQL analytics endpoint ของคุณ Pushwoosh ต้องการ host ที่สามารถเข้าถึงได้แบบสาธารณะ และจะปฏิเสธที่อยู่ที่เป็น private, internal หรือ loopback เมื่อคุณตรวจสอบการเชื่อมต่อหรือบันทึกเซกเมนต์
• Database: ชื่อฐานข้อมูล
• User และ Password: ข้อมูลประจำตัวสำหรับบัญชีแบบ read-only
• Microsoft Entra tenant ID: ไม่จำเป็น เว้นว่างไว้สำหรับการล็อกอิน SQL Server สำหรับ Microsoft Fabric ซึ่ง SQL analytics endpoint ไม่มี SQL logins ให้ตั้งค่าเพื่อลงชื่อเข้าใช้เป็น service principal แทน ป้อน application (client) ID เป็น User และ client secret เป็น Password

ป้อน query

1. ป้อน Query ซึ่งต้องส่งคืนคอลัมน์เดียวชื่อ user_id โดยมีหนึ่งแถวต่อผู้ใช้ที่คุณต้องการให้อยู่ในเซกเมนต์ ตัวอย่างเช่น:

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

หมายเหตุ

ค่า user_id ต้องตรงกับ Pushwoosh User IDs ที่คุณตั้งค่าไว้สำหรับผู้ใช้ของคุณ (เป็นตัวระบุเดียวกับที่ใช้โดย สร้างเซกเมนต์ตาม User ID) query ที่ส่งคืน ID ที่ Pushwoosh ไม่รู้จักจะไม่ตรงกับอุปกรณ์ใดๆ

2. คลิก Check connection เพื่อยืนยันว่า Pushwoosh สามารถเข้าถึงฐานข้อมูลได้ (หมดเวลาหลังจาก 30 วินาที)
3. คลิก Check query เพื่อยืนยันว่า query ทำงานและส่งคืนคอลัมน์ที่ถูกต้อง (หมดเวลาหลังจาก 30 วินาทีเช่นกัน)

ตรวจสอบและสร้าง

เมื่อการตรวจสอบทั้งสองสำเร็จ ให้คลิก Create Pushwoosh จะบันทึกเซกเมนต์และเพิ่มลงในรายการ External Segments ทันที

วิธีการทำให้เซกเมนต์เป็นปัจจุบันอยู่เสมอ

Pushwoosh ไม่ได้รัน query ของคุณตามกำหนดเวลาที่แน่นอน แต่จะรีเฟรชเซกเมนต์ตามความล่าสุดของการใช้งาน:

• หากข้อมูลของเซกเมนต์มีอายุไม่ถึงหนึ่งชั่วโมง Pushwoosh จะใช้ข้อมูลปัจจุบันตามที่เป็นอยู่
• หากมีอายุมากกว่าหนึ่งชั่วโมง Pushwoosh จะยังคงใช้ข้อมูลปัจจุบันในขณะที่รีเฟรชในเบื้องหลัง
• หากมีอายุมากกว่าสามชั่วโมง Pushwoosh จะรอการรีเฟรชใหม่ก่อนที่จะใช้เซกเมนต์

ในทางปฏิบัติ นี่หมายความว่าเซกเมนต์ที่คุณใช้เป็นประจำ (ตัวอย่างเช่น ใน journey ที่เกิดซ้ำ) จะยังคงเป็นปัจจุบัน ในขณะที่เซกเมนต์ที่คุณไม่ค่อยได้ใช้อาจใช้เวลาสักครู่ในการรีเฟรชในครั้งแรกที่คุณกลับมาใช้

หากการรีเฟรชล้มเหลว (ตัวอย่างเช่น ไม่สามารถเข้าถึงฐานข้อมูลได้ หรือ query เริ่มมีข้อผิดพลาด) Pushwoosh จะบันทึกข้อผิดพลาด แต่สถานะของเซกเมนต์ในรายการ External Segments จะไม่เปลี่ยนแปลงด้วยตัวเอง หลังจากที่คุณแก้ไขปัญหาที่ฝั่งของคุณแล้ว ให้เปิดเซกเมนต์และคลิก Check connection เพื่อยืนยันการแก้ไข ข้อผิดพลาดจะถูกล้างโดยอัตโนมัติในครั้งถัดไปที่ข้อมูลของเซกเมนต์รีเฟรชสำเร็จ

การใช้เซกเมนต์ภายนอก

เมื่อคุณสร้างแล้ว เซกเมนต์ภายนอกจะปรากฏโดยอัตโนมัติใน Audience → Segments ภายใต้ชื่อเดียวกัน พร้อมใช้งานเหมือนกับเซกเมนต์อื่นๆ เช่น เป็นกลุ่มเป้าหมายของแคมเปญหรือ journey

หากต้องการรวมกับเงื่อนไขอื่นๆ ให้เพิ่มเป็นตัวกรอง:

1. ไปที่ Audience → Segments → Create Segment
2. คลิก Add filter by → Segment
3. เลือกเซกเมนต์ภายนอกของคุณตามชื่อ

ตัวกรอง Segment เดียวกันนี้มีให้ใช้งานใน compound filters และเมื่อคุณเลือกกลุ่มเป้าหมายใน Audience-based entry สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการรวมเซกเมนต์ โปรดดูที่ สร้างเซกเมนต์จากเซกเมนต์ที่มีอยู่

ตรวจสอบจำนวนคนในเซกเมนต์

รายการ External Segments ไม่แสดงจำนวนสมาชิก เปิด wrapper ของเซกเมนต์ใน Audience → Segments (ดู การใช้เซกเมนต์ภายนอก) และ คำนวณขนาด ที่นั่น

จัดการเซกเมนต์ภายนอก

ในรายการ External Segments แต่ละแถวจะแสดงชื่อของเซกเมนต์, Code (ตัวระบุที่ใช้อ้างอิงเซกเมนต์ในการเรียก API), ประเภทฐานข้อมูล, host และสถานะ (valid หรือ invalid)

• คลิก Edit เพื่อเปลี่ยนการเชื่อมต่อหรือ query ไม่สามารถเปลี่ยนประเภทฐานข้อมูลได้หลังจากการสร้าง ให้สร้างเซกเมนต์ใหม่แทน
• คลิก Delete เพื่อลบเซกเมนต์ Pushwoosh จะบล็อกการลบในขณะที่เซกเมนต์ถูกใช้งานโดยแคมเปญ, journey, ตัวกรอง หรือฟอร์มป๊อปอัป ให้ลบการอ้างอิงเหล่านั้นออกก่อน แล้วจึงลบเซกเมนต์ การกระทำนี้ไม่สามารถยกเลิกได้