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

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

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

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

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

ไวยากรณ์

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

หมายเหตุ

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

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

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

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

อินพุต

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

เอาต์พุต

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

แท็ก (Tags)

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

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

อินพุต

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

เอาต์พุต (fr)

Salut!

เอาต์พุต (es)

Hello!

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

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

หมายเหตุ

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

ฟิลเตอร์ (Filters)

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

อินพุต

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

เอาต์พุต

Hello Anna

การใช้เทมเพลต Liquid ในข้อความที่ส่งผ่าน API

ใช้ไวยากรณ์ Liquid ในคำขอ createMessage ของคุณเพื่อใช้งานเทมเพลต Liquid เทมเพลตสามารถใช้ได้กับพารามิเตอร์ “content” ของคำขอ createMessage รวมถึงพารามิเตอร์อื่นๆ ที่รองรับ Dynamic Content โดยเฉพาะพารามิเตอร์เฉพาะแพลตฟอร์มอย่าง “title”, “subtitle” และ “image”

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

หมายเหตุ

โปรดทราบว่าไม่เหมือนกับ Dynamic Content ตัวแปรในเทมเพลตควรอยู่ในวงเล็บปีกกาคู่ดังนี้: {{myVariable}}

เพื่อกำหนดตรรกะของเทมเพลตโดยใช้ Tags ที่มีช่องว่างในชื่อ ให้ใช้เทคนิคต่อไปนี้:

ตัวอย่าง

{% capture my_tag %}{{My Tag}}{% endcapture %}
{% if my_tag == 'value' %}
Content to send in this case
{% else %}
Content to send otherwise
{% endif %}

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

ที่นี่คุณจะพบกรณีการใช้งานหลายกรณีที่เทมเพลต Liquid มีประโยชน์

พุชหลายภาษา

เทมเพลต Liquid ทำให้สามารถระบุได้อย่างชัดเจนว่าผู้ใช้ควรได้รับข้อความพุชของคุณในภาษาใด ดูตัวอย่างง่ายๆ ของคำขอ API และข้อความที่ได้รับขึ้นอยู่กับ template bindings ที่ใช้ในคำขอ

อินพุต Liquid

{% if Language == 'es' %}
¡Hola!
{% else %}
Hello!
{% endif %}

คำขอ API

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh app code
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if language == 'es' %}¡Hola!{% else %}hello!{% endif %}
{% endraw %}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "language" : "es"
        }
      }
    ]
  }
}

เอาต์พุต

ภาษาคือ ‘es’: ¡Hola!

ภาษาคือ ‘en’: Hello!

ข้อความแจ้งให้อัปเกรดการสมัครสมาชิก

กระตุ้นให้ลูกค้าของคุณอัปเกรดการสมัครสมาชิกตามแผนปัจจุบันของพวกเขา

อินพุต Liquid

{% if Subscription == 'Basic' %}
    Upgrade to Silver for getting more product features and 24/7 support.
{% elsif Subscription == 'Silver' %}
    Upgrade to Gold for priority support and advanced features.
{% else %}
    Please contact your manager to renew your subscription.
{% endif %}

คำขอ API

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh app code
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if Subscription == 'Basic' %}Upgrade to Silver for getting more product features and 24/7 support.{% elsif Subscription == 'Silver' %}Upgrade to Gold for priority support and advanced features.{% else %}Please contact your manager to renew your subscription. {% endif %}
{% endraw %}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "language" : "es"
        }
      }
    ]
  }
}

เอาต์พุต

สำหรับผู้ใช้ที่มีแผนการสมัครสมาชิก Basic: Upgrade to Silver for getting more product features and 24/7 support.

สำหรับผู้ใช้ที่มีแผนการสมัครสมาชิก Silver: Upgrade to Gold for priority support and advanced features.

สำหรับผู้ใช้ที่มีแผนอื่นๆ: Please contact your manager to renew your subscription.

