დახმარება
შესვლა

შეკვეთის მონაცემების მიღება

სამუშაო პროცესებში, რომლებიც საჭიროებს შეკვეთის მონაცემებს, შეგიძლია გამოიყენო შეკვეთის მონაცემების მიღების ქმედება შენი მაღაზიიდან შეკვეთის ინფორმაციის მისაღებად.

ამ გვერდზე

კონფიგურაცია

ველები

მოქმედება შეკვეთის მონაცემების მიღება (Get order data) შეიცავს შემდეგ ველებს, რომლებიც გამოიყენება მოთხოვნის შესაქმნელად:

მონაცემების მიღების (Get data) მოქმედებებში გამოყენებული ველები.
ველიაღწერა
მონაცემების დახარისხებასავალდებულოა. პარამეტრები, რომელთა მიხედვითაც ხარისხდება საძიებო მოთხოვნის მიერ დაბრუნებული მონაცემები.
შედეგების მაქსიმალური რაოდენობასავალდებულოა. შედეგების მაქსიმალური რაოდენობა, რომლის დაბრუნებაც შერჩეულ საძიებო მოთხოვნას შეუძლია. ერთ ჯერზე შეგიძლია დააბრუნო 100-მდე შედეგი.
მოთხოვნასავალდებულოა. აირჩიე სტანდარტული მოთხოვნებიდან ან შენის შესაქმნელად აირჩიე გაფართოებული.

მოთხოვნის სტრიქონი

ეს არის ბოლო დღის განმავლობაში განახლებული შეკვეთების მიღების მოთხოვნის მაგალითი:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

ცვლადი updated_at არის ფილტრი, რომელიც ხელმისაწვდომია შეკვეთების მოთხოვნაში (Orders query) და მისი გამოყენება შესაძლებელია რამდენჯერმე ან სხვა ცვლადებთან კომბინაციაში. Liquid ცვლადი scheduledAt ხელმისაწვდომია იმ სამუშაო პროცესებზე, რომლებმაც გამოიყენეს დაგეგმილი დროის ტრიგერი. Liquid-ის თეგი date_minus არის Flow-ს სპეციალური თეგი, რომელიც თარიღისთვის დროის გამოკლების საშუალებას გაძლევს.

მონაცემების მოთხოვნისას სასარგებლოა იცოდე, რომ:

  • შეკვეთის ხელმისაწვდომი ფილტრების სია
  • მოთხოვნები უნდა მიჰყვებოდეს გარკვეულ სინტაქსს
  • მოთხოვნის ველის მნიშვნელობები ყოველთვის დოკუმენტირებული არ არის. ზოგ შემთხვევაში მნიშვნელობების პოვნა შესაძლებელია API-ის დოკუმენტაციაში. ალტერნატიულად, ფილტრაციისას ხშირად შეგიძლია ველის მნიშვნელობები იპოვო URL-ებში ადმინ პანელში. მაგალითად, შეკვეთის მოთხოვნის ზოგიერთი მნიშვნელობის საპოვნელად, გაფილტრე „შეკვეთების“ გვერდი ადმინ პანელში და შემდეგ შეამოწმე URL.
  • შენს მაღაზიაში მოთხოვნის გაშვება ან ტესტირება შეგიძლია Shopify GraphiQL აპლიკაციის გამოყენებით.
  • გაითვალისწინე, რა მოხდება, თუ შენი მოთხოვნა წარუმატებელი აღმოჩნდება. ხშირად API დააბრუნებს ყველა შედეგს (ნაცვლად არცერთისა).

დაბრუნებული მონაცემები

