รับข้อมูลลูกค้า
ในเวิร์กโฟลว์ที่ใช้ข้อมูลลูกค้า คุณสามารถใช้การดำเนินการ รับข้อมูลลูกค้า เพื่อดึงข้อมูลลูกค้าจากร้านค้าของคุณได้
การกำหนดค่า
ฟิลด์
การดำเนินการ รับข้อมูลลูกค้า มีฟิลด์ต่อไปนี้ ซึ่งใช้เพื่อสร้างคำค้นหา
| ฟิลด์ | คำอธิบาย |
|---|---|
| จัดเรียงข้อมูลตาม | จำเป็น พารามิเตอร์ที่ใช้จัดเรียงข้อมูลที่ส่งคืนโดยคำค้นหา |
| จำนวนผลลัพธ์สูงสุด | จำเป็น จำนวนผลลัพธ์สูงสุดที่คำค้นหาที่คุณเลือกจะสามารถส่งคืนได้ คุณสามารถส่งคืนได้สูงสุดครั้งละ 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 รายการ คุณอาจต้องการใช้ข้อมูลนี้ในรูปแบบต่างๆ โดยขึ้นอยู่กับกรณีการใช้งานของคุณ
- หากคุณต้องการจัดการแต่ละรายการในลิสต์แยกกัน เช่น การเพิ่มแท็กสำหรับแต่ละรายการ คุณสามารถใช้การดำเนินการ สำหรับแต่ละ ได้
- หากคุณต้องการรวบรวมข้อมูล เช่น การนับจำนวนผลลัพธ์ที่ส่งคืนมา คุณก็สามารถใช้การดำเนินการนับ หรือ ผลรวม ได้
- หากคุณต้องการเอาท์พุตรายการ เช่น การส่งอีเมลที่มีรายการทั้งหมด คุณสามารถใช้ข้อมูลที่ส่งคืนในการดำเนินการที่ตามมาได้โดยตรง
หากต้องการเข้าถึงข้อมูลที่ส่งคืนในขั้นตอนที่ตามหลังการดำเนินการนี้ ให้ใช้ตัวแปรชื่อ รับข้อมูลลูกค้า ซึ่งเป็นรายการของลูกค้า คุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและการดำเนินการ ตัวอย่างเช่น คุณสามารถส่งรายการคำสั่งซื้อในการดำเนินการส่งอีเมลภายในได้ในลักษณะนี้
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}ทริกเกอร์
คุณสามารถใช้การดำเนินการนี้ในเวิร์กโฟลว์ใดก็ได้ รวมถึงทริกเกอร์เวลาที่กำหนดไว้ ในเวิร์กโฟลว์ที่ใช้ทริกเกอร์เวลาที่กำหนดไว้ เวิร์กโฟลว์จะเริ่มทำงานตามเวลาที่คุณระบุไว้ แทนที่จะเริ่มจากผลลัพธ์ของเหตุการณ์ใดเหตุการณ์หนึ่ง เนื่องจากไม่มีเหตุการณ์เฉพาะในร้านค้าของคุณหรือจากแอปที่เริ่มเวิร์กโฟลว์ จึงไม่มีข้อมูลใดรวมอยู่โดยอัตโนมัติ
รายละเอียด API
เทมเพลต
แปลงเมตาฟิลด์ของลูกค้าเป็นแท็กสำหรับลูกค้าทั้งหมด
เวิร์กโฟลอนี้จะเติมแท็กให้กับลูกค้าของคุณทั้งหมดโดยอิงจากค่าเมตาฟิลด์ เวิร์กโฟลว์จะทำงานทุกชั่วโมงและดึงข้อมูลลูกค้าสูงสุด 100 รายที่ไม่มีแท็ก processed สำหรับลูกค้าแต่ละราย ระบบจะดูค่าของเมตาฟิลด์ custom.test และเพิ่มค่านั้นเป็นแท็ก นอกจากนี้ เวิร์กโฟลว์จะเพิ่มแท็ก processed เพื่อไม่ให้ข้อมูลของลูกค้ารายดังกล่าวถูกส่งคืนในการรันเวิร์กโฟลว์ตามกำหนดการครั้งถัดไป หากต้องการใช้เวิร์กโฟลว์นี้ คุณจะต้องเปลี่ยนเนมสเปซและคีย์ของเมตาฟิลด์ให้ตรงกับเมตาฟิลด์ในร้านค้าของคุณ ดูเทมเพลต
ลบลูกค้าที่ไม่มีการใช้งาน
ลบลูกค้าที่มีอายุเกิน 5 ปีและไม่เคยสั่งซื้อสินค้า ดูเทมเพลต