ข้ามไปยังเนื้อหา

เทมเพลต Liquid

วิดีโอ YouTube: เรียนรู้วิธีการใช้เทมเพลตเนื้อหาใน Customer journeys

เทมเพลต Liquid ขยายขีดความสามารถในการปรับแต่งเฉพาะบุคคลของ Pushwoosh ได้อย่างมาก ด้วยการใช้ตรรกะที่ซับซ้อนนอกเหนือจากการใช้เนื้อหาแบบไดนามิก (Dynamic Content) ทั่วไป

การปรับแต่งข้อความส่วนบุคคลใน Pushwoosh นั้นใช้ แท็ก (ข้อมูลผู้ใช้) เป็นพื้นฐาน Pushwoosh มี แท็กเริ่มต้น และ แท็กที่กำหนดเอง ที่หลากหลาย ด้วยการใช้แท็กเหล่านี้ คุณสามารถระบุชื่อ, เมือง, ประวัติการซื้อของผู้ใช้ ฯลฯ เพื่อส่งข้อความที่เป็นส่วนตัวมากขึ้น ตัวอย่างเช่น: สวัสดี {First_name} ขอบคุณที่สั่งซื้อ {item}

เทมเพลต Liquid เพิ่มตรรกะให้กับเนื้อหาแบบไดนามิกมากขึ้น ตัวอย่างเช่น หากแท็กการสมัครสมาชิกของผู้ใช้มีคำว่า “free” คุณสามารถส่งข้อความถึงพวกเขาว่า: “รับส่วนลด 10% ของคุณ”

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

ไวยากรณ์

Anchor link to

เทมเพลตเนื้อหาที่ใช้ Liquid by Shopify จะใช้การผสมผสานระหว่าง แท็ก (tags), อ็อบเจกต์ (objects), และ ฟิลเตอร์ (filters) เพื่อโหลดเนื้อหาแบบไดนามิก เทมเพลตเนื้อหาอนุญาตให้เข้าถึงตัวแปรบางอย่างจากภายในเทมเพลตและแสดงข้อมูลของตัวแปรเหล่านั้นโดยไม่จำเป็นต้องรู้ข้อมูลเกี่ยวกับตัวข้อมูลเอง

อ็อบเจกต์ (Objects)

Anchor link to

objects กำหนดเนื้อหาที่จะแสดงให้ผู้ใช้เห็น objects ควรอยู่ภายในวงเล็บปีกกาคู่: {{ }}

ตัวอย่างเช่น เมื่อปรับแต่งข้อความส่วนบุคคล ให้ส่ง {{Name}} ในเนื้อหาของข้อความเพื่อเพิ่มชื่อผู้ใช้ลงในเนื้อหาของข้อความ ชื่อของผู้ใช้ (ค่าแท็ก Name) จะแทนที่อ็อบเจกต์ Liquid ในข้อความที่ผู้ใช้จะเห็น

สวัสดี {{Name}}! เราดีใจที่คุณกลับมา!

แท็ก (Tags)

Anchor link to

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

ตัวอย่างเช่น การใช้แท็ก if คุณสามารถปรับเปลี่ยนภาษาของข้อความตามภาษาที่ตั้งค่าไว้บนอุปกรณ์ของผู้ใช้:

อินพุต:

Anchor link to
{% if Language == 'fr' %}
Salut!
{% else %}
Hello!
{% endif %}

เอาต์พุต (fr): Salut!

เอาต์พุต (es): Hello!

ตัวดำเนินการของแท็ก (Tags operators)

Anchor link to
ตัวดำเนินการคำอธิบาย
==เท่ากับ
!=ไม่เท่ากับ
>มากกว่า
<น้อยกว่า
>=มากกว่าหรือเท่ากับ
<=น้อยกว่าหรือเท่ากับ
orหรือแบบตรรกะ
andและแบบตรรกะ
containsตรวจสอบการมีอยู่ของสตริงย่อยภายในสตริงหรืออาร์เรย์ของสตริง

ฟิลเตอร์ (Filters)

Anchor link to

filters แก้ไขเอาต์พุตของอ็อบเจกต์หรือตัวแปร Liquid ซึ่งจะใช้ภายในวงเล็บปีกกาคู่ {{ }} และการกำหนดค่าตัวแปร และจะถูกคั่นด้วยเครื่องหมายไปป์ | สามารถใช้ฟิลเตอร์หลายตัวกับเอาต์พุตเดียวได้ และจะถูกนำไปใช้จากซ้ายไปขวา

อินพุตเอาต์พุต
{{ Name | capitalize | prepend:"Hello " }}Hello Anna

การใช้งานเทมเพลต Liquid

Anchor link to

เทมเพลต Liquid สามารถใช้ได้ทั้งกับข้อความที่ส่งจากแผงควบคุม (Control Panel) และ คำขอ API

ใน Pushwoosh เทมเพลต Liquid สามารถใช้ได้กับทุกฟิลด์เนื้อหาของข้อความในทุกช่องทาง:

  • การแจ้งเตือนแบบพุช
  • อีเมล

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

ไปที่ Customer Journey Builder > Create Campaign > ลากและวางองค์ประกอบต่อไปนี้ลงบนผืนผ้าใบของคุณ: Audience-based Entry, Push (หรือ Email) และ Exit เชื่อมต่อองค์ประกอบต่างๆ จากนั้นคลิกที่ไอคอน Push เลือก Custom content และใส่ข้อความของคุณ

