การผสานรวม Event streaming

ภาพรวมการผสานรวม

ประเภทการผสานรวม

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

การผสานรวมทำงานอย่างไร

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

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

อภิธานศัพท์

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

ตัวอย่าง:

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

รายการของเอนทิตีที่ซิงโครไนซ์

Communication statistics events (เช่น Push Sent, Email Delivered)

กรณีการใช้งาน

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

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

การผสานรวมการวิเคราะห์ภายนอก

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

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

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

การตั้งค่าการผสานรวม

ในการตั้งค่าการผสานรวม:

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

กำหนดค่าการผสานรวม Event streaming

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

กรอกข้อมูลในฟิลด์ที่จำเป็น

ป้อน Endpoint URL

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

ตัวอย่าง

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

เลือก events

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

ระบุข้อมูลรับรองการให้สิทธิ์

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

ตัวอย่าง:

Bearer your_token_here
Basic base64encoded_credentials

เลือกประเภทการส่งข้อมูล

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

HTTP

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

มี event อย่างน้อย 100 รายการพร้อมที่จะส่ง หรือ
ผ่านไปหนึ่งชั่วโมงนับจากการส่งครั้งล่าสุด

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

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

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

ความพยายาม	การหน่วงเวลา
ครั้งที่ 1	1 วินาที
ครั้งที่ 2	3 วินาทีหลังจากการลองครั้งที่ 1
ครั้งที่ 3	8 วินาทีหลังจากการลองครั้งที่ 2

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

การหมดเวลา

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

ดูตัวอย่าง

gRPC

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

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

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

สตรีมจะถูกปิดหลังจากส่ง event แล้ว สิ่งนี้ช่วยให้แน่ใจว่าจะไม่มีการเปิดสตรีมใหม่สำหรับแต่ละ event ในช่วงเวลาสั้นๆ

ดูข้อกำหนด protobuf

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

การตอบกลับต้องมี status ไม่เท่ากับ "Success"
ต้องรวม uuid เดิมจากคำขอด้วย

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

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

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

เลือกแพลตฟอร์ม

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

เลือกอย่างน้อยหนึ่งแพลตฟอร์ม

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

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

กำหนดค่าตัวกรองขั้นสูง

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

Live activity events: เปิดใช้งานเพื่อรับ live activity events event เหล่านี้มีเพียง metadata รวมถึง live_activity_id
Campaign filters: กรองตามรหัสแคมเปญ เฉพาะ event ที่ผูกกับแคมเปญเหล่านี้เท่านั้นที่จะถูกส่ง
Message filters: กรองตามรหัสข้อความ เฉพาะ event ที่ผูกกับข้อความเหล่านี้เท่านั้นที่จะถูกส่ง

ตั้งค่าตัวกรองขั้นสูง

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

รายละเอียดคำขอและตัวอย่าง


Endpoint	`https://exampleclientendpoint.com/webhook_endpoint`
HTTP Request	`POST`
Authentication	ไม่มี
Request type	Source
Request meaning	ส่งคำขอไปยัง webhook endpoint
Headers	`Content-Type: application/json`

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

{
  "event_name": "Email Opened",
  "message_code": "E682-E6D92B9A-53E24868",
  "campaign_id": 961048,
  "platform": "Email",
  "payload": "Welcome to Headway! 👋",
  "application_code": "XXXXX-XXXXX",
  "hwid": "user@example.com",
  "user_id": "USER_ID",
  "timestamp": 1723799271,
  "journey_title": "",
  "journey_point_title": "5_Welcome_ID_new"
}

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

คุณจะรู้ได้อย่างไรว่าการผสานรวมทำงานอยู่

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