ดึงข้อมูลตัวเลือกสินค้า
ในเวิร์กโฟลว์ที่ใช้ข้อมูลตัวเลือกสินค้า คุณสามารถใช้แอ็กชัน ดึงข้อมูลตัวเลือกสินค้า เพื่อดึงข้อมูลตัวเลือกสินค้าจากร้านค้าของคุณได้
การกำหนดค่า
ฟิลด์
แอ็กชัน ดึงข้อมูลตัวเลือกสินค้า ประกอบด้วยฟิลด์ดังต่อไปนี้ที่ใช้สร้างคำค้นหา
| ฟิลด์ | คำอธิบาย |
|---|---|
| จัดเรียงข้อมูลตาม | จำเป็นต้องระบุ พารามิเตอร์ที่ใช้จัดเรียงข้อมูลที่ส่งคืนโดยคำค้นหา |
| จำนวนผลลัพธ์สูงสุด | จำเป็นต้องระบุ จำนวนผลลัพธ์สูงสุดที่คำค้นหาที่คุณเลือกสามารถส่งคืนได้ คุณสามารถส่งคืนได้สูงสุด 100 รายการต่อครั้ง |
| คำค้นหา | จำเป็นต้องระบุ เลือกจากคำค้นหาทั่วไป หรือเลือกขั้นสูงเพื่อสร้างคำค้นหาของคุณเอง |
สตริงคำค้นหา
นี่คือตัวอย่างคำค้นหาสำหรับดึงข้อมูลตัวเลือกสินค้าที่อัปเดตในวันล่าสุดดังนี้
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'ตัวแปร updated_at คือตัวกรองที่ใช้ได้ในคำค้นหาตัวเลือกสินค้า และสามารถใช้ซ้ำหลายครั้งหรือใช้ร่วมกับตัวแปรอื่นๆ ได้ ตัวแปร Liquid scheduledAt จะมีให้ใช้งานในเวิร์กโฟลว์ที่ใช้ทริกเกอร์เวลาที่กำหนด แท็ก Liquid date_minus เป็นแท็กพิเศษของ Flow ที่ให้คุณลบเวลาออกจากวันที่ได้
เมื่อทำการค้นหาข้อมูล สิ่งที่ควรทราบมีดังนี้
- รายการตัวกรองตัวเลือกสินค้าที่ใช้ได้
- คำค้นหาต้องเป็นไปตามไวยากรณ์ที่กำหนด
- ค่าของฟิลด์คำค้นหาอาจไม่มีระบุไว้ในเอกสารเสมอไป ในบางกรณี คุณสามารถดูค่าเหล่านี้ได้จากเอกสาร API หรืออีกทางเลือกหนึ่งคือ คุณมักจะพบค่าของฟิลด์ได้ใน URL ในส่วนผู้ดูแลเมื่อคุณใช้ตัวกรอง ตัวอย่างเช่น หากต้องการหาค่าคำค้นหาของคำสั่งซื้อบางรายการ ให้กรองหน้าคำสั่งซื้อในส่วนผู้ดูแล จากนั้นจึงตรวจสอบ URL
- คุณสามารถรันหรือทดสอบคำค้นหาในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL
- โปรดระวังสิ่งที่เกิดขึ้นหากคำค้นหาของคุณล้มเหลว บ่อยครั้งที่ API จะส่งคืนผลลัพธ์ทั้งหมด (แทนที่จะไม่ส่งคืนเลย)
ข้อมูลที่ส่งคืน
แอ็กชันดึงข้อมูลทั้งหมดจะส่งคืนรายการทรัพยากรตั้งแต่ 0 ถึง 100 รายการ คุณอาจต้องการใช้ข้อมูลนี้ในรูปแบบต่างๆ กันไป ขึ้นอยู่กับกรณีการใช้งานของคุณ โดยมีตัวอย่างดังนี้
- หากคุณต้องการจัดการแต่ละรายการในลิสต์แยกกัน เช่น การเพิ่มแท็กสำหรับแต่ละรายการ คุณก็สามารถใช้แอ็กชัน วนลูปต่อรายการ ได้
- หากคุณต้องการรวบรวมข้อมูล เช่น นับจำนวนผลลัพธ์ที่ส่งคืนมา คุณก็สามารถใช้แอ็กชัน นับ หรือ หาผลรวม ได้
- หากคุณต้องการเอาท์พุตเป็นรายการ เช่น การอีเมลพร้อมรายการทั้งหมด คุณก็สามารถใช้ข้อมูลที่ส่งคืนมาได้โดยตรงในแอ็กชันถัดๆ ไป
หากต้องการเข้าถึงข้อมูลที่ส่งคืนมาในขั้นตอนที่ตามหลังแอ็กชันนี้ ให้ใช้ตัวแปรชื่อ Get product variant data ซึ่งเป็นรายการของตัวเลือกสินค้า คุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและแอ็กชัน ตัวอย่างเช่น คุณสามารถส่งรายการคำสั่งซื้อในแอ็กชัน ส่งอีเมลภายใน ได้ดังนี้
{% for single_variant in GetProductVariantData %}
* {{ single_variant.name }}
{% endfor %}ทริกเกอร์
คุณสามารถใช้การดำเนินการนี้ในเวิร์กโฟลว์ใดก็ได้ รวมถึงทริกเกอร์เวลาที่กำหนดไว้ ในเวิร์กโฟลว์ที่ใช้ทริกเกอร์เวลาที่กำหนดไว้ เวิร์กโฟลว์จะเริ่มทำงานตามเวลาที่คุณระบุไว้แทนที่จะเริ่มทำงานจากเหตุการณ์ เนื่องจากเวิร์กโฟลว์ไม่ได้เริ่มต้นจากเหตุการณ์ที่เฉพาะเจาะจงในร้านค้าของคุณหรือจากแอป จึงไม่มีข้อมูลใดรวมอยู่ด้วยโดยอัตโนมัติ
รายละเอียด API
เทมเพลต
เพิ่มรายการฟรี (ลดราคา 100%) ไปยังคำสั่งซื้อใหม่
เทมเพลตนี้จะเพิ่มรายการฟรีไปยังคำสั่งซื้อใหม่หากรายการนั้นมีอยู่ในสต็อก เทมเพลตจะตรวจสอบสินค้าคงคลัง ใช้ส่วนลด 100% และอัปเดตคำสั่งซื้อโดยไม่แจ้งให้ลูกค้าทราบ การทำงานอัตโนมัตินี้จะมีประโยชน์ในการ (1) เพิ่มความพึงพอใจของลูกค้าด้วยการเพิ่มของแถมที่ไม่คาดคิดลงในคำสั่งซื้อ (2) โปรโมตสินค้าใหม่หรือสินค้าที่ไม่เป็นที่รู้จักมากนักโดยการเพิ่มเป็นสินค้าตัวอย่างฟรีในคำสั่งซื้อ หรือ (3) ทำให้โปรโมชันมีความคล่องตัวขึ้นด้วยการเพิ่มและให้ส่วนลดรายการฟรีโดยอัตโนมัติ ดูเทมเพลต
ส่งอีเมลสรุปรายสัปดาห์พร้อมรายชื่อตัวเลือกสินค้าที่ใกล้จะหมดสต็อก
เวิร์กโฟลว์นี้ทำงานตามกำหนดเวลา (เช่น สัปดาห์ละครั้ง) เวิร์กโฟลว์จะดึงรายการตัวเลือกสินค้าที่ใกล้จะหมดสต็อก นับจำนวนผลลัพธ์ แล้วส่งอีเมลสรุปที่มีชื่อตัวเลือกสินค้าและลิงก์ไปยังหน้าแผงผู้ดูแลสำหรับตัวเลือกสินค้านั้น ดูเทมเพลต