لغة التجزئة

تقدم Pushwoosh محرك تجزئة قويًا لبناء شرائح (Segments) دقيقة بناءً على قيم العلامات (Tag). لغة التجزئة هي طريقة محددة لكتابة ودمج معايير التجزئة لوصف مجموعة معينة من المستخدمين الذين يطابقون تلك المعايير ومعاملتهم كشريحة جمهور واحدة.

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

الأساسيات

كل جهاز في قاعدة المستخدمين لديك له سمات محددة مرتبطة به عبر قيم العلامات (Tag).

على سبيل المثال، لنفترض أن مستخدمة تدعى جين تعيش في طوكيو، وعمرها 28 عامًا. سيكون لدى هذه المستخدمة العلامات التالية المعينة لجهازها:

• الاسم: جين
• المدينة: طوكيو
• العمر: 28

لاستهداف جين، ستحتاج إلى وصف شريحة على النحو التالي:

T("Name", eq, "Jane") * T("Age", eq, 28) * T("City", eq, "Tokyo")

هذا المزيج من الشروط هو تعبير تصفية يستخدم في لغة التجزئة لوصف مجموعات من المستخدمين، أي شرائح الجمهور.

تعابير التصفية

تعبير التصفية هو سلسلة نصية تحتوي على شرط أو مجموعة من الشروط التي تصف الشريحة التي تحتاجها.

الشروط

يصف كل شرط شريحة من الأجهزة التي تطابق المعايير المحددة في ذلك الشرط.

على سبيل المثال، يبني الشرط التالي شريحة من المستخدمين الذين يعيشون في طوكيو:

T("City", e, "Tokyo")

حيث

• T هي علامة (Tag) (نوع الشرط)؛
• eq هو عامل التشغيل المراد تطبيقه؛
• “Tokyo” هي قيمة العلامة (Tag) التي يربطها المستخدمون بأجهزتهم.

أنواع الشروط

أنواع الشروط التالية متاحة للتجزئة:

• A (Application) – يصف شريحة من الأجهزة التي لديها تطبيق معين مثبت. الأسماء المستعارة: App، Application؛
• T (Tag) – يصف شريحة من الأجهزة ذات قيم العلامات المحددة؛
• AT (App-specific tag) – يُطبق بالاشتراك مع رموز التطبيق للعلامات الخاصة بالتطبيق. الاسم المستعار: Tag؛
• Event – يصف شريحة من الأجهزة التي أطلقت حدثًا معينًا في Pushwoosh؛
• Geo – يصف شريحة من الأجهزة ضمن نصف قطر جغرافي معين؛
• BTTS – يصف شريحة من الأجهزة بناءً على أفضل وقت لإرسال الرسائل إليها؛
• Updated – يصف شريحة من الأجهزة بناءً على آخر طابع زمني لتحديثها؛
• Segment – يشير إلى مرشح/شريحة أخرى برمزها؛

العمليات على الشروط

لبناء شرائح متطورة، يمكن تطبيق العمليات التالية على الشروط ضمن تعبير التصفية:

الاتحاد (+)

يجمع الشرائح، أي يبني شريحة جديدة من المستخدمين الذين يطابقون شرطًا واحدًا على الأقل من الشروط المحددة.

على سبيل المثال، لاستهداف المستخدمين الذين يعيشون في طوكيو أو في أوساكا، ستحتاج إلى وصف الشريحة بالشروط التالية:

T("City", eq, "Tokyo") + T("City", eq, "Osaka")

ملاحظة

يعادل الفصل المنطقي (OR). يمكن كتابته أيضًا كعامل تشغيل or.

التقاطع (*)

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

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

T("City", eq, "Tokyo") * T("Name", any)

ملاحظة

نظير الاقتران المنطقي (AND). يمكن كتابته أيضًا كعامل تشغيل and.

الفرق (\)

يبني شريحة من المستخدمين الذين ينتمون إلى إحدى الشرائح الموصوفة ولا ينتمون إلى الأخرى.

