รับข้อมูลการวิเคราะห์
การดำเนินการ รับข้อมูลการวิเคราะห์ จะรันคิวรี ShopifyQL แล้วส่งคืนผลลัพธ์เพื่อนำไปใช้ในเวิร์กโฟลว์ของคุณ ShopifyQL เป็นภาษาแบบสอบถามที่สร้างขึ้นสำหรับการวิเคราะห์อีคอมเมิร์ซ คุณสามารถใช้ภาษานี้รวบรวมตัวชี้วัดในช่วงเวลาต่างๆ ใช้ตัวกรอง และจัดกลุ่มตามมิติข้อมูลได้ เช่น สินค้า คอลเลกชัน หรือลูกค้า ข้อมูลที่ส่งคืนจากการดำเนินการนี้จะใช้งานได้กับเงื่อนไขและการดำเนินการในขั้นตอนถัดไป
ทริกเกอร์
การดำเนินการ รับข้อมูลการวิเคราะห์ ใช้ได้กับทริกเกอร์เวลาที่กำหนดไว้เท่านั้น ข้อมูลการวิเคราะห์จะไม่รวมอยู่ในทริกเกอร์ตามเหตุการณ์
การกำหนดค่า
ช่อง
การดำเนินการ รับข้อมูลการวิเคราะห์ มีช่องต่อไปนี้
| ช่อง | คำอธิบาย |
|---|---|
| คิวรี ShopifyQL | ต้องระบุ คิวรี ShopifyQL สำหรับรันกับข้อมูลการวิเคราะห์ในร้านค้าของคุณ |
คิวรี ShopifyQL
คุณสามารถเขียนคิวรี ShopifyQL ที่ถูกต้องโดยใช้สคีมาที่รองรับได้ เช่น sales, sessions, inventory และ payments ตัวอย่างเช่น คิวรีต่อไปนี้จะส่งคืนยอดขายทั้งหมดและจำนวนลูกค้าในวันที่รันเวิร์กโฟลว์
FROM sales
SHOW total_sales, customers
SINCE todayสำหรับข้อมูลอ้างอิงภาษาฉบับเต็ม รวมถึงสคีมา ฟังก์ชัน และไวยากรณ์ที่รองรับ โปรดดูเอกสารประกอบของ ShopifyQL
ระบบจะตรวจสอบคิวรีเมื่อคุณบันทึกเวิร์กโฟลว์ และจะไม่สามารถเปิดใช้งานเวิร์กโฟลว์ได้จนกว่าคิวรีจะรันในร้านค้าของคุณสำเร็จ
ข้อมูลที่ส่งคืน
การดำเนินการ รับข้อมูลการวิเคราะห์ จะส่งคืนแถวที่ตรงกับคิวรีของคุณ ซึ่งใช้งานได้เป็นตัวแปรชื่อ getAnalyticsData แถวเหล่านี้จะจัดเก็บไว้ใน getAnalyticsData.rows โดยที่แต่ละแถวจะเป็นอ็อบเจ็กต์ที่อ้างอิงตามชื่อคอลัมน์ในคิวรีของคุณ
คุณสามารถใช้ตัวแปรนี้ได้ในเงื่อนไขและการดำเนินการในขั้นตอนถัดไป ตัวอย่างเช่น หากต้องการส่งอีเมลภายในที่มีรายการในแต่ละแถว คุณสามารถใช้ Liquid ในลักษณะที่คล้ายกับต่อไปนี้
{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}หากต้องการจัดการแต่ละแถวแยกกัน เช่น นำการดำเนินการไปใช้กับแต่ละแถว คุณสามารถใช้การดำเนินการ ลูป For each (วนซ้ำ) กับ getAnalyticsData.rows ได้ และหากต้องการรวบรวมค่า เช่น นับจำนวนแถวหรือรวมคอลัมน์ คุณสามารถใช้การดำเนินการ นับ และ ผลรวม ได้
ข้อมูลอ้างอิง API
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ API ที่ใช้ในการดำเนินการนี้ โปรดดูคิวรี shopifyqlQuery ใน GraphQL Admin API
ความซับซ้อนของคิวรี
คิวรี ShopifyQL แต่ละรายการจะมีค่าความซับซ้อนที่คำนวณจากสคีมา คอลัมน์ ตัวกรอง และช่วงเวลาที่คิวรีนั้นใช้ หากคิวรีเกินขีดจำกัดความซับซ้อน การดำเนินการจะล้มเหลวและจะไม่สามารถเปิดใช้งานเวิร์กโฟลว์ได้ คุณสามารถลดค่าความซับซ้อนของคิวรีได้โดยการทำให้ช่วงเวลาสั้นลง ลบคอลัมน์ หรือลบการเชื่อมโยงออก
สำหรับรายละเอียดเกี่ยวกับวิธีการคำนวณค่าความซับซ้อนของคิวรีและขีดจำกัดในปัจจุบัน โปรดดูที่การจำกัดอัตราใน ShopifyQL Admin API