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

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

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

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

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

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

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

อภิธานศัพท์

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

ตัวอย่าง:

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

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

Events สถิติการสื่อสาร (เช่น Push Sent, Email Delivered)

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

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

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

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

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

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

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

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

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

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

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

ป้อน Endpoint URL

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

ตัวอย่าง

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

เลือก events

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

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

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

ตัวอย่าง:

Bearer your_token_here
Basic base64encoded_credentials

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

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

HTTP

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

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

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

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

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

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

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

การหมดเวลา

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

ดูตัวอย่าง

gRPC

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

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

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

สตรีมจะถูกปิดหลังจากส่ง events แล้ว เพื่อให้แน่ใจว่าจะไม่มีการเปิดสตรีมใหม่สำหรับแต่ละ 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 events เหล่านี้มีเพียง metadata ซึ่งรวมถึง live_activity_id
Campaign filters: กรองตามรหัสแคมเปญ เฉพาะ events ที่ผูกกับแคมเปญเหล่านี้เท่านั้นที่จะถูกส่ง
Message filters: กรองตามรหัสข้อความ เฉพาะ events ที่ผูกกับข้อความเหล่านี้เท่านั้นที่จะถูกส่ง

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

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

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


Endpoint	`https://exampleclientendpoint.com/webhook_endpoint`
คำขอ HTTP	`POST`
การยืนยันตัวตน	ไม่มี
ประเภทคำขอ	ที่มา
ความหมายของคำขอ	ส่งคำขอไปยัง 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": "32E5A-9B411",
  "hwid": "irun4716@gmail.com",
  "user_id": "1894410",
  "timestamp": 1723799271,
  "journey_title": "",
  "journey_point_title": "5_Welcome_ID_new"
}

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

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

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