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

เทมเพลต Liquid

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

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

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

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

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

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

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

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

Hi {{Name}}! We're glad you're back!

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

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

อินพุต:

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

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

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

Tags operators

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

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

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

การใช้งาน Liquid templates

Anchor link to

Liquid templates สามารถใช้ได้กับทั้งข้อความที่ส่งจาก Control Panel และ คำขอ API

ใน Pushwoosh, Liquid templates สามารถใช้ได้กับทุกช่องเนื้อหาของข้อความในทุกแชนเนล:

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

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

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

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

{% if TagName == 'value' %}
Content to send in this scenario
{% else %}
Content to send otherwise
{% endif %}

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

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

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

Connected content

Anchor link to

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

กรณีการใช้งานหลัก

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

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

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

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

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

Anchor link to

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

Anchor link to

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

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

ขั้นตอนที่ 2 สร้าง Preset ด้วย Connected content ใน Pushwoosh

Anchor link to
  1. ใน เครื่องมือแก้ไขเนื้อหา Push หรือ Email ให้แทรกไวยากรณ์ของ 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} }}พารามิเตอร์การสืบค้นแบบไดนามิกที่ส่ง User ID ไปยังแบ็กเอนด์
:save resultจัดเก็บการตอบกลับ JSON ที่ดึงมาได้ในตัวแปร result เพื่อใช้ใน Liquid templates

Insert the Connected Content syntax

การรับรองความถูกต้อง (ไม่บังคับ)

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

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

การใช้ Tags ใน Connected content

หากต้องการรวม custom tags ให้แทรกเป็นพารามิเตอร์การสืบค้นในคำขอ Connected Content ({{ tag_name }})

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}{{ Language }} :save result %}
  1. จากนั้น เพิ่มข้อความของข้อความโดยรวม ข้อมูลที่ดึงมา ดังนี้:
Hey, {{userid}}, grab your personal promo code - {{result.code}}

Add the message text with the retrieved data

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

Send a message with connected content

ขั้นตอนที่ 3 ส่งข้อความโดยใช้ Preset ที่กำหนดค่าไว้

Anchor link to

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