ყველა მონაცემების მიღების (Get data) მოქმედება აბრუნებს 0-დან 100-მდე რესურსის სიას. შენი გამოყენების სცენარიდან გამომდინარე, შეიძლება ამ მონაცემების სხვადასხვა გზით გამოყენება დაგჭირდეს:

  • თუ სიის თითოეული ერთეულის ინდივიდუალურად დამუშავება გჭირდება, მაგალითად, თითოეულისთვის თეგის დამატება, მაშინ შეგიძლია გამოიყენო მოქმედება თითოეულისთვის (For each).
  • თუ მონაცემების აგრეგაცია გჭირდება, მაგალითად, რამდენი შედეგი დაბრუნდა ამის დასათვლელად, მაშინ შეგიძლია გამოიყენო მოქმედებები დათვლა (Count) ან ჯამი (Sum).
  • თუ სიის გამოტანა გჭირდება, მაგალითად, ყველა ერთეულის შემცველი ელფოსტის გასაგზავნად, მაშინ შეგიძლია დაბრუნებული მონაცემები პირდაპირ გამოიყენო შემდგომ მოქმედებებში.

ამ მოქმედების მომდევნო ნაბიჯებში დაბრუნებულ მონაცემებზე წვდომისთვის გამოიყენე ცვლადი სახელწოდებით შეკვეთის მონაცემების მიღება (Get order data), რომელიც წარმოადგენს შეკვეთების სიას. ამ ცვლადის გამოყენება შეგიძლია როგორც პირობებში, ისე მოქმედებებში. მაგალითად, შეგიძლია გააგზავნო შეკვეთების სია მოქმედებაში შიდა ელფოსტის გაგზავნა შემდეგნაირად:

{% for single_order in GetOrderData %}
* {{ single_order.name }}
{% endfor %}

ტრიგერები

ამ მოქმედების გამოყენება შეგიძლია ნებისმიერ სამუშაო პროცესში, მათ შორის ტრიგერში დაგეგმილი დრო (Scheduled time). სამუშაო პროცესში, რომელიც ტრიგერს დაგეგმილი დრო იყენებს, სამუშაო პროცესი იწყება შენ მიერ მითითებულ დროს და არა მოვლენის შედეგად. რადგან არ არსებობს კონკრეტული მოვლენა შენს მაღაზიაში ან აპლიკაციიდან, რომელიც იწყებს სამუშაო პროცესს, მონაცემები ავტომატურად არ დაერთვის.

API-ის დეტალები

შაბლონები

შეკვეთების გაუქმება ხშირი დაბრუნებების მქონე მომხმარებლებისთვის

აუქმებს იმ მომხმარებლების შეკვეთებს, რომლებმაც ბოლო ექვსი თვის განმავლობაში ერთეულები ხუთჯერ ან მეტჯერ დააბრუნეს. ის იღებს შეკვეთის მონაცემებს, ითვლის დაბრუნებებს და აუქმებს მიმდინარე შეკვეთას, აბრუნებს თანხას და ავსებს მარაგს. ამ შაბლონის გამოყენება შესაძლებელია: სისტემატური დამბრუნებლებისგან ზარალის შესამცირებლად, პოტენციური დაბრუნებების პრევენციული დამუშავებით შეკვეთების მართვის გასამარტივებლად და ჭარბი დაბრუნებების თავიდან აცილებით მომგებიანობის შესანარჩუნებლად. შაბლონის ნახვა

შეკვეთების გაუქმება, თუ მომხმარებელმა დღეს 5-ზე მეტი შეკვეთა განათავსა

აუქმებს შეკვეთებს, თუ მომხმარებელი ერთ დღეში ხუთზე მეტ შეკვეთას განათავსებს. ის ამოწმებს მომხმარებლის მიერ ბოლო 24 საათში განთავსებული შეკვეთების რაოდენობას და აუქმებს ამ ლიმიტის გადამეტებულ ნებისმიერ შეკვეთას, ამასთან მომხმარებელს პოტენციური თაღლითობის თეგს ანიჭებს. შაბლონის ნახვა

ჩარჯბექების მქონე მომხმარებლებისთვის შესასრულებელი შეკვეთების შეჩერება

როდესაც შეკვეთა შესასრულებლად მზადაა, სამუშაო პროცესი იღებს იმავე მომხმარებლის ნებისმიერ შეკვეთას ბოლო 60 დღის განმავლობაში, რომელსაც აქვს ჩარჯბექი. თუ ასეთი შეკვეთები არსებობს, ის აჩერებს თითოეული გზავნილის შეკვეთის შესრულებას და აგზავნის შიდა ელფოსტას შენი ოპერაციების განყოფილების გასაფრთხილებლად. შაბლონის ნახვა