سيتم وصف المستخدمين الذين يعيشون في طوكيو ولكن لم يعطوك أسماءهم على النحو التالي:

T("City", eq, "Tokyo") \ T("Name", any)

ملاحظة

يعادل النفي المنطقي (NOT). يمكن كتابته أيضًا كعامل تشغيل not.

الأقواس

تحدد ترتيب العمليات التي يجب إجراؤها على الشروط في تعبير التصفية الخاص بك.

على سبيل المثال، سيقوم تعبير التصفية التالي أولاً بالحصول على شريحة من مشتركي 12345-67890 الذين يبلغ عمرهم 18 عامًا ثم يطرح جميع الرجال من تلك الشريحة:

( A("12345-67890") * T("Age", eq, 18) ) \ T("Gender", eq, "Male")

عوامل تشغيل شروط العلامات (Tag)

لكل نوع من أنواع العلامات (Tag)، يتم تطبيق عوامل التشغيل الخاصة به.

عوامل تشغيل علامات الأعداد الصحيحة (Integer)

• eq - يساوي قيمة محددة
• noteq - لا يساوي قيمة محددة
• lte - أقل من أو يساوي قيمة محددة
• gte - أكبر من أو يساوي قيمة محددة
• in - أي من القيم المحددة
• notin - لا يساوي أيًا من القيم المحددة
• between - في نطاق محدد
• any - الأجهزة التي لديها أي قيم معينة للعلامة
• notset - الأجهزة التي ليس لديها قيمة معينة للعلامة

مثال على بناء جملة علامات الأعداد الصحيحة

T("int", eq, 42)

عوامل تشغيل علامات السلاسل النصية (String)

• eq - يساوي قيمة محددة
• noteq - لا يساوي قيمة محددة
• startswith - يبدأ ببادئة محددة
• endswith - ينتهي بلاحقة محددة
• contains - يحتوي على سلسلة فرعية محددة
• in - يساوي أيًا من القيم المحددة
• notin - لا يساوي أيًا من القيم المحددة
• any - الأجهزة التي لديها أي قيم معينة للعلامة
• notset - الأجهزة التي ليس لديها قيمة معينة للعلامة

أمثلة على بناء جملة علامات السلاسل النصية

• T("str", eq, "kangaroo") - تطابق تام
• T("str", startswith, "kang") - يبدأ بـ “kang”
• T("str", endswith, "roo") - ينتهي بـ “roo”
• T("str", contains, "nga") - يحتوي على “nga” في أي مكان في السلسلة النصية

عوامل تشغيل علامات القائمة (List)

• in - الأجهزة التي لديها أي من قيم العلامات المحددة
• notin - لا توجد أي من قيم العلامات المحددة مرتبطة بالجهاز
• any - الأجهزة التي لديها أي قيم معينة للعلامة
• notset - الأجهزة التي ليس لديها قيمة معينة للعلامة

مثال على بناء جملة علامات القائمة

T("list", notin, ["kangaroo", "raccoon"])

عوامل تشغيل علامات التاريخ (Date)

• eq - يساوي التاريخ المحدد
• noteq - لا يساوي التاريخ المحدد
• lte - قبل أو في التاريخ المحدد
• gte - بعد أو في التاريخ المحدد
• in - يساوي أيًا من التواريخ المحددة
• notin - لا يساوي أيًا من التواريخ المحددة
• between - في نطاق محدد
• any - الأجهزة التي لديها أي قيم معينة للعلامة
• notset - الأجهزة التي ليس لديها قيمة معينة للعلامة
• match - يطابق شهرًا معينًا من السنة ويومًا معينًا من الشهر.

أمثلة على عامل التشغيل match

• AT("XXXXX-XXXXX", "Date tag", match month 4 day 1) - الأجهزة التي لديها “Date tag” معينًا في الأول من أبريل من أي سنة.
• AT("XXXXX-XXXXX", "Date tag", match month "now" day 13) - الأجهزة التي لديها “Date tag” معينًا في اليوم الثالث عشر من الشهر الحالي.
• AT("XXXXX-XXXXX", "Date tag", match month "now" day "now+2") - الأجهزة التي لديها “Date tag” معينًا بعد غد. حالة استخدام شائعة: تهاني أعياد الميلاد.

