การเข้า Journey ผ่าน API

ภาพรวมและกรณีการใช้งาน

การเข้า Journey ผ่าน API (API-based Entry) ช่วยให้คุณสามารถเปิด Customer Journey ได้ทันทีที่เกิดอีเวนต์ทางธุรกิจที่เฉพาะเจาะจงขึ้น ในการเริ่มแคมเปญ คุณจะต้องส่งคำขอ API แบบพิเศษ

นี่คือกรณีการใช้งานบางส่วนสำหรับการเข้า Journey ผ่าน API:

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

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

วิธีการทำงานเป็นดังนี้:

สร้าง Journey ด้วยการเข้า Journey ผ่าน API ในการตั้งค่าการเข้า (Entry) คุณจะพบเทมเพลตของคำขอที่ใช้เปิด Journey
เพิ่มเงื่อนไขการแบ่งเซกเมนต์ลงในคำขอโดยใช้ ภาษาการแบ่งเซกเมนต์ (Segmentation language) นอกจากนี้คุณยังสามารถเพิ่มเพลสโฮลเดอร์เนื้อหา (content placeholders) ลงในคำขอเพื่อเปลี่ยนเนื้อหาข้อความตามบริบทได้
ทำให้คำขอเป็นแบบอัตโนมัติตามต้องการ ตัวอย่างเช่น ข้อมูลเกี่ยวกับการเปลี่ยนแปลงราคาสามารถส่งจากฐานข้อมูลไปยังเว็บฮุค (webhook) ได้ทันที เมื่อสิ่งนี้เกิดขึ้น เว็บฮุคควรส่งคำขอเพื่อเปิด Journey โดยอัตโนมัติ นอกจากนี้คุณยังสามารถส่งคำขอด้วยตนเองได้หากไม่ต้องการระบบอัตโนมัติ

คุณสามารถส่งคำขอได้ไม่จำกัดจำนวนครั้งเพื่อเปลี่ยนแปลงเงื่อนไขการแบ่งเซกเมนต์หรือเนื้อหาข้อความ

สำหรับรายละเอียดเพิ่มเติม โปรดปฏิบัติตามคำแนะนำด้านล่าง

การตั้งค่า

สร้าง Journey ด้วยการเข้า Journey ผ่าน API:

ดับเบิลคลิกที่ขั้นตอนการเข้า Journey ผ่าน API หน้าต่างการกำหนดค่าการเข้า (Entry) จะเปิดขึ้น
คุณสามารถแก้ไขเนื้อหาของพุชและอีเมลทุกครั้งที่ Journey เปิดใช้งานได้โดยใช้เพลสโฮลเดอร์เนื้อหา (content placeholders) ค่าของเพลสโฮลเดอร์แต่ละตัวสามารถเปลี่ยนแปลงได้ในคำขอ หากคุณไม่ต้องการตัวเลือกนี้ คุณสามารถข้ามขั้นตอนนี้ไปได้

ตัวอย่างเช่น คุณกำลังสร้าง Journey เพื่อแจ้งเตือนผู้ติดตามเมื่อพอดแคสต์ตอนใหม่ออกอากาศ การใช้เพลสโฮลเดอร์เนื้อหาจะช่วยให้คุณสามารถเปลี่ยนชื่อพอดแคสต์ได้ทุกครั้งที่เปิด Journey

ขั้นแรก ให้เพิ่มชื่อเพลสโฮลเดอร์ในหน้าต่างตั้งค่าการเข้า Journey ผ่าน API คุณสามารถใช้ชื่อใดก็ได้ที่สะดวกสำหรับคุณ

ตอนนี้ สร้าง พรีเซ็ต (Preset) สำหรับพุชหรืออีเมล และแทรกเพลสโฮลเดอร์แทนที่ข้อความที่คุณต้องการแก้ไข เพลสโฮลเดอร์ต้องอยู่ในรูปแบบใดรูปแบบหนึ่งต่อไปนี้ ขึ้นอยู่กับความต้องการของคุณ:

{placeholder_name|format_modifier|} – หากไม่ได้ระบุค่าเพลสโฮลเดอร์เมื่อเปิดแคมเปญ ผู้ใช้จะเห็นเป็นพื้นที่ว่างแทน
{placeholder_name|format_modifier} – หากไม่ได้ระบุค่าเพลสโฮลเดอร์และยังไม่เคยมีการกำหนดค่าให้กับผู้ใช้ (ในกรณีที่คุณใช้แท็ก (Tag) เป็นเพลสโฮลเดอร์) ข้อความจะไม่ถูกส่ง

