เทมเพลต Liquid

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

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

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

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

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

ไวยากรณ์

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

หมายเหตุ

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับไวยากรณ์ โปรดดูที่ เอกสาร Liquid

Objects

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

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

Input

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

Output

Hi Anna! We’re glad you’re back!

Tags

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

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

Input

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

Output (fr)

Salut!

Output (es)

Hello!

Tags operators

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

หมายเหตุ

ใน tags ที่มีตัวดำเนินการ and หรือ or มากกว่าหนึ่งตัว ตัวดำเนินการจะถูกตรวจสอบตามลำดับ จากขวาไปซ้าย คุณไม่สามารถเปลี่ยนลำดับการดำเนินการโดยใช้วงเล็บได้ — วงเล็บเป็นอักขระที่ไม่ถูกต้องใน Liquid และจะทำให้ tags ของคุณไม่ทำงาน

ฟิลเตอร์

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

Input

{{ Name | capitalize | prepend:"Hello " }}

Output

Hello Anna

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

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

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

• Push notifications
• Emails

หากต้องการเพิ่มเทมเพลต Liquid ลงในข้อความของคุณ ให้แทรกลงในเนื้อหาของข้อความ คุณสามารถทำได้เมื่อทำงานกับองค์ประกอบ 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) ไม่ควรมีช่องว่างและควรมีเฉพาะค่าที่เป็นตัวอักษรและตัวเลขและขีดล่างเท่านั้น เช่น my_tag หรือ myTag แทนที่จะเป็น My Tag

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

เคล็ดลับ

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

Connected content

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

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

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

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

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

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

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

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

คุณจะต้องได้รับความช่วยเหลือจากทีมพัฒนาของคุณเพื่อใช้ Connected content แบ่งปันคู่มือนี้กับพวกเขาเพื่อเริ่มต้น

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

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

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

วิธีการทำงาน

บริการแบ็กเอนด์ทำหน้าที่เป็นผู้ให้บริการข้อมูล โดยตอบสนองต่อคำขอ HTTP ด้วยข้อมูลเฉพาะของผู้ใช้

1. Pushwoosh ส่งคำขอไปยังแบ็กเอนด์ของคุณ โดยส่งตัวระบุเฉพาะของผู้ใช้เป็นพารามิเตอร์การสืบค้น
2. แบ็กเอนด์ของคุณประมวลผลคำขอและดึงข้อมูลที่ร้องขอ
3. แบ็กเอนด์ของคุณส่งคืนการตอบกลับเป็น JSON
4. ก่อนที่จะส่งข้อความ Pushwoosh จะดึงการตอบกลับ JSON จากบริการแบ็กเอนด์และใช้ค่าที่ส่งคืน (เช่น code) ในเนื้อหาข้อความแบบไดนามิก

ตัวอย่างการตอบกลับ

{ "code": "SPECIALOFFERFORUSER12345" }

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

1. ใน Push editor หรือ Email content editor ให้แทรกไวยากรณ์ 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

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

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

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

คุณยังสามารถส่งข้อมูลการรับรองความถูกต้อง (หรือข้อมูลอื่นๆ) เป็น HTTP headers โดยใช้พารามิเตอร์ :headers ที่เป็นทางเลือก ซึ่งเป็นอ็อบเจกต์ JSON ของชื่อและค่าของ header

{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :headers {"Authorization": "Bearer YOUR_TOKEN", "X-Api-Key": "YOUR_API_KEY"} :save result %}

:headers {...}	อ็อบเจกต์ JSON ของ HTTP headers ที่ส่งไปพร้อมกับคำขอ เช่น Authorization: Bearer <token>

เฉพาะค่าคงที่เท่านั้น

ตัวแปรการปรับแต่ง ${} ทำงานได้เฉพาะภายใน URL เท่านั้น ค่าภายใน :headers เป็นค่าคงที่และไม่มีการประมาณค่า

เก็บข้อมูลรับรองไว้นอก URL

ควรใช้ :headers แทนพารามิเตอร์การสืบค้น URL (เช่น &auth=YOUR_API_KEY) สำหรับ API keys และ tokens: หากการดึงข้อมูลล้มเหลว URL ของคำขอจะถูกเขียนลงในบันทึก ซึ่งจะเปิดเผย key ที่วางไว้ที่นั่น ค่าภายใน :headers จะไม่ถูกบันทึก

Connected content ยังต้องการให้เปิดใช้งานเทมเพลตเนื้อหา Liquid สำหรับบัญชีของคุณ หากไม่ได้เปิดใช้งาน connected_content tag ทั้งหมด — รวมถึง key ใดๆ ที่อยู่ภายใน — จะถูกส่งไปยังผู้รับทุกคนเป็นข้อความตามตัวอักษรแทนที่จะถูกแสดงผล ติดต่อ ฝ่ายสนับสนุนของ Pushwoosh หากคุณไม่แน่ใจว่าบัญชีของคุณเปิดใช้งานสิ่งนี้หรือไม่

การใช้ tags ใน Connected content

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

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

2. ถัดไป เพิ่มข้อความโดยรวม ข้อมูลที่ดึงมา ดังนี้:

Hey, {{userid}}, grab your personal promo code - {{result.code}}

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

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

ส่งข้อความด้วย preset นี้โดยใช้ one-time push หรือ email form หรือ customer journey

สำคัญ

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