แท็กประเภทรายการ (List tags)

เทมเพลตเนื้อหามีประโยชน์อย่างมากในการจัดการ Tags ประเภท List

ขนาดของตัวแปร

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

อินพุต Liquid

{% if WishList.size >= 3 %}
Get 20% off your next purchase!
{% elsif WishList.size == 2 %}
Get a 10% discount on your next purchase!
{% else %}
Hey, take a look at new outwears!
{% endif %}

คำขอ API

{
  "request": {
    "application": "XXXXX-XXXXX", // Pushwoosh app code
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if WishList.size >= 3 %}Get 20% off your next purchase!{% elsif WishList.size == 2 %}Get a 10% discount on your next purchase!{% else %}Hey, take a look at new outwears!{% endif %}
{% endraw %}",
        "template_bindings": {
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

ขนาด WishList ≥ 3

ขนาด WishList = 2

ตัวแปรมีค่า

อีกกรณีหนึ่งที่คุณอาจต้องจัดการคือการจัดการกับค่าของ List Tags และส่งเนื้อหาที่เกี่ยวข้องที่สุดตามค่าที่ Tag มี

อินพุต Liquid

{% if WishList contains 'Skinny Low Ankle Jeans' %}
Get 20% off products in your wishlist!
{% else %}
Hey, take a look at the brand new Skinny Low Ankle Jeans!
{% endif %}

คำขอ API

{
  "request": {
    "application": "C90C0-0E786",
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "{% raw %}
{% if WishList contains 'Skinny Low Ankle Jeans' %}Get 20% off your next purchase!{% else %}Hey, take a look at the brand new Skinny Low Ankle Jeans!{% endif %}
{% endraw %}",
        "template_bindings": {
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

ตัวแปรมีข้อมูล

ตัวแปรไม่มีข้อมูล

รูปพหูพจน์

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

อินพุต Liquid

    Get 20% off item
{% if WishList.size > 1 %}
    s in your WishList!
{% else %}
    in your Wishlist!
{% endif %}

คำขอ API

{
  "request": {
    "application": "C90C0-0E786",
    "auth": "yxoPUlw.....IyEX4H", // API access token from Pushwoosh Control Panel
    "notifications" : [ // push message parameters
      {
       "content": "Get 20% off item{% raw %}
{% if WishList.size > 1 %}s in your WishList!{% else %} in your Wishlist!{% endif %}
{% endraw %}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "WishList" : ["Skinny Low Ankle Jeans", "Linen Trenchcoat", "High Waisted Denim Skirt", "Strappy Tiered Maxi Dress"]
        }
      }
    ]
  }
}

พหูพจน์

เอกพจน์

ไทม์โซน

เทมเพลตสำหรับไทม์โซนจะแปลงวันที่และเวลาตามไทม์โซนที่ระบุ

อินพุต Liquid

{{ MyDate | timezone: MyTimezone | date: \"%Y-%m-%d %H:%M\" }}

คำขอ API

Example

{
  "request" : {
    "auth" : "3H9bk8w3.....Acge2RbupTB", // API access token from Pushwoosh Control Panel
    "application" : "XXXXX-XXXXX", // Pushwoosh app code
    "notifications" : [ // push message parameters
      {
        "content": "Current Date: {{ MyDate | timezone: MyTimezone | date: \"%Y-%m-%d %H:%M\" }}",
        "template_bindings": { // optional. When no template_bindings are passed in a request, Tag values from the device are used.
         "MyDate" : "2019-07-23 15:00",
         "MyTimezone" : "Asia/Dubai"
        }
      }
    ]
  }
}

เอาต์พุต

Connected content

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{ "code": "SPECIALOFFERFORUSER12345" }

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

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

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

หากบริการแบ็กเอนด์ของคุณต้องการการรับรองความถูกต้อง คุณสามารถรวม API key หรือ token ไว้ในคำขอ 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 %}

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

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

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

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

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

สำคัญ

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