ภาษาการแบ่งส่วน (Segmentation Language)

Pushwoosh มีเอนจิ้นการแบ่งส่วนที่มีประสิทธิภาพสำหรับการสร้าง Segments แบบละเอียดตามค่า Tag Segmentation Language เป็นวิธีการเขียนและรวมเกณฑ์การแบ่งส่วนที่เฉพาะเจาะจงเพื่ออธิบายกลุ่มผู้ใช้ที่ตรงกับเกณฑ์เหล่านั้นและถือว่าเป็นกลุ่มเป้าหมาย (audience segment) เดียวกัน

บทความนี้อธิบายแนวคิดพื้นฐานและ синтаксис ของ Segmentation Language และให้ตัวอย่างที่ครอบคลุมของการสร้างเกณฑ์การแบ่งส่วนสำหรับกรณีต่างๆ

พื้นฐาน

อุปกรณ์แต่ละเครื่องในฐานผู้ใช้ของคุณมีแอตทริบิวต์เฉพาะที่เชื่อมโยงผ่าน ค่า Tag

ตัวอย่างเช่น สมมติว่าผู้ใช้ชื่อ Jane อาศัยอยู่ในโตเกียว และอายุ 28 ปี ผู้ใช้รายนั้นจะมี Tags ต่อไปนี้ตั้งค่าไว้สำหรับอุปกรณ์ของพวกเขา:

• Name: Jane
• City: Tokyo
• Age: 28

ในการกำหนดเป้าหมาย Jane คุณจะต้องอธิบาย segment ดังนี้:

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

การรวมกันของเงื่อนไขนี้คือ filter expression ที่ใช้ใน Segmentation Language สำหรับการอธิบายกลุ่มผู้ใช้หรือที่เรียกว่า audience Segments

Filter expressions

Filter expression คือสตริงที่ประกอบด้วยเงื่อนไขหรือการรวมกันของเงื่อนไขที่อธิบาย segment ที่คุณต้องการ

เงื่อนไข

แต่ละเงื่อนไขจะอธิบาย segment ของอุปกรณ์ที่ตรงกับเกณฑ์ที่ระบุในเงื่อนไขนั้น

ตัวอย่างเช่น เงื่อนไขต่อไปนี้จะสร้าง segment ของผู้ใช้ที่อาศัยอยู่ในโตเกียว:

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

โดยที่

• T คือ Tag (ประเภทเงื่อนไข);
• eq คือตัวดำเนินการที่จะใช้;
• “Tokyo” คือค่า Tag ที่ผู้ใช้เชื่อมโยงกับอุปกรณ์ของตน

ประเภทของเงื่อนไข

ประเภทของเงื่อนไขต่อไปนี้พร้อมใช้งานสำหรับการแบ่งส่วน:

• A (Application) – อธิบาย segment ของอุปกรณ์ที่ติดตั้งแอปพลิเคชันเฉพาะ Aliases: App, Application;
• T (Tag) – อธิบาย segment ของอุปกรณ์ที่มีค่า Tag ที่ระบุ;
• AT (App-specific tag) – ใช้ร่วมกับรหัสแอปสำหรับ tag ที่เป็นของแอปนั้นๆ Alias: Tag;
• Event – อธิบาย segment ของอุปกรณ์ที่ทริกเกอร์ Event ของ Pushwoosh ที่ระบุ;
• Geo – อธิบาย segment ของอุปกรณ์ภายในรัศมีทางภูมิศาสตร์ที่ระบุ;
• BTTS – อธิบาย segment ของอุปกรณ์ตามเวลาที่ดีที่สุดในการส่ง (best time to send);
• Updated – อธิบาย segment ของอุปกรณ์ตามการประทับเวลาอัปเดตล่าสุด;
• Segment – อ้างอิงถึง filter/segment อื่นโดยใช้รหัสของมัน;

การดำเนินการกับเงื่อนไข

สำหรับการสร้าง segments ที่ซับซ้อน สามารถใช้การดำเนินการต่อไปนี้กับเงื่อนไขภายใน filter expression ได้:

Union (+)

รวม segments เข้าด้วยกัน กล่าวคือ สร้าง segment ใหม่ของผู้ใช้ที่ตรงกับเงื่อนไขที่ระบุอย่างน้อยหนึ่งเงื่อนไข

