المساعدة
تسجيل الدخول

فلاتر شرائح العملاء المستندة إلى Shopify

استخدم هذا الدليل المرجعي لفهم أسماء الفلاتر وعوامل التشغيل والقيم التي تُستخدم لإنشاء شرائح عملاء مستندة إلى فلاتر Shopify الافتراضية.

في هذه الصفحة

تاريخ عملية الدفع المتروكة

الاسم: abandoned_checkout_date

يتضمن العملاء حسب تاريخ آخر مرة تركوا فيها سلة التسوق الخاصة بهم.

عوامل التشغيل في التاريخ المحدد: =
ليس في التاريخ: !=
في التاريخ أو قبله: <=
قبل التاريخ: <
في التاريخ أو بعده: >=
بعد التاريخ: >
بين تاريخين: BETWEEN {date1} AND {date2}
غير موجود: IS NULL
موجود: IS NOT NULL
القيم
التنسيق تاريخ مطلق: YYYY-MM-DD
أمثلة على إزاحة التاريخ: -4w, -10y
تاريخ مُسمى:
  • اليوم: = today
  • الأمس: = yesterday
التواريخ المُسماة هي قيم افتراضية ولا يمكن تغييرها. بالنسبة للتواريخ المخصصة، استخدم إزاحة التاريخ.
مثال تضمين العملاء الذين تركوا سلة التسوق الخاصة بهم خلال الأسبوع الماضي:
abandoned_checkout_date >= -7d

تضمين العملاء الذين تركوا سلة التسوق الخاصة بهم خلال الأشهر الثمانية الماضية:
abandoned_checkout_date > -8m
ملاحظاتتعتمد قيم التواريخ على أيام كاملة وتعتمد على المنطقة الزمنية التي يقع فيها متجرك.

الذكرى السنوية

الاسم: anniversary

يتضمن العملاء حسب تاريخ الحدث المرتبط بمعلمة التاريخ.

معلمات الدالة حدد الحدث الذي تريد التصفية بناءً عليه. على سبيل المثال: 'metafields.facts.birth_date'
عوامل التشغيل IS NULL: المعلمة غير موجودة.
IS NOT NULL: المعلمة موجودة.

بالنسبة للتواريخ، تتضمن عوامل التشغيل المتاحة ما يلي:
يساوي: =
لا يساوي: !=
بين: BETWEEN
القيم date
التنسيق تاريخ مطلق: YYYY-MM-DD
أمثلة على إزاحة التاريخ: +4w, +3m
التواريخ أو النطاقات المُسماة:
  • اليوم: = today
  • خلال السبعة أيام القادمة: BETWEEN today AND +7d
  • خلال الـ 30 يومًا القادمة: BETWEEN today AND +30d
مثال تضمين العملاء الذين يصادف عيد ميلادهم خلال الـ 30 يومًا القادمة:
anniversary ('metafields.facts.birth_date') BETWEEN today AND +30d
ملاحظات
  • الفلتر anniversary لا يأخذ السنة في الاعتبار.
  • تعتمد قيم التواريخ على أيام كاملة وتعتمد على المنطقة الزمنية التي يقع فيها متجرك.
  • للتصفية بناءً على تواريخ الميلاد، يجب عليك إما تفعيل الحقل التعريفي القياسي facts.birth_date أو إنشاء حقلك التعريفي المخصص. تعرّف على المزيد حول إضافة حقول تعريفية قياسية أو إنشاء تعريفات للحقول التعريفية المخصصة.

المبلغ المُنفق

الاسم: amount_spent

يتضمن العملاء بناءً على مقدار الأموال التي أنفقوها في متجرك.

عوامل التشغيل يساوي: =
لا يساوي: !=
أكبر من: >
أصغر من: <
أصغر من أو يساوي: <=
أكبر من أو يساوي: >=
بين: BETWEEN
القيم
التنسيق نطاق الأرقام: # AND #
الرقم: #
الرقم العشري: تُستخدم النقطة (.) كفاصل عشري.
فواصل الآلاف، مثل الفواصل أو المسافات، غير مقبولة.
الأرقام المنسقة الخاصة بلغة معينة غير مقبولة.
مثال تضمين العملاء الذين أنفقوا من 1 إلى 999.99 في متجرك:
amount_spent BETWEEN 1 AND 999.99
ملاحظات
  • تستند العملة المُستخدَمة إلى العملة المحددة لمتجرك. لا تحدد العملة المُستخدَمة عن طريق إدخال رمز العملة.
  • BETWEEN يشتمل على قيمتيّ البداية والنهاية. على سبيل المثال، amount_spent BETWEEN 1 AND 100 يشمل العملاء الذين أنفقوا 1 على الأقل وما يصل إلى 100.

المدن

الاسم: customer_cities

يشمل العملاء الذين لديهم عنوان في المدينة المحددة. قد يتم تضمين العملاء الذين لديهم عناوين متعددة في أكثر من فئة عملاء واحدة تستخدم عامل التصفية هذا.

عوامل التشغيل يحتوي على هذه المدينة بالضبط: CONTAINS
لا يحتوي على هذه المدينة بالضبط: NOT CONTAINS
غير موجود: IS NULL
موجود: IS NOT NULL
القيم
التنسيق countryCode-regionCode-cityCode
مثال تضمين العملاء الذين لديهم عنوان في مدينة نيويورك:
customer_cities CONTAINS 'US-NY-NewYorkCity'
ملاحظات للبحث عن مدينة، يمكنك البدء بكتابة اسم المدينة، ثم تحديد القيمة المناسبة من القائمة المعروضة.

الشركات

الاسم: companies

يشمل العملاء من الشركات التي تمت تهيئتها كـ عملاء B2B.

عوامل التشغيل يحتوي على معرّف الشركة هذا بالضبط: CONTAINS
لا يحتوي على معرّف الشركة هذا بالضبط: NOT CONTAINS
غير موجود: IS NULL
موجود: IS NOT NULL
القيممعرّف الشركة
التنسيق
مثال عميل B2B:
companies IS NOT NULL
ليس عميل B2B:
companies IS NULL
يشمل العملاء التابعين لشركة معينة:
companies CONTAINS 3778915041302
ملاحظات
  • عند إنشاء فئة العملاء، يمكنك تحديد الشركة باسمها من القائمة المعروضة. وبدلاً من ذلك، يمكنك البدء بكتابة اسم الشركة، ثم تحديده من القائمة.
  • يتم إدخال معرّف الشركة في الكود البرمجي، وليس اسم الشركة. عند تمرير المؤشر فوق معرّف الشركة، يتم عرض اسم الشركة.