أمثلة على عامل التشغيل Match لشرائح الذكرى السنوية وأعياد الميلاد

يمكنك تجزئة المستخدمين بناءً على تواريخ تقويم متكررة، مثل أعياد الميلاد أو الذكرى السنوية. في هذه الحالات، يتم أخذ الشهر واليوم فقط في الاعتبار، بينما يتم تجاهل السنة.

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now") يستهدف المستخدمين الذين عيد ميلادهم اليوم (نفس اليوم والشهر مثل اليوم). استخدم هذا لإرسال تهاني أعياد الميلاد أو عروض خاصة في عيد ميلاد المستخدم الفعلي.

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now+N") يستهدف المستخدمين الذين عيد ميلادهم بعد N يومًا (نفس الشهر واليوم، بعد N يومًا من اليوم). استخدم هذا لتحضير المستخدمين مسبقًا، على سبيل المثال، إرسال رسائل العد التنازلي أو تذكيرات بالأحداث القادمة.

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now-N") يستهدف المستخدمين الذين كان عيد ميلادهم قبل N يومًا. استخدم هذا لرسائل أعياد الميلاد المتأخرة أو المتابعات مثل طلبات التقييم.

• AT("XXXXX-XXXXX", "birthday", match month "now" day N) يستهدف المستخدمين الذين عيد ميلادهم في اليوم N من الشهر الحالي، بغض النظر عن السنة. استخدم هذا عند التخطيط لحملات شهرية ثابتة مرتبطة بتواريخ محددة (على سبيل المثال، مكافآت الولاء الشهرية في اليوم العاشر).

• daysago eq - يساوي عددًا محددًا من الأيام قبل اليوم الحالي
• daysago noteq - لا يساوي عددًا محددًا من الأيام قبل اليوم الحالي
• daysago lte - أقل من أو يساوي عددًا محددًا من الأيام قبل اليوم الحالي
• daysago gte - أكبر من أو يساوي عددًا محددًا من الأيام قبل اليوم الحالي
• daysago between - بين أعداد الأيام المحددة

أمثلة على عامل التشغيل daysago

• T("Date tag", daysago, eq, 0) - اليوم الحالي من الساعة 00:00 حتى اللحظة الحالية
• T("Date tag", daysago, eq, 1) - من الساعة 00:00 من اليوم السابق إلى الساعة 00:00 من اليوم الحالي
• T("Date tag", daysago, gte, 1) - كل الوقت حتى الساعة 00:00 من اليوم الحالي
• T("Date tag", daysago, lte, 7) - من الساعة 00:00 من اليوم قبل 6 أيام حتى اللحظة الحالية
• T("Date tag", daysago, between, [2,7]) - من 7 إلى 2 أيام مضت.

• minutesago lte - أقل من أو يساوي عددًا محددًا من الدقائق قبل اللحظة الحالية
• minutesago gte - أكبر من أو يساوي عددًا محددًا من الدقائق قبل اللحظة الحالية

أمثلة على عامل التشغيل minutesago

• T("Date tag", minutesago, lte, 30) - آخر 30 دقيقة؛
• T("Date tag", minutesago, gte, 60) - قبل 60 دقيقة أو أكثر؛
• T("Date tag", minutesago, lte, 1) - خلال الدقيقة الأخيرة.

مثال على عامل تشغيل التاريخ

• T("Date tag", eq "2022-12-05 00:00:00")

عوامل تشغيل العلامات المنطقية (Boolean)

• eq - يساوي قيمة محددة
• noteq - لا يساوي قيمة محددة
• any - الأجهزة التي لديها أي قيم معينة للعلامة
• notset - الأجهزة التي ليس لديها قيمة معينة للعلامة

مثال على بناء جملة العلامات المنطقية

T("bool", eq, true)

عوامل تشغيل علامات السعر (Price)