ตัวอย่างเช่น หากต้องการกำหนดเป้าหมายผู้ใช้ที่อาศับอยู่ในโตเกียวหรือโอซาก้า คุณจะต้องอธิบาย segment ด้วยเงื่อนไขต่อไปนี้:

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

หมายเหตุ

เทียบเท่ากับ disjunction เชิงตรรกะ (OR) สามารถเขียนเป็นตัวดำเนินการ or ได้เช่นกัน

Intersection (*)

สร้าง segment ของผู้ใช้ที่เป็นของทั้งสอง segments ที่อธิบายโดยเงื่อนไข ดังนั้น จะรวมเฉพาะผู้ใช้ที่ปฏิบัติตามแต่ละเงื่อนไขที่คุณระบุเท่านั้น

นิพจน์ต่อไปนี้อธิบาย segment ของผู้ใช้ที่อาศัยอยู่ในโตเกียวและได้ระบุชื่อของตนเอง:

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

หมายเหตุ

คล้ายกับ conjunction เชิงตรรกะ (AND) สามารถเขียนเป็นตัวดำเนินการ and ได้เช่นกัน

Difference (\)

สร้าง segment ของผู้ใช้ที่เป็นของหนึ่งใน segments ที่อธิบายไว้และไม่ได้เป็นของอีก segment หนึ่ง

ผู้ใช้ที่อาศัยอยู่ในโตเกียวแต่ไม่ได้ให้ชื่อของตนเองจะถูกอธิบายดังนี้:

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

หมายเหตุ

เทียบเท่ากับ negation เชิงตรรกะ (NOT) สามารถเขียนเป็นตัวดำเนินการ not ได้เช่นกัน

วงเล็บ

กำหนดลำดับของการดำเนินการที่จะทำกับเงื่อนไขใน filter expression ของคุณ

ตัวอย่างเช่น filter expression ต่อไปนี้จะทำการดึง segment ของผู้สมัครสมาชิก 12345-67890 ที่มีอายุ 18 ปีก่อน จากนั้นจึงลบผู้ชายทั้งหมดออกจาก segment นั้น:

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

ตัวดำเนินการเงื่อนไข Tag

สำหรับ Tag แต่ละประเภท จะมีการใช้ตัวดำเนินการของตัวเอง

ตัวดำเนินการสำหรับ Integer Tags

• eq - เท่ากับค่าที่ระบุ
• noteq - ไม่เท่ากับค่าที่ระบุ
• lte - น้อยกว่าหรือเท่ากับค่าที่ระบุ
• gte - มากกว่าหรือเท่ากับค่าที่ระบุ
• in - ค่าใดค่าหนึ่งจากค่าที่ระบุ
• notin - ไม่เท่ากับค่าใดๆ ที่ระบุ
• between - อยู่ในช่วงที่ระบุ
• any - อุปกรณ์ที่มีการตั้งค่าใดๆ สำหรับ tag
• notset - อุปกรณ์ที่ไม่มีการตั้งค่าสำหรับ tag

ตัวอย่าง синтаксис ของ Integer Tags

T("int", eq, 42)

ตัวดำเนินการสำหรับ String Tags

• eq - เท่ากับค่าที่ระบุ
• noteq - ไม่เท่ากับค่าที่ระบุ
• startswith - ขึ้นต้นด้วยคำนำหน้าที่ระบุ
• endswith - ลงท้ายด้วยคำต่อท้ายที่ระบุ
• contains - มีสตริงย่อยที่ระบุ
• in - เท่ากับค่าใดๆ ที่ระบุ
• notin - ไม่เท่ากับค่าใดๆ ที่ระบุ
• any - อุปกรณ์ที่มีการตั้งค่าใดๆ สำหรับ tag
• notset - อุปกรณ์ที่ไม่มีการตั้งค่าสำหรับ tag

ตัวอย่าง синтаксис ของ String Tags

• T("str", eq, "kangaroo") - ตรงกันทุกประการ
• T("str", startswith, "kang") - ขึ้นต้นด้วย “kang”
• T("str", endswith, "roo") - ลงท้ายด้วย “roo”
• T("str", contains, "nga") - มี “nga” อยู่ที่ใดก็ได้ในสตริง

ตัวดำเนินการสำหรับ List Tags

• in - อุปกรณ์ที่มีค่า tag ใดๆ ที่ระบุ
• notin - ไม่มีค่า tag ใดๆ ที่ระบุเชื่อมโยงกับอุปกรณ์
• any - อุปกรณ์ที่มีการตั้งค่าใดๆ สำหรับ tag
• notset - อุปกรณ์ที่ไม่มีการตั้งค่าสำหรับ tag