หากต้องการเพิ่มตรรกะของ Liquid ให้ใช้ค่าแท็กด้วยไวยากรณ์ต่อไปนี้:

{% if TagName == 'value' %}
เนื้อหาที่จะส่งในสถานการณ์นี้
{% else %}
เนื้อหาที่จะส่งในกรณีอื่น
{% endif %}

จากนั้นคลิก Apply

ตัวแปรเทมเพลต (แท็กของ Pushwoosh) ไม่ควรมีช่องว่างและควรมีเฉพาะค่าที่เป็นตัวอักษรและตัวเลขและขีดล่างเท่านั้น เช่น my_tag หรือ myTag แทนที่จะเป็น My Tag

เรียนรู้เพิ่มเติมเกี่ยวกับเทมเพลต Liquid ใน Journeys

Connected content (เนื้อหาที่เชื่อมต่อ)

Anchor link to

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

กรณีการใช้งานที่สำคัญ

Anchor link to
  • คำแนะนำผลิตภัณฑ์: แสดงรายการผลิตภัณฑ์ที่ปรับให้เหมาะกับผู้ใช้แต่ละคน

  • รหัสโปรโมชั่น: แทรกรหัสโปรโมชั่นที่ไม่ซ้ำกันซึ่งสร้างโดยบริการแบ็กเอนด์

ข้อกำหนดเบื้องต้น

Anchor link to
  • ในการใช้ Connected Content คุณต้องมีบริการแบ็กเอนด์ของคุณเองที่สร้างและให้ข้อมูลที่จำเป็น (เช่น รหัสโปรโมชั่น, คำแนะนำผลิตภัณฑ์) โดยอิงจาก User ID, HWID, หรือแท็กที่กำหนดเอง จากนั้น Pushwoosh จะดึงข้อมูลนี้ก่อนที่จะส่งข้อความ

คู่มือการใช้งานทีละขั้นตอน

Anchor link to

ขั้นตอนที่ 1. ตั้งค่าบริการแบ็กเอนด์

Anchor link to

บริการแบ็กเอนด์ควร:

  • รับคำขอที่มีพารามิเตอร์เฉพาะของผู้ใช้ (เช่น userId) Connected Content รองรับ UserID, HWID หรือแท็กที่กำหนดเองที่คุณได้ตั้งค่าไว้ในโปรเจกต์ของคุณ
  • ส่งคืนการตอบกลับเป็น JSON พร้อมข้อมูลที่ต้องการ จากนั้นเนื้อหานี้สามารถแทรกลงในข้อความแบบไดนามิกได้

ขั้นตอนที่ 2. สร้างพรีเซ็ตด้วย Connected content ใน Pushwoosh

Anchor link to
  1. ใน ตัวแก้ไขเนื้อหาพุช หรือ ตัวแก้ไขอีเมลแบบลากและวาง ให้แทรกไวยากรณ์ Connected Content ลงในฟิลด์ข้อความ

ตัวอย่าง

{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :save result %}

การแบ่งส่วนไวยากรณ์

connected_contentดึงข้อมูล JSON จาก URL แบ็กเอนด์ที่ระบุ
http://your-backend-url.comเอ็นด์พอยต์ของแบ็กเอนด์ที่ส่งคืนข้อมูลที่ต้องการในรูปแบบ JSON
userId={{ ${userid} }}พารามิเตอร์คิวรีแบบไดนามิกที่ส่ง ID ผู้ใช้ไปยังแบ็กเอนด์
:save resultจัดเก็บการตอบกลับ JSON ที่ดึงมาในตัวแปร result เพื่อใช้ในเทมเพลต Liquid

แทรกไวยากรณ์ Connected Content

การยืนยันตัวตน (ทางเลือก)

หากบริการแบ็กเอนด์ของคุณต้องการการยืนยันตัวตน คุณสามารถรวม API key หรือ token ไว้ในคำขอ Connected Content เพื่อให้แน่ใจว่าการเข้าถึงมีความปลอดภัย

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}&auth=YOUR_API_KEY :save result %}

การใช้แท็กใน Connected content

หากต้องการรวมแท็กที่กำหนดเอง ให้แทรกเป็นพารามิเตอร์ของคิวรีในคำขอ Connected Content ({{ tag_name }})

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}{{ Language }} :save result %}
  1. จากนั้น เพิ่มข้อความของข้อความที่รวม ข้อมูลที่ดึงมา ดังนี้:
เฮ้ {{userid}} รับรหัสโปรโมชั่นส่วนตัวของคุณ - {{result.code}}

เพิ่มข้อความของข้อความพร้อม ข้อมูลที่ดึงมา

  1. หลังจากสรุปเนื้อหาของข้อความและกำหนดการตั้งค่าพรีเซ็ตแล้ว ให้บันทึกเพื่อนำไปใช้ในแคมเปญต่างๆ

ส่งข้อความด้วย Connected content

ขั้นตอนที่ 3. ส่งข้อความโดยใช้พรีเซ็ตที่กำหนดค่าไว้

Anchor link to

ส่งข้อความด้วยพรีเซ็ตนี้โดยใช้ พุชแบบครั้งเดียว หรือ ฟอร์มอีเมล หรือ Customer Journey