البلدان أو المناطق

الاسم: customer_countries

يشمل العملاء الذين لديهم عنوان في البلد أو المنطقة المحددة. قد يتم تضمين العملاء الذين لديهم عناوين متعددة في أكثر من فئة عملاء واحدة تستخدم عامل التصفية هذا.

عوامل التشغيل يحتوي على هذا الموقع بالضبط: CONTAINS
لا يحتوي على هذا الموقع بالضبط: NOT CONTAINS
غير موجود: IS NULL
موجود: IS NOT NULL
القيم استخدم رمز البلد المكوّن من حرفين وفقًا لمعيار ISO.
التنسيق
مثال تضمين العملاء الذين لديهم عنوان في الولايات المتحدة:
customer_countries CONTAINS 'US'
ملاحظات للبحث عن بلد، يمكنك البدء بكتابة اسم البلد، ثم تحديد القيمة المناسبة من القائمة المعروضة.

تم الإنشاء بواسطة معرّف التطبيق

الاسم: created_by_app_id

يشمل العملاء الذين تم إنشاؤهم بواسطة التطبيق المحدد.

عوامل التشغيل يساوي: =
لا يساوي: !=
القيممعرّف التطبيق المطلوب تصنيف الفئة بناءً عليه.
التنسيقمعرّف التطبيق
مثال تضمين العملاء الذين تم إنشاؤهم في مسؤول Shopify:
created_by_app_id = 1830279
ملاحظات
  • عند إنشاء فئة العملاء، يمكنك تحديد تطبيق باسمه من القائمة المعروضة. وبدلاً من ذلك، يمكنك البدء بكتابة اسم التطبيق، ثم تحديده من القائمة.
  • يتم إدخال معرّف التطبيق في الكود البرمجي، وليس اسم التطبيق. عند تمرير المؤشر فوق معرّف التطبيق، يتم عرض اسم التطبيق.

حالة حساب العميل

الاسم: customer_account_status

يشمل العملاء الذين لديهم حالة حساب العميل المحددة.

عوامل التشغيل يساوي: =
لا يساوي: !=
القيم مرفوض: 'DECLINED' تمت دعوة العميل لإنشاء حساب، ولكنه رفض.
معطّل: 'DISABLED' لم يُنشئ العميل حسابًا، أو أن متجرك يستخدم حسابات العملاء الجديدة.
مُفعّل: 'ENABLED' قام العميل بإنشاء حساب.
مدعو: 'INVITED' تمت دعوة العميل لإنشاء حساب، ولكنه لم يقبل أو يرفض بعد.
التنسيق
مثال تضمين العملاء الذين تمت دعوتهم لإنشاء حساب، ولكنهم رفضوا:
customer_account_status = 'DECLINED'
ملاحظات

تاريخ إضافة العميل

الاسم: customer_added_date

يشمل العملاء بناءً على تاريخ إضافتهم إلى متجرك.

عوامل التشغيل في التاريخ المحدد: =
ليس في التاريخ: !=
في التاريخ أو قبله: <=
قبل التاريخ: <
في التاريخ أو بعده: >=
بعد التاريخ: >
بين تاريخين: BETWEEN {date1} AND {date2}
القيم
التنسيق تاريخ مطلق: YYYY-MM-DD
أمثلة على إزاحة التاريخ: -4w, -10y
تاريخ مُسمى:
  • اليوم: = today
  • الأمس: = yesterday
التواريخ المُسماة هي قيم افتراضية ولا يمكن تغييرها. بالنسبة للتواريخ المخصصة، استخدم إزاحة التاريخ.
مثال تضمين العملاء الذين تمت إضافتهم خلال الأسبوع الماضي:
customer_added_date >= -7d

تضمين العملاء الذين تمت إضافتهم خلال الأشهر الثمانية الماضية:
customer_added_date > -8m

تضمين العملاء الذين تمت إضافتهم خلال نطاق تواريخ محدد:
customer_added_date BETWEEN 2022-12-01 AND 2022-12-31
ملاحظات تستند قيم التاريخ إلى أيام كاملة وتعتمد على المنطقة الزمنية لمتجرك.

نطاق البريد الإلكتروني للعميل

الاسم: customer_email_domain

يشمل العملاء الذين ينتمي عنوان بريدهم الإلكتروني إلى النطاق المحدد. اسم النطاق هو الجزء من عنوان البريد الإلكتروني الذي يأتي بعد الرمز @، على سبيل المثال: gmail.com.

عوامل التشغيل يساوي: =
لا يساوي: !=
غير موجود: IS NULL
موجود: IS NOT NULL
القيم تُقدَّم أسماء النطاقات التالية كاقتراحات. لست مقيدًا بأسماء النطاقات هذه. يمكنك إدخال أي أسماء نطاقات أخرى صالحة يدويًا:
  • Gmail: 'gmail.com'
  • Yahoo: 'yahoo.com' أو 'yahoo.ca'
  • Hotmail: 'hotmail.com'
  • AOL: 'aol.com'
  • MSN: 'msn.com'
  • Live: 'live.com'
  • Outlook: 'outlook.com'
التنسيق
مثال تضمين العملاء الذين نطاق بريدهم الإلكتروني هو shopify.com:
customer_email_domain = 'shopify.com'
ملاحظات

لغة العميل

الاسم: customer_language

يتضمن العملاء بناءً على اللغة التي يستخدمها العميل للتواصل مع متجرك.

عوامل التشغيل يساوي: =
لا يساوي: !=
غير موجود: IS NULL
موجود: IS NOT NULL
القيم استخدم رمز اللغة المكون من حرفين وفقًا لمعيار ISO 639-1.
التنسيق القيم التالية هي أمثلة لبعض رموز لغات ISO الشائعة. لا تقتصر بياناتك على رموز اللغات هذه. يمكنك إدخال أي رموز لغات صالحة أخرى يدويًا، ولكن القيم المقترحة لك في المحرر هي القيم الوحيدة المتاحة في بيانات عملائك.
  • الإنجليزية: 'en'
  • الفرنسية: 'fr'
  • الإسبانية: 'es'
  • الألمانية: 'de'
  • الإيطالية: 'it'
  • اليابانية: 'ja'
  • الروسية: 'ru'