ตัวอย่าง синтаксис ของ List Tags

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

ตัวดำเนินการสำหรับ Date Tags

• eq - เท่ากับวันที่ที่ระบุ
• noteq - ไม่เท่ากับวันที่ที่ระบุ
• lte - ก่อนหรือในวันที่ที่ระบุ
• gte - หลังหรือในวันที่ที่ระบุ
• in - เท่ากับวันที่ใดๆ ที่ระบุ
• notin - ไม่เท่ากับวันที่ใดๆ ที่ระบุ
• between - อยู่ในช่วงที่ระบุ
• any - อุปกรณ์ที่มีการตั้งค่าใดๆ สำหรับ tag
• notset - อุปกรณ์ที่ไม่มีการตั้งค่าสำหรับ tag
• match - ตรงกับเดือนและวันที่ของเดือนที่ระบุ

ตัวอย่างตัวดำเนินการ match

• AT("XXXXX-XXXXX", "Date tag", match month 4 day 1) - อุปกรณ์ที่มี “Date tag” ตั้งค่าเป็นวันที่ 1 เมษายนของปีใดก็ได้
• AT("XXXXX-XXXXX", "Date tag", match month "now" day 13) - อุปกรณ์ที่มี “Date tag” ตั้งค่าเป็นวันที่ 13 ของเดือนปัจจุบัน
• AT("XXXXX-XXXXX", "Date tag", match month "now" day "now+2") - อุปกรณ์ที่มี “Date tag” ตั้งค่าเป็นวันมะรืนนี้ กรณีการใช้งานทั่วไป: การอวยพรวันเกิด

ตัวอย่างตัวดำเนินการ Match สำหรับ segment วันครบรอบและวันเกิด

คุณสามารถ แบ่งส่วนผู้ใช้ตามวันที่ในปฏิทินที่เกิดซ้ำ เช่น วันเกิดหรือวันครบรอบ ในกรณีเหล่านี้ จะพิจารณาเฉพาะเดือนและวันเท่านั้น โดยไม่สนใจปี

• 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 ของเดือนปัจจุบัน โดยไม่คำนึงถึงปี ใช้สิ่งนี้เมื่อวางแผนแคมเปญรายเดือนที่ผูกกับวันที่เฉพาะ (เช่น รางวัลความภักดีรายเดือนในวันที่ 10)

• 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) - ภายในนาทีล่าสุด

ตัวอย่างตัวดำเนินการ date

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

ตัวดำเนินการสำหรับ Boolean Tags

• eq - เท่ากับค่าที่ระบุ
• noteq - ไม่เท่ากับค่าที่ระบุ
• any - อุปกรณ์ที่มีการตั้งค่าใดๆ สำหรับ tag
• notset - อุปกรณ์ที่ไม่มีการตั้งค่าสำหรับ tag

ตัวอย่าง синтаксис ของ Boolean Tags

T("bool", eq, true)

ตัวดำเนินการสำหรับ Price Tags

• eq - เท่ากับค่าที่ระบุ
• noteq - ไม่เท่ากับค่าที่ระบุ
• lte - น้อยกว่าหรือเท่ากับค่าที่ระบุ
• gte - มากกว่าหรือเท่ากับค่าที่ระบุ
• in - เท่ากับค่าใดๆ ที่ระบุ
• notin - ไม่เท่ากับค่าใดๆ ที่ระบุ
• between - อยู่ในช่วงที่ระบุ
• any - อุปกรณ์ที่มีการตั้งค่าใดๆ สำหรับ tag
• notset - อุปกรณ์ที่ไม่มีการตั้งค่าสำหรับ tag

ตัวอย่าง синтаксиส ของ Price Tags

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

ตัวดำเนินการสำหรับ Version Tags

• eq - เท่ากับค่าที่ระบุ
• noteq - ไม่เท่ากับค่าที่ระบุ
• lte - น้อยกว่าหรือเท่ากับค่าที่ระบุ
• gte - มากกว่าหรือเท่ากับค่าที่ระบุ
• in - เท่ากับค่าใดๆ ที่ระบุ
• notin - ไม่เท่ากับค่าใดๆ ที่ระบุ
• between - อยู่ในช่วงที่ระบุ
• any - อุปกรณ์ที่มีการตั้งค่าใดๆ สำหรับ tag
• notset - อุปกรณ์ที่ไม่มีการตั้งค่าสำหรับ tag