• eq - يساوي قيمة محددة
• noteq - لا يساوي قيمة محددة
• lte - أقل من أو يساوي قيمة محددة
• gte - أكبر من أو يساوي قيمة محددة
• in - يساوي أيًا من القيم المحددة
• notin - لا يساوي أيًا من القيم المحددة
• between - في نطاق محدد
• any - الأجهزة التي لديها أي قيم معينة للعلامة
• notset - الأجهزة التي ليس لديها قيمة معينة للعلامة

مثال على بناء جملة علامات السعر

T("price", between, ["4.2", "6.9"])

عوامل تشغيل علامات الإصدار (Version)

• eq - يساوي قيمة محددة
• noteq - لا يساوي قيمة محددة
• lte - أقل من أو يساوي قيمة محددة
• gte - أكبر من أو يساوي قيمة محددة
• in - يساوي أيًا من القيم المحددة
• notin - لا يساوي أيًا من القيم المحددة
• between - في نطاق محدد
• any - الأجهزة التي لديها أي قيم معينة للعلامة
• notset - الأجهزة التي ليس لديها قيمة معينة للعلامة

مثال على بناء جملة علامات الإصدار

T("version", lte, "4.2")

عوامل تشغيل شروط الحدث (Event)

ملاحظة

يرجى الأخذ في الاعتبار أن شروط الحدث خاصة بالتطبيق، لذا يجب تحديد رمز التطبيق في تعابير التصفية الخاصة بك مع اسم الحدث.

عدد الأحداث

• count gte - الأجهزة التي أطلقت الحدث أكثر من أو يساوي n مرة
• count lte - الأجهزة التي أطلقت الحدث أقل من أو يساوي n مرة
• count eq - الأجهزة التي أطلقت الحدث n مرة بالضبط
• count noteq - الأجهزة التي أطلقت الحدث أي عدد من المرات ولكن لا يساوي n

مثال على بناء جملة عدد الأحداث

Event("11111-11111", "Level reached", count gte 10) // 11111-11111 هو رمز التطبيق

تاريخ الحدث

• date gte - الأجهزة التي أطلقت الحدث بعد أو في التاريخ المحدد بالضبط
• date lte - الأجهزة التي أطلقت الحدث قبل أو في التاريخ المحدد بالضبط
• date eq - الأجهزة التي أطلقت الحدث في التاريخ المحدد بالضبط
• date noteq - الأجهزة التي أطلقت الحدث في أي وقت ولكن ليس في التاريخ المحدد
• date in - الأجهزة التي أطلقت الحدث في أي من التواريخ المحددة
• date notin - الأجهزة التي أطلقت الحدث في أي وقت ولكن ليس في أي من التواريخ المحددة
• date between - الأجهزة التي أطلقت الحدث خلال فترة محددة
• date daysago eq - تاريخ إطلاق الحدث يساوي عددًا محددًا من الأيام قبل اليوم الحالي
• date daysago noteq - تاريخ إطلاق الحدث لا يساوي عددًا محددًا من الأيام قبل اليوم الحالي
• date daysago lte - تاريخ إطلاق الحدث أقل من أو يساوي عددًا محددًا من الأيام قبل اليوم الحالي
• date daysago gte - تاريخ إطلاق الحدث أكبر من أو يساوي عددًا محددًا من الأيام قبل اليوم الحالي
• date daysago between - تاريخ إطلاق الحدث بين أعداد الأيام المحددة
• date minutesago lte - تاريخ إطلاق الحدث أقل من أو يساوي عددًا محددًا من الدقائق قبل اللحظة الحالية
• date minutesago gte - تاريخ إطلاق الحدث أكبر من أو يساوي عددًا محددًا من الدقائق قبل اللحظة الحالية

أمثلة على بناء جملة تاريخ الحدث

