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

ต้องการความช่วยเหลือจากนักพัฒนา

คุณจะต้องได้รับความช่วยเหลือจากทีมนักพัฒนาของคุณเพื่อตั้งค่า Journey ที่เข้าผ่าน API โปรดแชร์คู่มือนี้กับพวกเขา

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

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

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

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

มันทำงานดังนี้:

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

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

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

ตั้งค่า Journey ด้วยการเข้าผ่าน API

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

2. ดับเบิลคลิกที่ขั้นตอนการเข้าผ่าน API หน้าต่างการกำหนดค่าการเข้าจะเปิดขึ้น

3. คุณสามารถแก้ไขเนื้อหา push และอีเมลทุกครั้งที่ Journey เปิดการทำงานโดยใช้ตัวยึดตำแหน่งเนื้อหา (content placeholders) ค่าของตัวยึดตำแหน่งแต่ละตัวสามารถเปลี่ยนแปลงได้ในคำขอ หากคุณไม่ต้องการตัวเลือกนี้ คุณสามารถข้ามขั้นตอนนี้ได้

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

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

ตอนนี้ สร้าง push preset หรือ เนื้อหาอีเมล และแทรกตัวยึดตำแหน่งแทนข้อความที่คุณต้องการแก้ไข ตัวยึดตำแหน่งต้องอยู่ในรูปแบบใดรูปแบบหนึ่งต่อไปนี้ขึ้นอยู่กับความต้องการของคุณ:

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

ตัวปรับแต่งรูปแบบ

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

เคล็ดลับ

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

เมื่อกำหนดค่าองค์ประกอบ Push หรือ Email ใน Journey ของคุณ ให้เลือก preset ที่สร้างขึ้นและเปิดตัวเลือก Personalize message with event attributes

เลือกตัวยึดตำแหน่งที่คุณต้องการแก้ไขในคำขอเมื่อเปิดการทำงาน Journey เลือก API-based entry entry เป็นแหล่งที่มาและชื่อตัวยึดตำแหน่งเป็นแอตทริบิวต์ไดนามิก:

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

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

หมายเหตุ

ในการเปิดการทำงาน Journey ผ่าน API คุณต้องรวมโทเค็นการให้สิทธิ์ที่ถูกต้องใน Authorization header

รูปแบบ header ที่ต้องการ

Authorization: Api <your_api_token>

ตัวอย่าง

Authorization: Api c8dc6435-xxxxxxxxxxxxxxx

5. เพิ่มตัวกรองผู้ชมไปยังพารามิเตอร์ "filter" โดยใช้ Segmentation language หรือ คัดลอกตรรกะการแบ่งกลุ่ม จาก segment ของคุณ ตั้งค่า Tags ที่จำเป็นล่วงหน้า

ตัวอย่างเช่น เพื่อกำหนดเป้าหมายผู้ใช้ที่เพิ่มรายการ Socks ไปยัง Wishlist ของพวกเขา ค่า "filter" จะต้องมีลักษณะดังนี้:

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

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

หมายเหตุ

รหัสแอปพลิเคชันของคุณจะถูกเพิ่มไปยังพารามิเตอร์ "filter" โดยอัตโนมัติในรูปแบบ A(\"12345-12345\") อย่าลบหรือแก้ไขมัน

นอกจากนี้ โปรดจำไว้ว่าเครื่องหมายคำพูด ("") และแบ็กสแลช (\) ควรถูก escape ด้วยแบ็กสแลช (\) ในการสืบค้น JSON

6. หากคุณได้ตั้งค่าตัวยึดตำแหน่ง ให้ระบุเนื้อหาที่ต้องการเป็นค่าของมัน:

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

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

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

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

หมายเหตุ

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