مثال تضمين العملاء الذين يتواصلون مع متجرك باللغة الإنجليزية:
customer_language = 'en'

استبعاد العملاء الذين يتواصلون مع متجرك باللغة الإنجليزية الكندية:
customer_language != 'en-CA'
ملاحظات
  • يمكنك إضافة رمز ISO للإعداد المحلي إلى القيمة لتحديد لهجة لتلك اللغة. على سبيل المثال، يمكنك استخدام 'en-US' للولايات المتحدة و 'en-GB' للمملكة المتحدة، أو 'pt-PT' للبرتغال و 'pt-BR' للبرازيل.
  • تعمل قيمة عامل التصفية كحرف بدل (wildcard) إذا تم تحديد بادئة اللغة فقط. على سبيل المثال، إذا كانت قيمة عامل التصفية هي 'en'، فستتضمن نتائجك العملاء الذين تم تعيين لغتهم على 'en' والعملاء الذين تم تعيين لغتهم على 'en-GB', 'en-CA'، وما إلى ذلك.

علامات العميل

الاسم: customer_tags

يتضمن العملاء بناءً على علاماتهم.

عوامل التشغيل يحتوي على هذه العلامة بالضبط: CONTAINS
لا يحتوي على هذه العلامة بالضبط: NOT CONTAINS
غير موجود: IS NULL
موجود: IS NOT NULL
القيماسم علامة العميل.
التنسيق
مثال تضمين العملاء الذين لديهم العلامة GoldStatus:
customer_tags CONTAINS 'GoldStatus'
ملاحظات الإشارات غير حساسة لحالة الأحرف.
تعرّف على المزيد حول الإشارات واعتباراتها.

العميل ضمن مسافة

الاسم: customer_within_distance

يتضمن العملاء ضمن مسافة محددة من موقع محفوظ.

معلمات الدالة يمكنك استخدام معلمة مسافة واحدة فقط لكل فلتر.
coordinates (مطلوب): استخدم هذه المعلمة لتحديد موقع الدبوس الذي تريد استخدامه لإنشاء شريحتك.
distance_km (مطلوب): استخدم هذه المعلمة لتحديد نصف قطر المسافة بالكيلومتر الذي تريد البحث ضمنه عن العملاء.
distance_mi (مطلوب): استخدم هذه المعلمة لتحديد نصف قطر المسافة بالميل الذي تريد البحث ضمنه عن العملاء.
عوامل التشغيل MATCHES: المعلمة صحيحة.
NOT_MATCHES: المعلمة خاطئة.
IS NULL: المعلمة غير موجودة.
IS NOT NULL: المعلمة موجودة.