• Event("11111-11111", "Level reached", date gte "2022-01-01 01:02:03")
• Event("11111-11111", "Level reached", date in ["2022-01-01 01:02:03", "2022-01-01 02:03:04"])
• Event("11111-11111", "Level reached", date between "2022-01-01 01:02:03" "2022-01-01 02:03:04")
• Event("11111-11111", "Level reached", date minutesago lte 30) - الأحداث خلال آخر 30 دقيقة
• Event("11111-11111", "Level reached", date minutesago gte 60) - الأحداث قبل 60 دقيقة أو أكثر

منصات الحدث

تصفية الأحداث حسب المنصة التي تم إطلاقها فيها.

• platforms - قائمة بالمنصات (على سبيل المثال، [“ios”, “android”])

مثال على بناء جملة منصات الحدث

Event("11111-11111", "Level reached", platforms ["android", "ios"], count gte 5)

سمات الحدث

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

سمات الحدث من نوع عدد صحيح (Integer)

• attribute “name” eq - السمة تساوي قيمة محددة
• attribute “name” noteq - السمة لا تساوي قيمة محددة
• attribute “name” gte - السمة أكبر من أو تساوي قيمة محددة
• attribute “name” lte - السمة أقل من أو تساوي قيمة محددة
• attribute “name” between - السمة في نطاق محدد
• attribute “name” in - السمة تساوي أيًا من القيم المحددة
• attribute “name” notin - السمة لا تساوي أيًا من القيم المحددة
• attribute “name” any - أي قيمة معينة للسمة
• attribute “name” notset - لا توجد قيمة معينة للسمة

أمثلة على بناء جملة سمات الأعداد الصحيحة

• Event("11111-11111", "Purchase", attribute "amount" eq 42)
• Event("11111-11111", "Purchase", attribute "amount" between 10 100)
• Event("11111-11111", "Purchase", attribute "amount" in [10, 20, 30])

سمات الحدث من نوع سلسلة نصية (String)

• attribute “name” eq - السمة تساوي قيمة محددة
• attribute “name” noteq - السمة لا تساوي قيمة محددة
• attribute “name” startswith - السمة تبدأ ببادئة محددة
• attribute “name” endswith - السمة تنتهي بلاحقة محددة
• attribute “name” contains - السمة تحتوي على سلسلة فرعية محددة
• attribute “name” in - السمة تساوي أيًا من القيم المحددة
• attribute “name” notin - السمة لا تساوي أيًا من القيم المحددة
• attribute “name” any - أي قيمة معينة للسمة
• attribute “name” notset - لا توجد قيمة معينة للسمة

أمثلة على بناء جملة سمات السلاسل النصية

• Event("11111-11111", "Page View", attribute "url" startswith "https://example.com")
• Event("11111-11111", "Page View", attribute "url" endswith ".html")
• Event("11111-11111", "Page View", attribute "url" contains "/products/")
• Event("11111-11111", "Button Click", attribute "button_name" in ["submit", "cancel"])

سمات الحدث من نوع منطقي (Boolean)

• attribute “name” eq - السمة تساوي true أو false
• attribute “name” noteq - السمة لا تساوي true أو false

مثال على بناء جملة السمات المنطقية

Event("11111-11111", "Feature Toggle", attribute "enabled" eq true)

سمات الحدث من نوع تاريخ (Date)

• attribute “name” eq - السمة تساوي تاريخًا محددًا
• attribute “name” noteq - السمة لا تساوي تاريخًا محددًا
• attribute “name” gte - السمة بعد أو في تاريخ محدد
• attribute “name” lte - السمة قبل أو في تاريخ محدد
• attribute “name” between - السمة ضمن نطاق تاريخ محدد
• attribute “name” in - السمة تساوي أيًا من التواريخ المحددة
• attribute “name” notin - السمة لا تساوي أيًا من التواريخ المحددة
• attribute “name” daysago eq/noteq/gte/lte/between - السمة بالنسبة للأيام الماضية
• attribute “name” minutesago gte/lte - السمة بالنسبة للدقائق الماضية
• attribute “name” any - أي قيمة معينة للسمة
• attribute “name” notset - لا توجد قيمة معينة للسمة

أمثلة على بناء جملة سمات التاريخ

