جلب بيانات العميل

في مهام سير العمل التي تستخدم بيانات العملاء، يمكنك استخدام إجراء جلب بيانات العميل لجلب معلومات العميل من متجرك.

التكوين

الحقول

يحتوي إجراء جلب بيانات العميل على الحقول التالية التي تُستخدم لإنشاء الاستعلام:

سلسلة الاستعلام

هذا مثال على استعلام لجلب العملاء الذين تم تحديث بياناتهم في اليوم الأخير:

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 سنوات ولم يسبق لهم تقديم أي طلب. عرض القالب