การผสานการทำงานสตรีมมิ่งเหตุการณ์

แหล่งที่มา: ข้อมูลถูกส่งจาก Pushwoosh ไปยังระบบของคุณผ่าน HTTP หรือ gRPC ตามทริกเกอร์เหตุการณ์ที่กำหนดค่าไว้

Pushwoosh ส่งข้อมูลเหตุการณ์การสื่อสาร (เช่น กิจกรรมพุช/อีเมล) ไปยัง Endpoint ที่ลูกค้ากำหนด ข้อมูลจะถูกส่งเป็นชุดข้อมูล (batch streams) ตามช่วงเวลาที่กำหนดไว้ หรือเมื่อถึงขนาดขั้นต่ำของชุดข้อมูล

ข้อมูลจะถูกส่งก็ต่อเมื่อตรงกับเหตุการณ์ แพลตฟอร์ม และตัวกรองเสริมที่เลือกไว้ (รหัสแคมเปญ/ข้อความ, กิจกรรมสด) Endpoint ของลูกค้าต้องพร้อมที่จะรับและสามารถตอบกลับด้วยสถานะได้ (เป็นทางเลือก)

Endpoint URL: Endpoint ฝั่งเซิร์ฟเวอร์ที่อนุญาตให้รับคำขอได้ ลูกค้าสามารถระบุพอร์ตได้หากจำเป็น

ตัวอย่าง:

• https://clientdomainname.com/webhook_endpoint
• https://clientdomainname.com:8081/webhook_endpoint

• เหตุการณ์สถิติการสื่อสาร (เช่น Push Sent, Email Delivered)

• ติดตามการมีส่วนร่วมแบบเรียลไทม์

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

• การผสานการทำงานกับระบบวิเคราะห์ภายนอก

สตรีมเหตุการณ์ไปยังแพลตฟอร์มการวิเคราะห์ของบุคคลที่สามเพื่อการรายงานและการวิเคราะห์แบบรวมศูนย์

• เวิร์กโฟลว์ผู้ใช้อัตโนมัติ

เรียกใช้การดำเนินการในระบบภายนอก (เช่น CRM หรือเครื่องมือการตลาดอัตโนมัติ) ตามพฤติกรรมของผู้ใช้ เช่น ส่งข้อความติดตามผลเมื่อผู้ใช้เปิดอีเมล

เพื่อตั้งค่าการผสานการทำงาน:

1. ในบัญชี Pushwoosh ของคุณ ไปที่ Settings > 3rd party Integrations ค้นหา Event streaming integration และคลิก Configure

2. ในหน้าต่างที่เปิดขึ้นมา ให้กรอกข้อมูลในฟิลด์ที่จำเป็น

ในฟิลด์ Endpoint URL ให้ป้อน URL แบบเต็มที่จะใช้ส่งเหตุการณ์ รวมถึงโปรโตคอลและพอร์ต (ถ้ามี)

ตัวอย่าง

• https://clientdomainname.com/webhook_endpoint
• https://clientdomainname.com:8081/webhook\_endpoint

จากเมนูดร็อปดาวน์ Events ให้เลือกอย่างน้อยหนึ่งเหตุการณ์ หากไม่เลือกเลย การตรวจสอบความถูกต้องจะล้มเหลว รายการเหตุการณ์ได้รับการจัดการโดยแบ็กเอนด์และอาจเปลี่ยนแปลงได้ตลอดเวลา

หากเซิร์ฟเวอร์ของคุณต้องการ ให้ป้อนค่าทั้งหมดสำหรับเฮดเดอร์ Authorization ในฟิลด์ Authorization

ตัวอย่าง:

• Bearer your_token_here

• Basic base64encoded_credentials

จากเมนูดร็อปดาวน์ Transport type ให้เลือกโปรโตคอลการส่งสำหรับเหตุการณ์: HTTP หรือ gRPC แต่ละประเภทมีพฤติกรรมและการกำหนดค่าเฉพาะ

ด้วยประเภทการส่ง HTTP Pushwoosh จะส่งข้อมูลเป็นชุดตามเงื่อนไขข้อใดข้อหนึ่งต่อไปนี้:

• มีเหตุการณ์อย่างน้อย 100 รายการพร้อมที่จะส่ง หรือ

• ผ่านไปหนึ่งชั่วโมงนับจากการส่งครั้งล่าสุด