• Event("11111-11111", "Subscription", attribute "start_date" eq "2022-01-01 01:02:03")
• Event("11111-11111", "Subscription", attribute "start_date" between "2022-01-01 00:00:00" "2022-12-31 23:59:59")
• Event("11111-11111", "Subscription", attribute "start_date" daysago lte 30) - خلال آخر 30 يومًا
• Event("11111-11111", "Subscription", attribute "start_date" minutesago gte 60) - قبل 60 دقيقة أو أكثر

سمات الحدث من نوع سعر (Price)

• attribute “name” eq - السمة تساوي قيمة سعر محددة
• attribute “name” noteq - السمة لا تساوي قيمة سعر محددة
• attribute “name” gte - السمة أكبر من أو تساوي سعرًا محددًا
• attribute “name” lte - السمة أقل من أو تساوي سعرًا محددًا
• attribute “name” between - السمة في نطاق سعر محدد
• attribute “name” in - السمة تساوي أيًا من الأسعار المحددة
• attribute “name” notin - السمة لا تساوي أيًا من الأسعار المحددة
• attribute “name” any - أي قيمة معينة للسمة
• attribute “name” notset - لا توجد قيمة معينة للسمة

مثال على بناء جملة سمات السعر

Event("11111-11111", "Purchase", attribute "total_price" between 10.00 50.00)

سمات الحدث من نوع قائمة (List)

• attribute “name” in - السمة تحتوي على أي من القيم المحددة
• attribute “name” notin - السمة لا تحتوي على أي من القيم المحددة
• attribute “name” any - أي قيمة معينة للسمة
• attribute “name” notset - لا توجد قيمة معينة للسمة

مثال على بناء جملة سمات القائمة

Event("11111-11111", "Cart Update", attribute "product_ids" in ["prod-123", "prod-456"])

أنواع شروط إضافية

شرط الموقع الجغرافي (Geo)

استهداف الأجهزة بناءً على الموقع الجغرافي ضمن نصف قطر محدد.

بناء الجملة: Geo("<app-code>", <latitude>, <longitude>, <range-in-km>)

مثال على بناء جملة Geo

Geo("11111-11111", 53.2734, -7.77832031, 100.05) - الأجهزة ضمن 100.05 كم من الإحداثيات

شرط أفضل وقت للإرسال (BTTS)

استهداف الأجهزة حسب أفضل وقت لإرسال الإشعارات إليها (ساعة اليوم، 0-23).

عوامل التشغيل:

• any - أي قيمة معينة لأفضل وقت للإرسال
• eq - تطابق تام للساعة
• noteq - لا يساوي الساعة
• gte - الساعة أكبر من أو تساوي
• lte - الساعة أقل من أو تساوي

أمثلة على بناء جملة BTTS

• BTTS("11111-11111", eq 10) - الأجهزة التي يكون أفضل وقت لها الساعة 10:00
• BTTS("11111-11111", gte 18) - الأجهزة التي يكون أفضل وقت لها من الساعة 18:00 فصاعدًا
• BTTS("11111-11111", any) - الأجهزة التي لديها أي قيمة لأفضل وقت

شرط التحديث (Updated)

تصفية الأجهزة حسب آخر طابع زمني لتحديثها.

عوامل التشغيل:

• gte - تم التحديث بعد أو في تاريخ محدد
• lte - تم التحديث قبل أو في تاريخ محدد
• between - تم التحديث ضمن نطاق تاريخي

أمثلة على بناء جملة Updated

• Updated("11111-11111", gte "2022-01-01 00:00:00") - الأجهزة التي تم تحديثها بعد 1 يناير 2022
• Updated("11111-11111", lte "2022-12-31 23:59:59") - الأجهزة التي تم تحديثها قبل 31 ديسمبر 2022
• Updated("11111-11111", between "2022-01-01 00:00:00" "2022-12-31 23:59:59") - الأجهزة التي تم تحديثها في عام 2022

شرط الشريحة (Segment)

الإشارة إلى مرشح/شريحة أخرى برمزها.

مثال على بناء جملة Segment

