การผสานรวมการสตรีมเหตุการณ์

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

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

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

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

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

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

อภิธานศัพท์

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

ตัวอย่าง:

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

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

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

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

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

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

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

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

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

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

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

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

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

กำหนดค่าการผสานรวมการสตรีมเหตุการณ์

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

กรอกข้อมูลในช่องที่จำเป็น

ป้อน URL ของ endpoint

ในช่อง 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

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

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

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

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

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

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

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

การหมดเวลา

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

ดูตัวอย่าง

gRPC

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

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

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

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

ดูข้อกำหนด protobuf

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


Endpoint	`https://exampleclientendpoint.com/webhook_endpoint`
คำขอ HTTP	`POST`
การรับรองความถูกต้อง	ไม่
ประเภทคำขอ	แหล่งที่มา
ความหมายของคำขอ	ส่งคำขอไปยัง webhook endpoint
เฮดเดอร์	`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 ที่คุณกำหนดค่าไว้