القيمة
التنسيق التنسيق المدعوم لـ coordinates:
  • رقم (خط العرض)، رقم (خط الطول)

    • التنسيق المدعوم للإحداثيات (خط العرض، خط الطول):
  • رقم: #

    • التنسيق المدعوم لـ distance_mi, distance_km:
  • رقم: #

    • مثال يتطلب هذا الفلتر إحداثيات ومعلمة مسافة واحدة ليكون صالحًا.

    فلترة العملاء الذين لديهم عنوان يقع ضمن مسافة 10 أميال من الإحداثيات (45.419190, -75.696727):
    customer_within_distance MATCHES (coordinates = (45.419190, -75.696727), distance_mi = 10 )

    يمكن استخدام هذا الفلتر مع فلاتر أخرى لتضييق نطاق قائمة عملائك بشكل أكبر. على سبيل المثال:
    فلترة العملاء الذين لديهم عنوان يقع ضمن مسافة 20 كيلومترًا من الإحداثيات (43.634,-79.412) وقاموا بتقديم طلب واحد على الأقل:
    customer_within_distance MATCHES (coordinates = (43.634,-79.412), distance_km = 20 ) AND number_of_orders > 0
    ملاحظات
    • تقوم أداة تقسيم Shopify تلقائيًا بتحويل مواقعك المحفوظة إلى زوج من الإحداثيات، وتُظهرها كقيم قابلة للتحديد عند استخدام عامل التصفية هذا.
    • إذا كان متجرك يحتوي على مواقع محفوظة، فسيقوم Shopify Magic تلقائيًا بترجمة زوج الإحداثيات إلى اسم موقعك في الترجمة السحرية. على سبيل المثال: "العملاء الذين لديهم عنوان ضمن 10 أميال من موقع 'Salt Lake City Store'."

    أحداث البريد الإلكتروني

    الاسم: shopify_email.EVENT

    يتضمن العملاء بناءً على أحداث البريد الإلكتروني المحددة. تتضمن الأحداث المدعومة (EVENT) ما يلي:

    • مرتد: bounced
    • تم النقر: clicked
    • تم التسليم: delivered
    • تم وضع علامة كبريد مزعج: marked_as_spam
    • تم الفتح: opened
    • تم إلغاء الاشتراك: unsubscribed
    معلمات الدالة activity_id (اختياري): استخدم هذه المعلمة لتحديد معرّف النشاط التسويقي الذي تريد فلترته.
    count (اختياري): استخدم هذه المعلمة لتحديد عدد المرات التي وقع فيها حدث عبر البريد الإلكتروني.
    date (اختياري): استخدم هذه المعلمة لتحديد تاريخ الحدث.
    عوامل التشغيل MATCHES: يُستخدم عند وقوع الحدث.
    NOT_MATCHES: يُستخدم عند عدم وقوع الحدث.
    IS NULL: المعلمة غير موجودة.
    IS NOT NULL: المعلمة موجودة.

    بالنسبة للتواريخ، تتضمن عوامل التشغيل المتاحة ما يلي:
    يساوي: =
    لا يساوي: !=
    أكبر من: >
    أصغر من: <
    أصغر من أو يساوي: <=
    أكبر من أو يساوي: >=
    بين: BETWEEN
    القيمة
    التنسيقالتنسيقات المدعومة لـ activity_id:
  • = (قيمة واحدة)
  • IN : مجموعة من القيم المفصولة بفواصل مع "OR" ضمنية، وموضوعة بين قوسين. على سبيل المثال: (activity_id IN (1, 2, 3)). هناك حد أقصى يبلغ 500 من معرّفات النشاط في المجموعة.

    تنسيقات التاريخ المدعومة لـ date:
  • التاريخ المطلق: YYYY-MM-DD
  • أمثلة على إزاحة التاريخ:
    • منذ 7 أيام: -7d
    • منذ 4 أسابيع: -4w
    • منذ 3 أشهر: -3m
    • منذ سنة واحدة: -1y
    • تاريخ مسمّى: today, yesterday

    • التواريخ المسماة هي قيم افتراضية ولا يمكن تغييرها. بالنسبة للتواريخ المخصصة، استخدم إزاحة التاريخ.

    تتوفر أحداث البريد الإلكتروني لآخر 26 شهرًا، حيث تبدأ البيانات من مارس 2022.

    التنسيقات المدعومة لـ count:
  • الرقم: #

    • مثال حدّد ما إذا كان حدث البريد الإلكتروني قد وقع باستخدام العامل MATCHES أو NOT MATCHES:
    shopify_email.opened MATCHES (activity_id = 135195754518)
    shopify_email.opened NOT MATCHES (activity_id = 135195754518)

    استخدم المعلمة activity_id لتحديد معرّف نشاط التسويق الذي تريد التصفية بناءً عليه:
    shopify_email.delivered MATCHES (activity_id = 135195754518)

    استخدم المعلمة date والعامل >= لتحديد تاريخ بدء لحدث بريد إلكتروني:
    shopify_email.delivered NOT MATCHES (activity_id = 135195754518, date >= 2022-01-01)

    استخدم المعلمة date والعامل <= لتحديد تاريخ انتهاء لحدث بريد إلكتروني:
    shopify_email.delivered MATCHES (activity_id = 135195754518, date <= 2022-01-01)

    استخدم المعلمة date والعامل BETWEEN لتحديد كل من تاريخ البدء والانتهاء لحدث بريد إلكتروني:
    shopify_email.bounced NOT MATCHES (activity_id = 135195754518, date BETWEEN -12m AND today)
    ملاحظات
    • عند إنشاء شريحة عملاء باستخدام المعلمة activity_id، يمكنك تحديد النشاط التسويقي باسمه من القائمة المعروضة.
    • نظرًا للاحتفاظ بالبيانات، فإن عدم وجود معلمات date يعني أنه ستتم تصفية النتائج لآخر 26 شهرًا، دون تعيين تاريخ بدء أو انتهاء.
    • إن غياب activity_id يعني أن عامل التصفية الخاص بك يتضمن جميع أنشطة البريد الإلكتروني في Shopify.

    حالة الاشتراك في البريد الإلكتروني

    الاسم: email_subscription_status

    يشمل العملاء استنادًا إلى ما إذا كانوا مشتركين في البريد الإلكتروني التسويقي الخاص بك أم لا.

    عوامل التشغيل يساوي: =
    لا يساوي: !=
    غير موجود: IS NULL
    موجود: IS NOT NULL
    القيم غير مشترك: 'NOT_SUBSCRIBED' لم يشترك العميل في بريدك الإلكتروني التسويقي.
    مشترك: 'SUBSCRIBED' العميل مشترك في بريدك الإلكتروني التسويقي.
    قيد الانتظار: 'PENDING' العميل بصدد الاشتراك في بريدك الإلكتروني التسويقي.
    غير صالح: 'INVALID' حالة تسويق عنوان البريد الإلكتروني للعميل غير صالحة.
    ألغى اشتراكه: 'UNSUBSCRIBED' لقد ألغى العميل اشتراكه من رسائل بريدك الإلكتروني التسويقية.
    منقّح: 'REDACTED' تم إخفاء عنوان البريد الإلكتروني للعميل.
    التنسيق
    مثال قم بتضمين العملاء الذين اشتركوا في التسويق عبر البريد الإلكتروني الخاص بك:
    email_subscription_status = 'SUBSCRIBED'
    ملاحظات

    تاريخ أول طلب

    الاسم: first_order_date

    يشمل العملاء الذين قدموا طلبهم الأول في التاريخ المحدد.

    عوامل التشغيل في التاريخ المحدد: =
    ليس في التاريخ: !=
    في التاريخ أو قبله: <=
    قبل التاريخ: <
    في التاريخ أو بعده: >=
    بعد التاريخ: >
    بين تاريخين: BETWEEN {date1} AND {date2}
    غير موجود: IS NULL
    موجود: IS NOT NULL
    القيم
    التنسيق تاريخ مطلق: YYYY-MM-DD
    أمثلة على إزاحة التاريخ: -4w, -10y
    تاريخ مُسمى:
    • اليوم: = today
    • الأمس: = yesterday
    التواريخ المُسماة هي قيم افتراضية ولا يمكن تغييرها. بالنسبة للتواريخ المخصصة، استخدم إزاحة التاريخ.
    مثال قم بتضمين العملاء الذين تم تقديم طلبهم الأول منذ الأسبوع الماضي:
    first_order_date >= -7d

    قم بتضمين العملاء الذين تم تقديم طلبهم الأول منذ ثمانية أشهر:
    first_order_date > -8m
    ملاحظات تستند قيم التاريخ إلى أيام كاملة وتعتمد على المنطقة الزمنية لمتجرك.

    تاريخ آخر طلب

    الاسم: last_order_date

    يشمل العملاء الذين قدموا طلبهم الأخير في التاريخ المحدد.

    عوامل التشغيل في التاريخ المحدد: =
    ليس في التاريخ: !=
    في التاريخ أو قبله: <=
    قبل التاريخ: <
    في التاريخ أو بعده: >=
    بعد التاريخ: >
    بين تاريخين: BETWEEN {date1} AND {date2}
    غير موجود: IS NULL
    موجود: IS NOT NULL
    القيم
    التنسيق تاريخ مطلق: YYYY-MM-DD
    أمثلة على إزاحة التاريخ: -4w, -10y
    تاريخ مُسمى:
    • اليوم: = today
    • الأمس: = yesterday
    التواريخ المُسماة هي قيم افتراضية ولا يمكن تغييرها. بالنسبة للتواريخ المخصصة، استخدم إزاحة التاريخ.
    مثال قم بتضمين العملاء الذين تم تقديم طلبهم الأخير منذ الأسبوع الماضي:
    last_order_date >= -7d

    قم بتضمين العملاء الذين تم تقديم طلبهم الأخير منذ ثمانية أشهر:
    last_order_date > -8m
    ملاحظات تستند قيم التاريخ إلى أيام كاملة وتعتمد على المنطقة الزمنية لمتجرك.

    عدد الطلبات

    الاسم: number_of_orders

    يشمل العملاء استنادًا إلى عدد الطلبات التي قدموها في متجرك.

    عوامل التشغيل يساوي: =
    لا يساوي: !=
    أكبر من: >
    أصغر من: <
    أصغر من أو يساوي: <=
    أكبر من أو يساوي: >=
    بين: BETWEEN
    القيميجب أن تكون القيمة التي تدخلها عددًا صحيحًا.
    التنسيق نطاق الأرقام: # AND #
    الرقم: #
    مثال قم بتضمين العملاء الذين قدموا أكثر من 10 طلبات:
    number_of_orders > 10
    ملاحظات BETWEEN يشتمل على قيمتيّ البداية والنهاية. على سبيل المثال، number_of_orders BETWEEN 1 AND 100 يتضمن العملاء الذين قدموا طلبًا واحدًا على الأقل وما يصل إلى 100 طلب.

    الطلبات المقدمة

    الاسم: orders_placed

    يشمل العملاء الذين قدموا طلبات أو أنفقوا مبلغًا معينًا خلال نطاق زمني محدد.

    معلمات الدالة app_id (اختياري): استخدم هذه المعلمة لتحديد التطبيق الذي أنشأ الطلب. ويتضمن ذلك تطبيقات مثل Shopify POS، والذي يمتلك معرّف تطبيق هو 129785.
    location_id (اختياري): استخدم هذه المعلمة لتحديد الموقع الذي تم تقديم الطلب منه. يمكنك العثور على معرّف موقع في عنوان URL لمسؤول Shopify الخاص بك عند الانتقال إلى تفاصيل موقع في المواقع.
    count (اختياري): استخدم هذه المعلمة لتحديد العدد الدقيق لمرات تقديم طلب.
    amount (اختياري): استخدم هذه المعلمة لتحديد المبلغ الدقيق الذي تم إنفاقه على طلب ما.
    sum_amount (اختياري): استخدم هذه المعلمة لتحديد المبلغ الذي تم إنفاقه على جميع الطلبات.
    date (اختياري): استخدم هذه المعلمة لتحديد تاريخ للحدث.
    عوامل التشغيل MATCHES: المعلمة صحيحة.
    NOT_MATCHES: المعلمة خاطئة.
    IS NULL: المعلمة غير موجودة.
    IS NOT NULL: المعلمة موجودة.

    بالنسبة للتواريخ، تتضمن عوامل التشغيل المتاحة ما يلي:
    يساوي: =
    لا يساوي: !=
    أكبر من: >
    أصغر من: <
    أصغر من أو يساوي: <=
    أكبر من أو يساوي: >=
    بين: BETWEEN
    القيم
    التنسيق التنسيقات المدعومة لـ count, amount، و sum_amount:
    الرقم: #

    التنسيقات المدعومة لـ date:
    التاريخ المطلق: YYYY-MM-DD
    أمثلة على إزاحة التاريخ:
    • منذ 7 أيام: -7d
    • منذ 4 أسابيع: -4w
    • منذ 3 أشهر: -3m
    • منذ سنة واحدة: -1y
    تاريخ مسمّى:
    • اليوم: today
    • الأمس: yesterday
    التواريخ المسماة هي قيم افتراضية ولا يمكن تغييرها.
    مثال حدد ما إذا كان قد تم تقديم طلب باستخدام المعامل MATCHES أو NOT_MATCHES :
    orders_placed MATCHES ()
    orders_placed NOT MATCHES ()

    قم بتصفية العملاء الذين قدموا أكثر من 3 طلبات (شاملة) في آخر 6 أشهر:
    orders_placed MATCHES (count >= 3, date >= -6m)

    تصفية العملاء الذين أنفقوا أكثر من 1000 دولار (شاملاً) في آخر 90 يومًا:
    orders_placed MATCHES (sum_amount >= 1000, date >= -90d)

    تصفية العملاء الذين أنفقوا أقل من 100 دولار (شاملاً) في آخر 7 أيام:
    orders_placed MATCHES (sum_amount <= 100, date >= -7d)

    تصفية العملاء الذين أنفقوا أكثر من 1000 دولار (شاملاً) وقدموا أكثر من 3 طلبات (شاملاً) منذ 1 يناير 2023:
    orders_placed MATCHES (sum_amount >= 1000, count >= 3, date >= 2023-01-01)

    استخدم المعلمة date والمعامل BETWEEN لتحديد نطاق زمني معين. يمكنك التعبير عن الفترة بين 1 يناير 2023 و1 يونيو 2023 (شاملاً) بالطريقة التالية:
    orders_placed MATCHES (count >= 3, date BETWEEN 2023-01-01 AND 2023-06-01)

    تصفية العملاء الذين قدموا طلبًا إما من موقع HQ Gift Shop الخاص بك (1122334455) أو موقع Main Street الخاص بك (6677889900):
    orders_placed MATCHES (location_id IN (1122334455,6677889900))

    تصفية العملاء الذين أنفقوا أكثر من 500 دولار إجمالاً من Shopify POS:
    orders_placed MATCHES (app_id = 129785, sum_amount >= 500)
    ملاحظات
    • عند تمرير المؤشر فوق المبلغ، تُعرض العملة المستخدَمة لتصفية عملائك.
    • عند تمرير المؤشر فوق الصيغة التالية:
      amount, sum_amount يتم عرض وصف بناء الجملة.
    • يعني عدم وجود parameters أن عامل التصفية الخاص بك يتضمن جميع الطلبات المقدمة في كل الأوقات.

    فئة الإنفاق المتوقع

    الاسم: predicted_spend_tier

    يتضمن العملاء الموجودين ضمن فئة الإنفاق المتوقع المحددة. تعرّف على المزيد حول فئة الإنفاق المتوقع.

    عوامل التشغيل يساوي: =
    لا يساوي: !=
    غير موجود: IS NULL
    موجود: IS NOT NULL
    القيم 'HIGH'
    'MEDIUM'
    'LOW'
    التنسيق
    مثال تضمين العملاء الموجودين في الفئة HIGH:
    predicted_spend_tier = 'HIGH'
    ملاحظات

    حالة اشتراك المنتج

    الاسم: product_subscription_status

    يتضمن العملاء الذين لديهم حالة اشتراك المنتج المحددة.

    عوامل التشغيل يساوي: =
    لا يساوي: !=
    غير موجود: IS NULL
    موجود: IS NOT NULL
    القيم نشط: 'SUBSCRIBED' لدى العميل اشتراك منتج نشط.
    مُلغى: 'CANCELLED' ألغى العميل اشتراك المنتج الخاص به.
    منتهي الصلاحية: 'EXPIRED' انتهت صلاحية اشتراك المنتج الخاص بالعميل.
    فاشل: 'FAILED' لدى العميل عملية دفع فاشلة.
    غير مشترك أبدًا: 'NEVER_SUBSCRIBED' لم يسبق للعميل الاشتراك.
    متوقف مؤقتًا: 'PAUSED' أوقف العميل اشتراك المنتج مؤقتًا.
    التنسيق
    مثال تضمين العملاء الذين لديهم اشتراك منتج نشط:
    product_subscription_status = 'SUBSCRIBED'
    ملاحظات

    المنتجات المشتراة

    الاسم: products_purchased

    يتضمن العملاء الذين اشتروا المنتج المحدد. بالإضافة إلى ذلك، يمكنك تضمين العملاء الذين اشتروا المنتج خلال نطاق زمني محدد.

    معلمات الدالة id (اختياري): استخدم هذه المعلمة لتحديد المنتج الذي اشتراه العميل وتريد تصفيته.
    quantity (اختياري): استخدم هذه المعلمة لتحديد كمية المنتجات المشتراة لكل طلب.
    sum_quantity (اختياري): استخدم هذه المعلمة لتحديد كمية المنتجات المشتراة عبر جميع الطلبات.
    date (اختياري): استخدم هذه المعلمة لتحديد تاريخ للحدث.
    tag (اختياري): استخدم هذه المعلمة لتحديد إشارة منتج للمنتجات المشتراة التي تريد تصفيتها.
    عوامل التشغيل MATCHES: المعلمة صحيحة (true).
    NOT_MATCHES: المعلمة خاطئة (false).
    IS NULL: المعلمة غير موجودة.
    IS NOT NULL: المعلمة موجودة.

    بالنسبة للتواريخ، تتضمن المعاملات المتاحة ما يلي:
    يساوي: =
    لا يساوي: !=
    أكبر من: >
    أصغر من: <
    أصغر من أو يساوي: <=
    أكبر من أو يساوي: >=
    بين: BETWEEN
    القيمة
    التنسيق التنسيقات المدعومة لـ إشارة (tag):
    سلسلة نصية (string) (قيمة مفردة)

    التنسيقات المدعومة لـ معرّف (id):
  • = (قيمة واحدة)
  • IN : مجموعة من القيم المفصولة بفواصل مع "OR" ضمنية، ومغلفة بين أقواس. على سبيل المثال: (id IN (1012132033639, 2012162031638, 32421429314657)). يوجد حد أقصى يبلغ 500 معرّف منتج في المجموعة الواحدة.

    تنسيقات التاريخ المدعومة:
    تاريخ مطلق: YYYY-MM-DD
    أمثلة على إزاحة التاريخ:
    • منذ 7 أيام: -7d
    • منذ 4 أسابيع: -4w
    • منذ 3 أشهر: -3m
    • منذ سنة واحدة: -1y
    • تاريخ مسمّى: today, yesterday
    التواريخ المسماة هي قيم افتراضية ولا يمكن تغييرها.

    التنسيقات المدعومة لـ quantity و sum_quantity:
    الرقم: #
    • مثال حدد ما إذا كان قد تم شراء منتج باستخدام المعامل MATCHES أو NOT_MATCHES:
    products_purchased MATCHES (id = 2012162031638)
    products_purchased NOT MATCHES (id IN (2012162031638, 1012132033639)) products_purchased MATCHES (tag = 'red')

    تصفية العملاء الذين اشتروا منتجًا معينًا منذ 1 يناير 2022 حتى اليوم:
    products_purchased MATCHES (id = 1012132033639, date BETWEEN 2022-01-01 AND today)

    تصفية العملاء الذين اشتروا منتجًا يحمل الإشارة 'red' منذ 1 يناير 2022 حتى اليوم:
    products_purchased MATCHES (tag = 'red', date BETWEEN 2022-01-01 AND today)

    خلال آخر 30 يومًا:
    products_purchased MATCHES (date >= -30d)

    حتى 1 يناير 2022:
    products_purchased MATCHES (date <= 2022-01-01)

    استخدم المعلمة date والمعامل BETWEEN لتحديد نطاق زمني معين. يمكنك التعبير عن الفترة بين 1 يناير 2022 و1 يونيو 2022 (شاملاً) بالطريقة التالية:
    products_purchased MATCHES (id = 1012132033639, date BETWEEN 2022-01-01 AND 2022-06-01)

    تصفية العملاء الذين اشتروا مؤخرًا العديد من المنتجات التي تحمل إشارة معينة:
    products_purchased MATCHES (tag = 'product_tag', sum_quantity >= 3, date >= -90d)
    ملاحظات
    • عند إنشاء شريحة العملاء باستخدام المَعلمة id، يمكنك تحديد المنتج من خلال اسمه أو صورته من القائمة المعروضة. وبدلاً من ذلك، يمكنك البدء في كتابة عنوان المنتج، ثم تحديده من القائمة.
    • يُدرج معرّف المنتج وليس عنوان المنتج في الكود. عند تمرير المؤشر فوق معرّف المنتج، يتم عرض عنوان المنتج وصورته.
    • غياب كلتا date المَعلمتين يعني أنه ستتم تصفية النتائج لجميع الأوقات، دون تحديد تاريخ بدء أو انتهاء.
    • غياب أي مَعلمات يعني أن عامل التصفية الخاص بك يتضمن جميع المنتجات التي تم شراؤها في كل الأوقات.

    مجموعة RFM

    الاسم: rfm_group

    يتضمن العملاء بناءً على مجموعة RFM التي صُنفوا ضمنها. تعرّف على المزيد حول تحليل العملاء بناءً على RFM.

    قائمة العوامل والقيم الممكنة لمجموعة RFM، مع أمثلة عليها.
    عوامل التشغيل يساوي: =
    لا يساوي: !=
    غير موجود: IS NULL
    موجود: IS NOT NULL
    القيم خامل: 'DORMANT'
    في خطر: 'AT_RISK'
    مخلص سابقًا: 'PREVIOUSLY_LOYAL'
    يحتاج إلى الانتباه: 'NEEDS_ATTENTION'
    شبه مفقود: 'ALMOST_LOST'
    مخلص: 'LOYAL'
    واعد: 'PROMISING'
    نشط: 'ACTIVE'
    جديد: 'NEW'
    أبطال: 'CHAMPIONS'
    محتملون: 'PROSPECTS'
    التنسيق
    مثال تضمين العملاء الموجودين في مجموعة RFM يحتاج إلى الانتباه:
    rfm_group = 'NEEDS_ATTENTION'
    ملاحظات

    حالة الاشتراك في الرسائل النصية القصيرة (SMS)

    الاسم: sms_subscription_status

    يتضمن العملاء بناءً على ما إذا كانوا مشتركين لتلقي رسائلك النصية القصيرة (SMS) التسويقية. تعرّف على المزيد حول جمع معلومات الاتصال بالعملاء.

    عوامل التشغيل يساوي: =
    لا يساوي: !=
    غير موجود: IS NULL
    موجود: IS NOT NULL
    القيم مشترك: 'SUBSCRIBED' العميل مشترك لتلقي رسائلك النصية القصيرة (SMS) التسويقية.
    قيد الانتظار: 'PENDING' العميل في طور الاشتراك لتلقي رسائلك النصية القصيرة (SMS) التسويقية.
    مُنقّح: 'REDACTED' العميل في انتظار التنقيح بسبب طلب مسح بموجب النظام الأوروبي العام لحماية البيانات (GDPR).
    ألغى الاشتراك: 'UNSUBSCRIBED' لقد ألغى العميل اشتراكه في تلقي رسائلك النصية القصيرة (SMS) التسويقية.
    غير مشترك: 'NOT_SUBSCRIBED' لم يشترك العميل مطلقًا في رسائل SMS النصية التسويقية الخاصة بك.
    التنسيق
    مثال تضمين العملاء الذين اشتركوا لتلقي رسائلك النصية القصيرة (SMS) التسويقية:
    sms_subscription_status = 'SUBSCRIBED'
    ملاحظات

    الولايات أو المقاطعات

    الاسم: customer_regions

    يتضمن العملاء الذين لديهم عنوان في المنطقة المحددة داخل أي بلد. قد يتم تضمين العملاء الذين لديهم عناوين متعددة في أكثر من شريحة عملاء واحدة تستخدم عامل التصفية هذا.

    عوامل التشغيل يحتوي على هذا الموقع بالضبط: CONTAINS
    لا يحتوي على هذا الموقع بالضبط: NOT CONTAINS
    غير موجود: IS NULL
    موجود: IS NOT NULL
    القيماستخدم رمز البلد ISO مع رمز التقسيم الفرعي ISO 3166-2.
    التنسيق
    مثال تضمين العملاء الذين لديهم عنوان في ولاية نيويورك:
    customer_regions CONTAINS 'US-NY'
    ملاحظات للعثور على منطقة، يمكنك البدء في كتابة اسم المنطقة، ثم تحديد القيمة المناسبة من القائمة المعروضة.

    حسابات رصيد المتجر

    الاسم: store_credit_accounts

    يتضمن العملاء الذين لديهم رصيد متجر في متجرك.

    معلمات الدالة balance (اختياري): استخدم هذه المَعلمة لتحديد الرصيد الحالي لحساب رصيد المتجر الخاص بالعميل.
    currency (اختياري): استخدم هذه المَعلمة لتحديد عملة رصيد المتجر الخاص بالعميل.
    next_expiry_date (اختياري): استخدم هذه المَعلمة لتحديد تاريخ أقرب رصيد متجر غير مُنفق تنتهي صلاحيته.
    last_credit_date (اختياري): استخدم هذه المعلمة لتحديد تاريخ آخر مرة تلقى فيها العميل رصيد متجر.
    عوامل التشغيل MATCHES: المعلمة صحيحة.
    NOT_MATCHES: المعلمة خاطئة.
    IS NULL: المعلمة غير موجودة.
    IS NOT NULL: المعلمة موجودة.

    بالنسبة للتواريخ، تتضمن عوامل التشغيل المتاحة ما يلي:
    يساوي: =
    لا يساوي: !=
    أكبر من: >
    أصغر من: <
    أصغر من أو يساوي: <=
    أكبر من أو يساوي: >=
    بين: BETWEEN
    القيم
    التنسيق التنسيقات المدعومة لـ currency:
    رمز العملة: على سبيل المثال USD

    التنسيقات المدعومة لـ balance:
    رقم: #

    التنسيقات المدعومة لـ next_expiry_date و last_credit_date:
    التواريخ المطلقة: YYY-MM-DD
    أمثلة على إزاحة التاريخ:
    منذ 7 أيام: -7d
    منذ 4 أسابيع: -4w
    منذ 3 أشهر: -3m
    منذ سنة واحدة: -1y
    التواريخ المُسماة:
  • اليوم: today
  • الأمس: yesterday
    • التواريخ المُسماة هي قيم افتراضية ولا يمكن تغييرها.
    مثال تصفية العملاء الذين لديهم رصيد في حساب رصيد المتجر أكبر من أو يساوي 1 بأي عملة:
    store_credit_accounts MATCHES (balance >= 1)

    تصفية العملاء الذين لديهم رصيد في حساب رصيد المتجر أكبر من أو يساوي 1 دولار أمريكي (USD):
    store_credit_accounts MATCHES (balance >= 1, currency: 'USD')

    تصفية العملاء الذين لديهم رصيد متجر تنتهي صلاحيته في الأيام الـ 7 القادمة:
    store_credit_accounts MATCHES (next_expiry_date <= +7d)

    تصفية العملاء الذين تلقوا رصيد متجر لآخر مرة منذ أكثر من شهر واحد ولكن لا يزال لديهم رصيد متاح للإنفاق:
    store_credit_accounts MATCHES (last_credit_date <= -1m, balance >= 1)
    ملاحظات
    • يمتلك العملاء حساب رصيد متجر إذا كنت قد أصدرت لهم رصيد متجر من قبل. يمكن أن يكون رصيد المتجر للعميل أكبر من أو يساوي 0.
    • تكون حسابات رصيد المتجر خاصة بعملة محددة. إذا لم تقم بتضمين مَعلمة currency في شريحتك، سيُرجع عامل التصفية الخاص بك جميع حسابات رصيد المتجر بغض النظر عن نوع العملة.
    • يمكن أن يمتلك العميل عددًا من حسابات رصيد المتجر يبدأ من 0 وحتى عدة حسابات، وذلك حسب عدد العملات التي تدعمها. على سبيل المثال، إذا قمت بإصدار رصيد متجر لعميل بكل من الدولار الكندي (CAD) والدولار الأمريكي (USD)، فإن هذا العميل سيمتلك حسابين لرصيد المتجر.

    أحداث واجهة المتجر

    الاسم: storefront.EVENT

    يتضمن العملاء بناءً على أحداث واجهة المتجر. تشمل الأحداث المدعومة (EVENT) ما يلي:

    • تم عرض المنتج: product_viewed
    • تم عرض المجموعة: collection_viewed
    معلمات الدالة id (اختياري): استخدم هذه المعلمة لتحديد المنتجات أو المجموعات التي تريد التصفية بناءً عليها.
    date (اختياري): استخدم هذه المعلمة لتحديد تاريخ للحدث.
    count (اختياري): استخدم هذه المعلمة لتحديد العدد الدقيق لمرات عرض منتج أو مجموعة.

    المعلمات الخاصة بحدث المنتج:
    tag (اختياري): استخدم هذه المعلمة لتحديد إشارة المنتج التي تريد التصفية بناءً عليها. يعمل هذا بنفس طريقة التصفية لكل معرّف منتج يحمل هذه الإشارة.
    عوامل التشغيل MATCHES: المعلمة صحيحة (true).
    NOT_MATCHES: المعلمة خاطئة (false).
    IS NULL: المعلمة غير موجودة.
    IS NOT NULL: المعلمة موجودة.

    بالنسبة للتواريخ، تتضمن المعاملات المتاحة ما يلي:
    يساوي: =
    لا يساوي: !=
    أكبر من: >
    أصغر من: <
    أصغر من أو يساوي: <=
    أكبر من أو يساوي: >=
    بين: BETWEEN
    القيمة
    التنسيق التنسيقات المدعومة لـ معرّف (id):
  • = (قيمة واحدة)
  • IN : مجموعة من القيم المفصولة بفواصل مع "OR" ضمنية، ومغلفة بين أقواس. على سبيل المثال: (id IN (1012132033639, 2012162031638, 32421429314657)). يوجد حد أقصى يبلغ 500 معرّف منتج أو مجموعة في المجموعة الواحدة.

    التنسيقات المدعومة لـ إشارة (tag): سلسلة نصية (string) (قيمة مفردة)

    تنسيقات التاريخ التنسيقات: التاريخ المطلق: YYYY-MM-DD
    أمثلة على إزاحة التاريخ:
    • منذ 7 أيام: -7d
    • منذ 4 أسابيع: -4w
    • منذ 3 أشهر: -3m
    • منذ سنة واحدة: -1y
    التواريخ المسماة:
    • اليوم: today
    • الأمس: yesterday
    تتوفر أحداث واجهة المتجر لآخر 26 شهرًا، حيث تبدأ البيانات من مايو 2023.

    التواريخ المُسماة هي قيم افتراضية ولا يمكن تغييرها. بالنسبة للتواريخ المخصصة، استخدم إزاحة التاريخ.
    • مثال حدّد ما إذا كان حدث واجهة المتجر قد وقع باستخدام العامل MATCHES أو NOT_MATCHES: storefront.product_viewed MATCHES()
    storefront.collection_viewed NOT MATCHES ()

    استخدم المعلمة id لتحديد المنتجات التي تريد التصفية بناءً عليها:
    storefront.product_viewed MATCHES (id = 2012162031638)
    storefront.collection_viewed MATCHES (id IN (2012162031638, 456, 789))

    استخدم المعلمة tag لإشارات المنتجات التي تريد التصفية بناءً عليها:
    storefront.product_viewed MATCHES (tag CONTAINS 'jeans')

    استخدم المعلمة date والعامل >= لتحديد تاريخ بدء لحدث واجهة متجر:
    storefront.product_viewed MATCHES (id = 2012162031638, date >= 2023-04-03)
    storefront.collection_viewed MATCHES (id = 2012162031638, date >= -30d)

    استخدم المعلمة date والعامل <= لتحديد تاريخ انتهاء لحدث واجهة متجر:
    storefront.product_viewed MATCHES (id = 2012162031638, date <= 2023-04-30)
    storefront.collection_viewed MATCHES (id = 2012162031638, date <= -7d)

    استخدم المعلمة date والعامل BETWEEN لتحديد كل من تاريخ البدء والانتهاء لحدث واجهة متجر:
    storefront.product_viewed MATCHES (id = 2012162031638, date BETWEEN 2023-04-03 AND 2023-04-30)
    storefront.collection_viewed MATCHES (id = 2012162031638, date BETWEEN -90d AND -30d)

    تصفية العملاء الذين شاهدوا منتجًا محددًا في آخر 30 يومًا:
    storefront.product_viewed MATCHES (id = 2012162031638, date >= -30d)

    تصفية العملاء الذين شاهدوا مجموعة محددة منذ 1 يناير 2023 حتى اليوم:
    storefront.collection_viewed MATCHES (id = 2012162031638, date BETWEEN 2023-01-01 AND today)
    ملاحظات
    • عند إنشاء شريحة العملاء باستخدام المعلَمة id، يمكنك تحديد المنتج أو المجموعة باسمه أو صورته من القائمة المعروضة. وبدلًا من ذلك، يمكنك البدء في كتابة عنوان المنتج أو المجموعة، ثم تحديده من القائمة.
    • يتم إدخال معرّف المنتج أو المجموعة، وليس العنوان، في الكود. عند تمرير المؤشر فوق المعرّف، يتم عرض عنوان المنتج أو المجموعة وصورته.
    • تستخدِم المجموعات الصورة المحفوظة كصورة مصغرة للمجموعة، إن أمكن. وإذا لم تتوفر، فسيتم عرض عنصر نائب لصورة عامة.
    • نظرًا للاحتفاظ بالبيانات، فإن عدم وجود معلمات date يعني أنه ستتم تصفية النتائج لآخر 26 شهرًا، دون تعيين تاريخ بدء أو انتهاء.
    • غياب المعلَمة id يعني أن عامل التصفية الخاص بك يتضمن جميع المنتجات.