ანალიტიკის მონაცემების მიღება
ქმედება Get analytics data უშვებს ShopifyQL მოთხოვნას და აბრუნებს შედეგებს შენს სამუშაო პროცესში გამოსაყენებლად. ShopifyQL არის მოთხოვნის ენა, რომელიც შექმნილია კომერციის ანალიტიკისთვის. შენ შეგიძლია მისი გამოყენება დროის პერიოდებში მეტრიკების აგრეგაციისთვის, ფილტრების გამოსაყენებლად და ისეთი განზომილებების მიხედვით დასაჯგუფებლად, როგორიცაა პროდუქტი, კოლექცია ან მომხმარებელი. ამ ქმედების მიერ დაბრუნებული მონაცემები ხელმისაწვდომია პირობებისა და ქმედებებისთვის, რომლებიც მოსდევს ამ ნაბიჯს.
ტრიგერები
ქმედება Get analytics data თავსებადია მხოლოდ Scheduled time ტრიგერთან. ანალიტიკის მონაცემები არ არის ჩართული მოვლენაზე დაფუძნებული ტრიგერების მიერ.
კონფიგურაცია
ველები
ქმედება Get analytics data შეიცავს შემდეგ ველს:
| ველი | აღწერილობა |
|---|---|
| ShopifyQL-ის მოთხოვნა | აუცილებელია. შენი მაღაზიის ანალიტიკის მონაცემებზე გასაშვები ShopifyQL მოთხოვნა. |
ShopifyQL-ის მოთხოვნა
შენ შეგიძლია დაწერო ნებისმიერი ვალიდური ShopifyQL მოთხოვნა მხარდაჭერილი სქემების გამოყენებით, როგორიცაა sales, sessions, inventory და payments. მაგალითად, შემდეგი მოთხოვნა აბრუნებს მთლიან გაყიდვებსა და მომხმარებელთა რაოდენობას იმ დღისთვის, როცა სამუშაო პროცესი გაეშვება:
FROM sales
SHOW total_sales, customers
SINCE todayენის სრული ცნობარისთვის, მათ შორის მხარდაჭერილი სქემების, ფუნქციებისა და სინტაქსის ჩათვლით, იხილე ShopifyQL დოკუმენტაცია.
მოთხოვნა მოწმდება სამუშაო პროცესის შენახვისას. სამუშაო პროცესის აქტივაცია შეუძლებელია, სანამ მოთხოვნა წარმატებით არ გაეშვება შენს მაღაზიაში.
დაბრუნებული მონაცემები
ქმედება Get analytics data აბრუნებს შენს მოთხოვნასთან შესაბამის მწკრივებს, რომლებიც ხელმისაწვდომია როგორც ცვლადი სახელად getAnalyticsData. მწკრივები ინახება getAnalyticsData.rows-ში, სადაც თითოეული მწკრივი არის ობიექტი, რომელიც შენს მოთხოვნაში მოცემული სვეტების სახელებითაა შექმნილი.
შენ შეგიძლია ამ ცვლადის გამოყენება როგორც პირობებში, ისე ქმედებებში, რომლებიც მოსდევს ნაბიჯს. მაგალითად, შიდა ელფოსტის გასაგზავნად, სადაც ჩამოთვლილია თითოეული მწკრივი, შეგიძლია გამოიყენო Liquid-ი ამის მსგავსად:
{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}თითოეულ მწკრივთან ინდივიდუალურად მუშაობისთვის, მაგალითად, თითოეული მწკრივისთვის ქმედების გამოსაყენებლად, შეგიძლია გამოიყენო ქმედება For each loop (iterate) getAnalyticsData.rows-თან ერთად. მნიშვნელობების აგრეგაციისთვის, მაგალითად, მწკრივების დასათვლელად ან სვეტის ჯამის გამოსათვლელად, შეგიძლია გამოიყენო ქმედებები Count და Sum.
API ცნობარი
ამ ქმედებაში გამოყენებული API-ს შესახებ დამატებითი ინფორმაციისთვის იხილე მოთხოვნა shopifyqlQuery GraphQL Admin API-ში.
მოთხოვნის სირთულე
თითოეულ ShopifyQL მოთხოვნას აქვს სირთულის ღირებულება, რომელიც გამოითვლება სქემების, სვეტების, ფილტრებისა და იმ დროის დიაპაზონის მიხედვით, რომელსაც იყენებს მოთხოვნა. თუ მოთხოვნა გადააჭარბებს სირთულის ლიმიტს, ქმედება ვერ შესრულდება და სამუშაო პროცესი არ გააქტიურდება. მოთხოვნის ღირებულების შესამცირებლად შეგიძლია შეამცირო დროის დიაპაზონი, ამოიღო სვეტები ან ამოიღო შეერთებები.
დეტალებისთვის, თუ როგორ გამოითვლება მოთხოვნის ღირებულება და მიმდინარე ლიმიტები, იხილე სიხშირის შეზღუდვა ShopifyQL Admin API-ში.