ตัวอย่าง синтаксис ของ Version Tags

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

ตัวดำเนินการเงื่อนไข Event

หมายเหตุ

โปรดทราบว่าเงื่อนไข event เป็นแบบเฉพาะแอป ดังนั้นควรระบุรหัสแอปใน filter expressions ของคุณพร้อมกับชื่อ event

จำนวน Event

• count gte - อุปกรณ์ที่ทริกเกอร์ event มากกว่าหรือเท่ากับ n ครั้ง
• count lte - อุปกรณ์ที่ทริกเกอร์ event น้อยกว่าหรือเท่ากับ n ครั้ง
• count eq - อุปกรณ์ที่ทริกเกอร์ event เท่ากับ n ครั้งพอดี
• count noteq - อุปกรณ์ที่ทริกเกอร์ event กี่ครั้งก็ได้แต่ไม่เท่ากับ n

ตัวอย่าง синтаксис ของจำนวน Event

Event("11111-11111", "Level reached", count gte 10) // 11111-11111 คือรหัสแอป

วันที่ของ Event

• date gte - อุปกรณ์ที่ทริกเกอร์ event ช้ากว่าหรือตรงกับวันที่ที่ระบุ
• date lte - อุปกรณ์ที่ทริกเกอร์ event เร็วกว่าหรือตรงกับวันที่ที่ระบุ
• date eq - อุปกรณ์ที่ทริกเกอร์ event ตรงกับวันที่ที่ระบุพอดี
• date noteq - อุปกรณ์ที่ทริกเกอร์ event เมื่อใดก็ได้แต่ไม่ใช่ในวันที่ที่ระบุ
• date in - อุปกรณ์ที่ทริกเกอร์ event ในวันที่ใดๆ ที่ระบุ
• date notin - อุปกรณ์ที่ทริกเกอร์ event เมื่อใดก็ได้แต่ไม่ใช่ในวันที่ใดๆ ที่ระบุ
• date between - อุปกรณ์ที่ทริกเกอร์ event ภายในช่วงเวลาที่ระบุ
• date daysago eq - วันที่ทริกเกอร์ event เท่ากับจำนวนวันที่ระบุก่อนวันปัจจุบัน
• date daysago noteq - วันที่ทริกเกอร์ event ไม่เท่ากับจำนวนวันที่ระบุก่อนวันปัจจุบัน
• date daysago lte - วันที่ทริกเกอร์ event น้อยกว่าหรือเท่ากับจำนวนวันที่ระบุก่อนวันปัจจุบัน
• date daysago gte - วันที่ทริกเกอร์ event มากกว่าหรือเท่ากับจำนวนวันที่ระบุก่อนวันปัจจุบัน
• date daysago between - วันที่ทริกเกอร์ event อยู่ระหว่างจำนวนวันที่ระบุ
• date minutesago lte - วันที่ทริกเกอร์ event น้อยกว่าหรือเท่ากับจำนวนนาทีที่ระบุก่อนช่วงเวลาปัจจุบัน
• date minutesago gte - วันที่ทริกเกอร์ event มากกว่าหรือเท่ากับจำนวนนาทีที่ระบุก่อนช่วงเวลาปัจจุบัน

ตัวอย่าง синтаксис ของวันที่ Event

• 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) - events ภายใน 30 นาทีล่าสุด
• Event("11111-11111", "Level reached", date minutesago gte 60) - events เมื่อ 60+ นาทีที่แล้ว

แพลตฟอร์มของ Event

กรอง events ตามแพลตฟอร์มที่ถูกทริกเกอร์

• platforms - รายการแพลตฟอร์ม (เช่น [“ios”, “android”])

ตัวอย่าง синтаксис ของแพลตฟอร์ม Event

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

แอตทริบิวต์ของ Event

เงื่อนไข Event สามารถกรองตามค่าแอตทริบิวต์ของ event ได้ แอตทริบิวต์รองรับประเภทข้อมูลต่างๆ พร้อมตัวดำเนินการที่สอดคล้องกัน

แอตทริบิวต์ Event ประเภท 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 - ไม่มีการตั้งค่าสำหรับแอตทริบิวต์

ตัวอย่าง синтаксис ของแอตทริบิวต์ Integer

• 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])