Segment("11111-11111", "22222-22222") - الإشارة إلى المرشح بالرمز “22222-22222”

علامات وجود الجهاز في شرط التطبيق

تدعم شروط التطبيق علامات إضافية للتحكم في تصفية الأجهزة والرموز:

• with_tokens - الأجهزة التي لديها رموز إشعارات الدفع
• without_tokens - الأجهزة التي ليس لديها رموز إشعارات الدفع
• with_devices - المستخدمون الذين لديهم أجهزة مسجلة
• without_devices - المستخدمون/الملفات الشخصية التي ليس لديها أجهزة مسجلة

أمثلة على بناء جملة علامات التطبيق

• A("11111-11111", ["ios", "android"], [with_tokens]) - الأجهزة التي لديها رموز دفع
• A("11111-11111", ["ios", "android"], [without_tokens]) - الأجهزة التي ليس لديها رموز دفع
• A("11111-11111", [], [with_devices]) - جميع الأجهزة التي لديها سجلات أجهزة
• A("11111-11111", ["ios", "android"], [without_tokens, with_devices]) - الأجهزة التي ليس لديها رموز ولكن لديها سجلات أجهزة

أمثلة على تعابير التصفية

ملاحظة

عند كتابة استعلامات JSON، تأكد من تهريب علامات الاقتباس (") والشرطات المائلة العكسية (\) بشرطة مائلة عكسية (\). للحصول على مثال للطلب، انظر /exportSegment.

أمثلة أساسية

1. أجهزة iOS و Android التي تم تثبيت التطبيق عليها ولديها رموز دفع:

A("11111-11111", ["ios","android"], [with_tokens])

2. أجهزة iOS و Android التي تم تثبيت التطبيق عليها ولكن ليس لديها رموز دفع:

A("11111-11111", ["ios","android"], [without_tokens])

3. أجهزة iOS و Android التي تم تثبيت التطبيق عليها، سواء كان لديها رموز دفع أم لا:

A("11111-11111", ["ios","android"], [with_tokens, without_tokens])

4. جميع مشتركي التطبيق الذين اشتروا شيئًا ما في التطبيق:

AT("11111-11111", "In-App Purchase", gte, 1)

ملاحظة

يرجى الأخذ في الاعتبار أن العلامات الخاصة بالتطبيق يتم تحديدها كـ AT بدلاً من T، ويجب تحديد رمز التطبيق.

أمثلة متقدمة

5. المستخدمون في طوكيو الذين فتحوا التطبيق في آخر 7 أيام:

T("City", eq, "Tokyo") * Event("11111-11111", "App Open", date daysago lte 7)

6. المستخدمون الذين أجروا عملية شراء تزيد عن 50 دولارًا في آخر 30 يومًا:

Event("11111-11111", "Purchase", attribute "total_price" gte 50.00, date daysago lte 30)

7. المستخدمون الذين تبدأ أسماؤهم بحرف “J” أو تنتهي بحرف “e”:

T("Name", startswith, "J") + T("Name", endswith, "e")

8. مستخدمو iOS النشطون ضمن 100 كم من نيويورك الذين لم يشتروا مؤخرًا:

A("11111-11111", ["ios"], [with_tokens]) * Geo("11111-11111", 40.7128, -74.0060, 100) \ Event("11111-11111", "Purchase", date daysago lte 30)

9. المستخدمون الذين يكون أفضل وقت لإرسال الرسائل إليهم بين الساعة 9 صباحًا و 5 مساءً:

BTTS("11111-11111", gte 9) * BTTS("11111-11111", lte 17)

10. المستخدمون الذين أطلقوا حدثًا معينًا على Android أو iOS في الساعة الأخيرة:

Event("11111-11111", "Button Click", platforms ["android", "ios"], date minutesago lte 60)

11. الأجهزة التي تم تحديثها في آخر 3 أشهر بإصدار التطبيق 4.2 أو أعلى:

Updated("11111-11111", gte "2024-07-01 00:00:00") * AT("11111-11111", "App Version", gte, "4.2")