ตัวปรับเปลี่ยนรูปแบบ (Format modifiers)

CapitalizeFirst – ทำให้ตัวอักษรตัวแรกในค่าเพลสโฮลเดอร์เป็นตัวพิมพ์ใหญ่
CapitalizeAllFirst – ทำให้ตัวอักษรตัวแรกของทุกคำในค่าเพลสโฮลเดอร์เป็นตัวพิมพ์ใหญ่ หากค่าประกอบด้วยมากกว่าหนึ่งคำ
UPPERCASE – เปลี่ยนตัวอักษรทั้งหมดเป็นตัวพิมพ์ใหญ่
lowercase – เปลี่ยนตัวอักษรทั้งหมดเป็นตัวพิมพ์เล็ก
regular – แทรกค่าเพลสโฮลเดอร์ตามที่ระบุในคำขอทุกประการ โดยไม่มีการแก้ไข

เมื่อกำหนดค่าขั้นตอนพุชหรืออีเมลใน Journey ของคุณ ให้เลือกพรีเซ็ตที่สร้างขึ้นและเปิดตัวเลือก Personalize message with event attributes เลือกเพลสโฮลเดอร์ที่คุณต้องการแก้ไขในคำขอเมื่อเปิด Journey เลือก API-based Entry entry เป็นแหล่งที่มา และชื่อเพลสโฮลเดอร์เป็นแอตทริบิวต์ไดนามิก:

คลิก Apply เพื่อบันทึกการเปลี่ยนแปลง

ในหน้าต่างการกำหนดค่าการเข้า (Entry) คัดลอกเทมเพลตคำขอเพื่อแก้ไข:

เพิ่มตัวกรองกลุ่มเป้าหมายลงในพารามิเตอร์ “filter” โดยใช้ ภาษาการแบ่งเซกเมนต์ (Segmentation language) หรือ คัดลอกภาษาการแบ่งเซกเมนต์ จากเซกเมนต์ที่คุณสร้างไว้ก่อนหน้านี้ โปรดทราบว่าคุณต้องตั้งค่า แท็ก (Tags) ที่จำเป็นล่วงหน้า

ตัวอย่างเช่น หากคุณต้องการกำหนดเป้าหมาย Journey ไปยังผู้ใช้ที่เพิ่มรายการ Socks (ถุงเท้า) ไปยัง Wishlist (รายการสิ่งที่อยากได้) ของพวกเขา ค่า “filter” จะต้องมีลักษณะดังนี้:

"filter": "A(\"12345-12345\") * "T(\"Wishlist\", EQ, \"Socks\")"

ในตัวอย่างนี้ คุณต้องมีแท็ก Wishlist ที่กำหนดค่าไว้ในแอปของคุณ

หากคุณได้ตั้งค่าเพลสโฮลเดอร์ไว้ ให้ระบุเนื้อหาที่ต้องการเป็นค่าของเพลสโฮลเดอร์เหล่านั้น:

หากเปิดใช้งานตัวเลือก Message Rate Limits จำนวนผู้ใช้ที่เข้าสู่ Journey พร้อมกันในแต่ละวินาทีจะถูกจำกัด คุณสามารถใช้ค่าเริ่มต้นที่ 5,000 คนต่อวินาที หรือตั้งค่าตัวเลขอื่นได้

หากคุณวางแผนที่จะรีสตาร์ทแคมเปญบ่อยครั้งและไม่ต้องการให้ผู้ใช้คนเดิมเข้าสู่ Journey หลายครั้ง ให้ตั้งค่า การจำกัดความถี่ (Frequency Capping)

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

หากคุณต้องการให้ Journey เปิดใช้งานเมื่อใดก็ตามที่เกิดอีเวนต์ทางธุรกิจบางอย่างขึ้น ให้ทำให้คำขอเป็นแบบอัตโนมัติโดยใช้เว็บฮุค (webhook) เมื่ออีเวนต์เกิดขึ้น เว็บฮุคควรส่งคำขอเพื่อเริ่ม Journey โดยอัตโนมัติ

คุณยังสามารถส่งคำขอด้วยตนเองได้หากไม่ต้องการระบบอัตโนมัติ