เทมเพลต Liquid

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

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

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

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

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

ไวยากรณ์

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

หมายเหตุ

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

Objects

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

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

อินพุต

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

เอาต์พุต

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

Tags

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

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

อินพุต

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

เอาต์พุต (fr)

Salut!

เอาต์พุต (es)

Hello!

ตัวดำเนินการ Tags

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

หมายเหตุ

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

Filters

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

อินพุต

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

เอาต์พุต

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 ให้ใช้ค่าแท็กด้วยไวยากรณ์ต่อไปนี้:

{% 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. สร้างพรีเซ็ตด้วย Сonnected content ใน Pushwoosh

1. ใน Push หรือ 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} }}	พารามิเตอร์เคียวรีแบบไดนามิกที่ส่ง User 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 ที่เป็นทางเลือก ซึ่งเป็นอ็อบเจกต์ JSON ของชื่อและค่าส่วนหัว

{% 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 ที่ส่งไปพร้อมกับคำขอ เช่น Authorization: Bearer <token>

ค่าคงที่เท่านั้น

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

การใช้แท็กใน 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. หลังจากสรุปเนื้อหาข้อความและกำหนดการตั้งค่าพรีเซ็ตแล้ว ให้บันทึกไว้เพื่อนำกลับมาใช้ใหม่ในแคมเปญ

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

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

สำคัญ

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