แอตทริบิวต์ Event ประเภท 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 - ไม่มีการตั้งค่าสำหรับแอตทริบิวต์

ตัวอย่าง синтаксис ของแอตทริบิวต์ String

• 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"])

แอตทริบิวต์ Event ประเภท Boolean

• attribute “name” eq - แอตทริบิวต์เท่ากับ true หรือ false
• attribute “name” noteq - แอตทริบิวต์ไม่เท่ากับ true หรือ false

ตัวอย่าง синтаксис ของแอตทริบิวต์ Boolean

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

แอตทริบิวต์ Event ประเภท 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 - ไม่มีการตั้งค่าสำหรับแอตทริบิวต์

ตัวอย่าง синтаксис ของแอตทริบิวต์ Date

• 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+ นาทีที่แล้ว

แอตทริบิวต์ Event ประเภท 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 - ไม่มีการตั้งค่าสำหรับแอตทริบิวต์

ตัวอย่าง синтаксис ของแอตทริบิวต์ Price

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

แอตทริบิวต์ Event ประเภท List

• attribute “name” in - แอตทริบิวต์มีค่าใดๆ ที่ระบุ
• attribute “name” notin - แอตทริบิวต์ไม่มีค่าใดๆ ที่ระบุ
• attribute “name” any - มีการตั้งค่าใดๆ สำหรับแอตทริบิวต์
• attribute “name” notset - ไม่มีการตั้งค่าสำหรับแอตทริบิวต์

ตัวอย่าง синтаксис ของแอตทริบิวต์ List

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

ประเภทเงื่อนไขเพิ่มเติม

เงื่อนไข Geo

กำหนดเป้าหมายอุปกรณ์ตามตำแหน่งทางภูมิศาสตร์ภายในรัศมีที่ระบุ

Syntax: 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

อ้างอิงถึง filter/segment อื่นโดยใช้รหัสของมัน

ตัวอย่าง синтаксис ของ Segment

Segment("11111-11111", "22222-22222") - อ้างอิง filter ด้วยรหัส “22222-22222”

แฟล็กการมีอยู่ของอุปกรณ์ในเงื่อนไข Application

เงื่อนไข Application รองรับแฟล็กเพิ่มเติมเพื่อควบคุมการกรองอุปกรณ์และโทเค็น:

• with_tokens - อุปกรณ์ที่มี push notification tokens
• without_tokens - อุปกรณ์ที่ไม่มี push notification tokens
• with_devices - ผู้ใช้ที่มีอุปกรณ์ที่ลงทะเบียน
• without_devices - ผู้ใช้/โปรไฟล์ที่ไม่มีอุปกรณ์ที่ลงทะเบียน

ตัวอย่าง синтаксис ของแฟล็ก Application

• A("11111-11111", ["ios", "android"], [with_tokens]) - อุปกรณ์ที่มี push tokens
• A("11111-11111", ["ios", "android"], [without_tokens]) - อุปกรณ์ที่ไม่มี push tokens
• A("11111-11111", [], [with_devices]) - อุปกรณ์ทั้งหมดที่มีบันทึกอุปกรณ์
• A("11111-11111", ["ios", "android"], [without_tokens, with_devices]) - อุปกรณ์ที่ไม่มีโทเค็นแต่มีบันทึกอุปกรณ์

ตัวอย่าง Filter expression

หมายเหตุ

เมื่อเขียนคำสั่ง JSON โปรดตรวจสอบให้แน่ใจว่าได้ escape เครื่องหมายคำพูด (") และ backslashes (\) ด้วย backslash (\) สำหรับตัวอย่างคำขอ ดูที่ /exportSegment

ตัวอย่างพื้นฐาน

1. อุปกรณ์ iOS และ Android ที่ติดตั้งแอปและมี push tokens:

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

2. อุปกรณ์ iOS และ Android ที่ติดตั้งแอปแต่ไม่มี push tokens:

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

3. อุปกรณ์ iOS และ Android ที่ติดตั้งแอป ไม่ว่าจะมี push tokens หรือไม่:

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

4. ผู้สมัครสมาชิกแอปทั้งหมดที่ซื้อของในแอป:

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

หมายเหตุ

โปรดทราบว่า app-specific tags จะถูกกำหนดเป็น 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.00 น. ถึง 17.00 น.:

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

10. ผู้ใช้ที่ทริกเกอร์ event ที่ระบุบน 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")