หลังจากส่งข้อมูลแล้ว การเชื่อมต่อจะถูกปิดเมื่อได้รับการตอบกลับที่สำเร็จ

หากเซิร์ฟเวอร์ตอบกลับด้วย ข้อผิดพลาด 5xx Pushwoosh จะลองส่งคำขออีกครั้งตามนโยบายการลองใหม่ที่กำหนดไว้

กลไกการลองใหม่

หากการลองใหม่ทั้งหมดล้มเหลว คำขอนั้นจะถูกยกเลิก

การหมดเวลา

การหมดเวลาเริ่มต้นสำหรับคำขอคือ 30 วินาที สามารถปรับแต่งได้ตามคำขอผ่านฝ่ายสนับสนุน

ประเภทการส่ง gRPC ใช้ การสตรีมแบบสองทิศทาง สำหรับการส่งข้อมูล เรียนรู้เพิ่มเติมใน เอกสารประกอบ gRPC

สตรีมจะเปิดขึ้นเมื่อตรงตามเงื่อนไขข้อใดข้อหนึ่งต่อไปนี้:

• มีเหตุการณ์อย่างน้อย 1,000 รายการพร้อมสำหรับการส่ง
• ผ่านไปหนึ่งชั่วโมงนับจากการเปิดสตรีมครั้งล่าสุด

สตรีมจะถูกปิดหลังจากส่งเหตุการณ์แล้ว เพื่อให้แน่ใจว่าจะไม่มีการเปิดสตรีมใหม่สำหรับแต่ละเหตุการณ์ในช่วงเวลาสั้น ๆ

กลไกการลองใหม่
แต่ละเหตุการณ์จะมี uuid ที่ไม่ซ้ำกัน หากเหตุการณ์ล้มเหลว:

1. การตอบกลับต้องมี status ไม่เท่ากับ "Success"
2. ต้องระบุ uuid เดิมจากคำขอ

Pushwoosh จะลองส่งอีกครั้งตามการตอบกลับนี้

การตั้งค่าการเชื่อมต่อ

ตัวเลือกขั้นสูง เช่น TLS, keep-alive หรือ นโยบายการลองใหม่ จะถูกกำหนดค่าด้วยตนเองผ่านฝ่ายสนับสนุนและอาจต้องอาศัยความช่วยเหลือจากนักพัฒนา

ในส่วน Platforms ให้เลือกอย่างน้อยหนึ่งแพลตฟอร์มเพื่อเปิดใช้งานการสตรีมเหตุการณ์

แพลตฟอร์มที่รองรับ ได้แก่:

• iOS, Android, macOS, Windows, Amazon, Safari
• Chrome, Firefox, Internet Explorer, Baidu, Huawei
• Email, SMS, Line, Xiaomi, WhatsApp

ในส่วน Advanced filters ปรับแต่งเกณฑ์การส่งเหตุการณ์โดยใช้ตัวกรอง:

• Live activity events: เปิดใช้งานเพื่อรับเหตุการณ์กิจกรรมสด เหตุการณ์เหล่านี้มีเพียงเมทาดาต้าซึ่งรวมถึง live_activity_id

• Campaign filters: กรองตามรหัสแคมเปญ เฉพาะเหตุการณ์ที่ผูกกับแคมเปญเหล่านี้เท่านั้นที่จะถูกส่ง

• Message filters: กรองตามรหัสข้อความ เฉพาะเหตุการณ์ที่ผูกกับข้อความเหล่านี้เท่านั้นที่จะถูกส่ง

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

ตัวอย่างเนื้อหาของคำขอ

{
  "event_name": "Email Opened",
  "message_code": "E682-E6D92B9A-53E24868",
  "campaign_id": 961048,
  "platform": "Email",
  "payload": "Welcome to Headway! 👋",
  "application_code": "32E5A-9B411",
  "hwid": "irun4716@gmail.com",
  "user_id": "1894410",
  "timestamp": 1723799271,
  "journey_title": "",
  "journey_point_title": "5_Welcome_ID_new"
}

การตอบกลับ
ในขณะนี้ รหัสการตอบกลับและเนื้อหาจะถูกละเว้น

คุณจะเริ่มได้รับคำขอจาก Pushwoosh ที่ Endpoint ที่คุณกำหนดค่าไว้