შეკვეთის შესრულების შეჩერება, თუ მომხმარებელმა 24 საათში რამდენიმე შეკვეთა განათავსა

შეამოწმე, განათავსა თუ არა მომხმარებელმა რამდენიმე შეკვეთა 24-საათიან პერიოდში. თუ ასეა, შეაჩერე შეკვეთის შესრულება და გააერთიანე მიწოდება. შაბლონის ნახვა

შეკვეთების შეჩერება, თუ მომხმარებელმა ბოლო 24 საათში 1-ზე მეტი შეკვეთა განათავსა

როდესაც შეკვეთა შეიქმნება, შეამოწმე, განათავსა თუ არა მომხმარებელმა სხვა შეკვეთები ბოლო 24 საათში. თუ ასეა, ყველა შეკვეთა შეაჩერე. შაბლონის ნახვა

შეტყობინების გაგზავნა, როდესაც ბოლო საათში შეკვეთების მოცულობა 10-ზე ნაკლებია

აგზავნის შეკვეთების აქტივობის (heartbeat) შეტყობინებას. ყოველ საათში მიიღე 10-მდე შექმნილი შეკვეთა და დათვალე ისინი. თუ 10-ზე ნაკლებია, გააგზავნე შეტყობინება ელფოსტით. იყენებს ნაბიჯებს: დაგეგმილი დრო (Schedule time), შეკვეთის მონაცემების მიღება (Get order data) და დათვლა (Count). შაბლონის ნახვა

ბოლო დღის განმავლობაში ონლაინ მაღაზიაში განთავსებული ყველა შეკვეთის შეჯამების გაგზავნა ელფოსტით

ყოველდღიურად იღებს ბოლო დღის შეკვეთებს და ელფოსტით აგზავნის შეჯამებას იმ შეკვეთების შესახებ, რომლებიც ონლაინ მაღაზიაში განთავსდა. შაბლონის ნახვა

2 დღეზე ძველი ყველა შეუსრულებელი შეკვეთის შეჯამების ელფოსტით გაგზავნა

მიიღე ყველა იმ შეუსრულებელი შეკვეთის ყოველდღიური შეჯამება, რომელიც 2 დღეზე ძველია, განრიგების, შეკვეთის მონაცემების მიღების, დათვლისა და ჯამის ფუნქციების გამოყენებით. შაბლონის ნახვა

დაგვიანებული შესრულებების თეგირება და ყოველდღიური შეჯამების გაგზავნა

ყოველდღიურად მონიშნე თეგით და გააგზავნე ელფოსტით შეჯამება, რომელიც ითვლის იმ ყველა შეკვეთის საერთო რაოდენობას და დოლარში ღირებულებას, რომლებიც 2-დღიანი მიწოდების გარანტიას ვერ აკმაყოფილებენ. შაბლონის ნახვა

ჩარჯბექის მქონე მომხმარებლების თეგირება

ყოველ საათში ეს სამუშაო პროცესი იღებს შეკვეთებს ჩარჯბექებით და მომხმარებელს ამატებს თეგს შეკვეთისთვის. იყენებს დაგეგმილი დროის ტრიგერს, შეკვეთის მონაცემების მიღებას და for each ციკლს. შაბლონის ნახვა

2 დღეზე ძველი შეუსრულებელი შეკვეთებისთვის თეგის დამატება

ყოველდღე სამუშაო პროცესი იღებს 2 დღეზე ძველ ყველა შეუსრულებელ შეკვეთას და შეკვეთას ამატებს თეგს. შაბლონის ნახვა

გამოიყენე თეგები მომხმარებლების სეგმენტაციისთვის ბოლო 6 თვის შეკვეთების მიხედვით

ახალი შეკვეთის შექმნისას მიიღება მომხმარებლის შეკვეთების ჯამი და რაოდენობა ბოლო 6 თვის განმავლობაში, რის შემდეგაც მომხმარებელს ემატება თეგები. იყენებს მოქმედებებს: Get order data, Count, Sum. შაბლონის ნახვა