Segmentierungssprache

Pushwoosh bietet eine leistungsstarke Segmentierungs-Engine zum Erstellen granularer Segmente basierend auf Tag-Werten. Die Segmentierungssprache ist eine spezielle Methode zum Schreiben und Kombinieren von Segmentierungskriterien, um eine bestimmte Gruppe von Benutzern zu beschreiben, die diesen Kriterien entsprechen, und sie als ein einziges Zielgruppensegment zu behandeln.

Dieser Artikel beschreibt die grundlegenden Konzepte und die Syntax der Segmentierungssprache und bietet umfassende Beispiele für die Erstellung von Segmentierungskriterien für verschiedene Fälle.

Inline-Verwendung ohne gespeichertes Segment

Ein Filterausdruck muss nicht zu einem gespeicherten Segment gehören. Übergeben Sie einen direkt im Feld expression von NotifySegment, um eine einzelne Sendung zu adressieren – es wird kein Segment erstellt und der Ausdruck wird nicht im Konto gespeichert.

curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segment": {
      "application": "XXXXX-XXXXX",
      "platforms": ["IOS", "ANDROID"],
      "expression": "T(\"City\", eq, \"Tokyo\") * T(\"Age\", gte, 18)",
      "payload": {
        "content": {
          "localized_content": {
            "en": { "ios": { "body": "Hello, Tokyo!" } }
          }
        }
      },
      "schedule": { "at": "2026-05-01T12:00:00Z" }
    }
  }'

Hinweis

Inline-Ausdrücke werden zur Sendezeit ausgewertet und überspringen die Vorkompilierung – sie funktionieren nicht mit der High-Speed Delivery, die ein gespeichertes Segment erfordert, auf das über code verwiesen wird.

Grundlagen

Jedes Gerät in Ihrer Benutzerbasis hat spezifische Attribute, die ihm über Tag-Werte zugeordnet sind.

Nehmen wir zum Beispiel an, eine Benutzerin namens Jane lebt in Tokio und ist 28 Jahre alt. Für das Gerät dieser Benutzerin werden die folgenden Tags gesetzt:

• Name: Jane
• Stadt: Tokio
• Alter: 28

Um Jane anzusprechen, müssen Sie ein Segment wie folgt beschreiben:

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

Diese Kombination von Bedingungen ist ein Filterausdruck, der in der Segmentierungssprache verwendet wird, um Benutzergruppen, auch Zielgruppensegmente genannt, zu beschreiben.

Filterausdrücke

Ein Filterausdruck ist eine Zeichenfolge, die eine Bedingung oder eine Kombination von Bedingungen enthält, die das von Ihnen benötigte Segment beschreiben.

Bedingungen

Jede Bedingung beschreibt ein Segment von Geräten, die den in dieser Bedingung angegebenen Kriterien entsprechen.

Die folgende Bedingung erstellt beispielsweise ein Segment von Benutzern, die in Tokio leben:

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

wobei

• T ein Tag ist (Bedingungstyp);
• eq ein anzuwendender Operator ist;
• „Tokyo“ ein Tag-Wert ist, den Benutzer ihren Geräten zugeordnet haben.

Bedingungstypen

Die folgenden Bedingungstypen sind für die Segmentierung verfügbar:

• A (Anwendung) – beschreibt ein Segment von Geräten, auf denen eine bestimmte App installiert ist. Aliase: App, Application;
• T (Tag) – beschreibt ein Segment von Geräten mit den angegebenen Tag-Werten;
• AT (App-bezogener Tag) – sucht einen Tag-Wert innerhalb einer bestimmten Anwendung; der App-Code ist als erstes Argument erforderlich. Alias: Tag;
• Event – beschreibt ein Segment von Geräten, die ein bestimmtes Pushwoosh-Ereignis ausgelöst haben;
• Geo – beschreibt ein Segment von Geräten innerhalb eines bestimmten geografischen Radius;
• BTTS – beschreibt ein Segment von Geräten basierend auf ihrer besten Sendezeit;
• Updated – beschreibt ein Segment von Geräten basierend auf ihrem letzten Aktualisierungszeitstempel;
• Segment – verweist auf einen anderen Filter/ein anderes Segment über dessen Code;

Operationen mit Bedingungen

Für die Erstellung komplexer Segmente können die folgenden Operationen auf Bedingungen innerhalb des Filterausdrucks angewendet werden:

Vereinigung (+)

Verbindet die Segmente, d. h. erstellt ein neues Segment von Benutzern, die mindestens einer der angegebenen Bedingungen entsprechen.

Um beispielsweise Benutzer anzusprechen, die in Tokio oder Osaka leben, müssen Sie das Segment mit den folgenden Bedingungen beschreiben:

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

Hinweis

Entspricht der logischen Disjunktion (ODER). Kann auch als or-Operator geschrieben werden.

Schnittmenge (*)

Erstellt ein Segment von Benutzern, die zu beiden durch die Bedingungen beschriebenen Segmenten gehören. Es werden also nur diejenigen Benutzer einbezogen, die jede von Ihnen angegebene Bedingung erfüllen.

Der folgende Ausdruck beschreibt ein Segment von Benutzern, die sowohl in Tokio leben als auch ihre Namen angegeben haben:

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

Hinweis

Analog zur logischen Konjunktion (UND). Kann auch als and-Operator geschrieben werden.

Differenz (\)

Erstellt ein Segment von Benutzern, die zu einem der beschriebenen Segmente gehören und nicht zu einem anderen.

Benutzer, die in Tokio leben, aber Ihnen ihre Namen nicht mitgeteilt haben, werden wie folgt beschrieben:

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

Hinweis

Entspricht der logischen Negation (NICHT). Kann auch als not-Operator geschrieben werden.

Klammern

Bestimmen die Reihenfolge der Operationen, die mit den Bedingungen in Ihrem Filterausdruck ausgeführt werden sollen.

Der folgende Filterausdruck ermittelt beispielsweise zuerst ein Segment der Abonnenten von 12345-67890, deren Alter 18 ist, und subtrahiert dann alle Männer dieses Segments:

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

Operatoren für Tag-Bedingungen

Für jeden Tag-Typ werden eigene Operatoren angewendet.

Integer-Tag-Operatoren

• eq - gleich einem angegebenen Wert
• noteq - ungleich einem angegebenen Wert
• lte - kleiner oder gleich einem angegebenen Wert
• gte - größer oder gleich einem angegebenen Wert
• in - einer der angegebenen Werte
• notin - ungleich einem der angegebenen Werte
• between - in einem angegebenen Bereich
• any - Geräte mit beliebigen für den Tag gesetzten Werten
• notset - Geräte ohne für den Tag gesetzten Wert

Syntaxbeispiel für Integer-Tags

T("int", eq, 42)

String-Tag-Operatoren

• eq - gleich einem angegebenen Wert
• noteq - ungleich einem angegebenen Wert
• startswith - beginnt mit einem angegebenen Präfix
• endswith - endet mit einem angegebenen Suffix
• contains - enthält eine angegebene Teilzeichenfolge
• in - gleich einem der angegebenen Werte
• notin - ungleich einem der angegebenen Werte
• any - Geräte mit beliebigen für den Tag gesetzten Werten
• notset - Geräte ohne für den Tag gesetzten Wert

Syntaxbeispiele für String-Tags

• T("str", eq, "kangaroo") - exakte Übereinstimmung
• T("str", startswith, "kang") - beginnt mit „kang“
• T("str", endswith, "roo") - endet mit „roo“
• T("str", contains, "nga") - enthält „nga“ an beliebiger Stelle in der Zeichenfolge

Listen-Tag-Operatoren

• in - Geräte mit einem der angegebenen Tag-Werte
• notin - keiner der angegebenen Tag-Werte ist dem Gerät zugeordnet
• any - Geräte mit beliebigen für den Tag gesetzten Werten
• notset - Geräte ohne für den Tag gesetzten Wert

Syntaxbeispiel für Listen-Tags

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

Datums-Tag-Operatoren

• eq - gleich dem angegebenen Datum
• noteq - ungleich dem angegebenen Datum
• lte - vor oder am angegebenen Datum
• gte - nach oder am angegebenen Datum
• in - gleich einem der angegebenen Daten
• notin - ungleich einem der angegebenen Daten
• between - in einem angegebenen Bereich
• any - Geräte mit beliebigen für den Tag gesetzten Werten
• notset - Geräte ohne für den Tag gesetzten Wert
• match - entspricht einem angegebenen Monat des Jahres und Tag des Monats.

Beispiele für den match-Operator

• AT("XXXXX-XXXXX", "Date tag", match month 4 day 1) - Geräte, bei denen der „Date tag“ auf den 1. April eines beliebigen Jahres gesetzt ist.
• AT("XXXXX-XXXXX", "Date tag", match month "now" day 13) - Geräte, bei denen der „Date tag“ auf den 13. Tag des aktuellen Monats gesetzt ist.
• AT("XXXXX-XXXXX", "Date tag", match month "now" day "now+2") - Geräte, bei denen der „Date tag“ auf übermorgen gesetzt ist. Häufiger Anwendungsfall: Geburtstagsgrüße.

Beispiele für den Match-Operator für Jubiläums- und Geburtstagssegmente

Sie können Benutzer basierend auf wiederkehrenden Kalenderdaten segmentieren, wie z. B. Geburtstagen oder Jubiläen. In diesen Fällen werden nur Monat und Tag berücksichtigt, während das Jahr ignoriert wird.

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now") Zielt auf Benutzer ab, deren Geburtstag heute ist (derselbe Tag und Monat wie heute). Verwenden Sie dies, um Geburtstagsgrüße oder Sonderangebote am tatsächlichen Geburtstag des Benutzers zu senden.

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now+N") Zielt auf Benutzer ab, deren Geburtstag in N Tagen ist (derselbe Monat und Tag, N Tage ab heute). Verwenden Sie dies, um Benutzer im Voraus vorzubereiten, z. B. um Countdown-Nachrichten oder Erinnerungen an bevorstehende Ereignisse zu senden.

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now-N") Zielt auf Benutzer ab, deren Geburtstag vor N Tagen war. Verwenden Sie dies für verspätete Geburtstagsnachrichten oder Follow-ups wie Feedback-Anfragen.

• AT("XXXXX-XXXXX", "birthday", match month "now" day N) Zielt auf Benutzer ab, deren Geburtstag am N-ten Tag des aktuellen Monats ist, unabhängig vom Jahr. Verwenden Sie dies bei der Planung fester monatlicher Kampagnen, die an bestimmte Daten gebunden sind (z. B. monatliche Treueprämien am 10.).

• daysago eq - gleich einer angegebenen Anzahl von Tagen vor dem heutigen Tag
• daysago noteq - ungleich einer angegebenen Anzahl von Tagen vor dem heutigen Tag
• daysago lte - kleiner oder gleich einer angegebenen Anzahl von Tagen vor dem heutigen Tag
• daysago gte - größer oder gleich einer angegebenen Anzahl von Tagen vor dem heutigen Tag
• daysago between - zwischen der angegebenen Anzahl von Tagen

Beispiele für den daysago-Operator

• T("Date tag", daysago, eq, 0) - der heutige Tag von 00:00 Uhr bis zum aktuellen Zeitpunkt
• T("Date tag", daysago, eq, 1) - vom 00:00 Uhr des Vortages bis 00:00 Uhr des heutigen Tages
• T("Date tag", daysago, gte, 1) - die ganze Zeit bis 00:00 Uhr des heutigen Tages
• T("Date tag", daysago, lte, 7) - von 00:00 Uhr des Tages vor 6 Tagen bis zum aktuellen Zeitpunkt
• T("Date tag", daysago, between, [2,7]) - von vor 7 bis vor 2 Tagen.

• minutesago lte - kleiner oder gleich einer angegebenen Anzahl von Minuten vor dem jetzigen Zeitpunkt
• minutesago gte - größer oder gleich einer angegebenen Anzahl von Minuten vor dem jetzigen Zeitpunkt

Beispiele für den minutesago-Operator

• T("Date tag", minutesago, lte, 30) - die letzten 30 Minuten;
• T("Date tag", minutesago, gte, 60) - vor 60 oder mehr Minuten;
• T("Date tag", minutesago, lte, 1) - innerhalb der letzten Minute.

• daysahead - in N bis M Tagen ab dem heutigen Tag (UTC), beidseitig einschließlich

Beispiele für den daysahead-Operator

daysahead verwendet ein [von, bis]-Intervall (Tage ab heute Mitternacht UTC, beide Enden einschließlich). Im Gegensatz zu daysago hat es keinen Unteroperator – nur die Intervallform.

• T("Date tag", daysahead, [0, 0]) - der heutige Tag von 00:00 bis 23:59:59
• T("Date tag", daysahead, [1, 1]) - der nächste Tag von 00:00 bis 23:59:59
• T("Date tag", daysahead, [2, 5]) - jeder Zeitpunkt vom Beginn in 2 Tagen bis zum Ende in 5 Tagen

Beispiel für den date-Operator

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

Boolesche Tag-Operatoren

• eq - gleich einem angegebenen Wert
• noteq - ungleich einem angegebenen Wert
• any - Geräte mit beliebigen für den Tag gesetzten Werten
• notset - Geräte ohne für den Tag gesetzten Wert

Syntaxbeispiel für boolesche Tags

T("bool", eq, true)

Preis-Tag-Operatoren

• eq - gleich einem angegebenen Wert
• noteq - ungleich einem angegebenen Wert
• lte - kleiner oder gleich einem angegebenen Wert
• gte - größer oder gleich einem angegebenen Wert
• in - gleich einem der angegebenen Werte
• notin - ungleich einem der angegebenen Werte
• between - in einem angegebenen Bereich
• any - Geräte mit beliebigen für den Tag gesetzten Werten
• notset - Geräte ohne für den Tag gesetzten Wert

Syntaxbeispiel für Preis-Tags

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

Versions-Tag-Operatoren

• eq - gleich einem angegebenen Wert
• noteq - ungleich einem angegebenen Wert
• lte - kleiner oder gleich einem angegebenen Wert
• gte - größer oder gleich einem angegebenen Wert
• in - gleich einem der angegebenen Werte
• notin - ungleich einem der angegebenen Werte
• between - in einem angegebenen Bereich
• any - Geräte mit beliebigen für den Tag gesetzten Werten
• notset - Geräte ohne für den Tag gesetzten Wert

Syntaxbeispiel für Versions-Tags

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

Operatoren für Event-Bedingungen

Hinweis

Bitte beachten Sie, dass die Event-Bedingungen App-spezifisch sind, daher sollte der App-Code zusammen mit dem Event-Namen in Ihren Filterausdrücken angegeben werden.

Event-Anzahl

• count gte - Geräte, die das Event mehr als oder genau n-mal ausgelöst haben
• count lte - Geräte, die das Event weniger als oder genau n-mal ausgelöst haben
• count eq - Geräte, die das Event genau n-mal ausgelöst haben
• count noteq - Geräte, die das Event beliebig oft, aber nicht genau n-mal ausgelöst haben

Syntaxbeispiel für Event-Anzahl

Event("11111-11111", "Level reached", count gte 10) // 11111-11111 ist ein App-Code

Event-Datum

• date gte - Geräte, die das Event später als oder genau am angegebenen Datum ausgelöst haben
• date lte - Geräte, die das Event früher als oder genau am angegebenen Datum ausgelöst haben
• date eq - Geräte, die das Event genau am angegebenen Datum ausgelöst haben
• date noteq - Geräte, die das Event jederzeit, aber nicht am angegebenen Datum ausgelöst haben
• date in - Geräte, die das Event an einem der angegebenen Daten ausgelöst haben
• date notin - Geräte, die das Event jederzeit, aber nicht an einem der angegebenen Daten ausgelöst haben
• date between - Geräte, die das Event innerhalb eines angegebenen Zeitraums ausgelöst haben
• date daysago eq - Auslösedatum des Events ist gleich einer angegebenen Anzahl von Tagen vor dem heutigen Tag
• date daysago noteq - Auslösedatum des Events ist ungleich einer angegebenen Anzahl von Tagen vor dem heutigen Tag
• date daysago lte - Auslösedatum des Events ist kleiner oder gleich einer angegebenen Anzahl von Tagen vor dem heutigen Tag
• date daysago gte - Auslösedatum des Events ist größer oder gleich einer angegebenen Anzahl von Tagen vor dem heutigen Tag
• date daysago between - Auslösedatum des Events liegt zwischen der angegebenen Anzahl von Tagen
• date daysahead - Auslösedatum des Events liegt in einer angegebenen Anzahl von Tagen ab dem heutigen Tag (Intervall ist beidseitig einschließlich, siehe Datums-Tag-Operatoren oben für die vollständige Semantik)
• date minutesago lte - Auslösedatum des Events ist kleiner oder gleich einer angegebenen Anzahl von Minuten vor dem jetzigen Zeitpunkt
• date minutesago gte - Auslösedatum des Events ist größer oder gleich einer angegebenen Anzahl von Minuten vor dem jetzigen Zeitpunkt

Syntaxbeispiele für Event-Datum

• 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 daysahead 0 7) - Events mit einem Auslösedatum innerhalb der nächsten 7 Tage
• Event("11111-11111", "Level reached", date minutesago lte 30) - Events innerhalb der letzten 30 Minuten
• Event("11111-11111", "Level reached", date minutesago gte 60) - Events vor 60+ Minuten

Event-Plattformen

Filtern Sie Events nach der Plattform, auf der sie ausgelöst wurden.

• platforms - Liste der Plattformen (z. B. [“ios”, “android”])

Syntaxbeispiel für Event-Plattformen

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

Event-Attribute

Event-Bedingungen können basierend auf den Werten von Event-Attributen filtern. Attribute unterstützen verschiedene Datentypen mit den entsprechenden Operatoren.

Integer-Event-Attribute

• attribute “name” eq - Attribut ist gleich einem angegebenen Wert
• attribute “name” noteq - Attribut ist ungleich einem angegebenen Wert
• attribute “name” gte - Attribut ist größer oder gleich einem angegebenen Wert
• attribute “name” lte - Attribut ist kleiner oder gleich einem angegebenen Wert
• attribute “name” between - Attribut liegt in einem angegebenen Bereich
• attribute “name” in - Attribut ist gleich einem der angegebenen Werte
• attribute “name” notin - Attribut ist ungleich einem der angegebenen Werte
• attribute “name” any - beliebiger Wert für das Attribut gesetzt
• attribute “name” notset - kein Wert für das Attribut gesetzt

Syntaxbeispiele für Integer-Attribute

• 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-Event-Attribute

• attribute “name” eq - Attribut ist gleich einem angegebenen Wert
• attribute “name” noteq - Attribut ist ungleich einem angegebenen Wert
• attribute “name” startswith - Attribut beginnt mit einem angegebenen Präfix
• attribute “name” endswith - Attribut endet mit einem angegebenen Suffix
• attribute “name” contains - Attribut enthält eine angegebene Teilzeichenfolge
• attribute “name” in - Attribut ist gleich einem der angegebenen Werte
• attribute “name” notin - Attribut ist ungleich einem der angegebenen Werte
• attribute “name” any - beliebiger Wert für das Attribut gesetzt
• attribute “name” notset - kein Wert für das Attribut gesetzt

Syntaxbeispiele für String-Attribute

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

Boolesche Event-Attribute

• attribute “name” eq - Attribut ist gleich true oder false
• attribute “name” noteq - Attribut ist ungleich true oder false

Syntaxbeispiel für boolesche Attribute

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

Datums-Event-Attribute

• attribute “name” eq - Attribut ist gleich einem angegebenen Datum
• attribute “name” noteq - Attribut ist ungleich einem angegebenen Datum
• attribute “name” gte - Attribut ist nach oder an einem angegebenen Datum
• attribute “name” lte - Attribut ist vor oder an einem angegebenen Datum
• attribute “name” between - Attribut liegt innerhalb eines angegebenen Datumsbereichs
• attribute “name” in - Attribut ist gleich einem der angegebenen Daten
• attribute “name” notin - Attribut ist ungleich einem der angegebenen Daten
• attribute “name” daysago eq/noteq/gte/lte/between - Attribut relativ zu Tagen zuvor
• attribute “name” daysahead from to - Attribut in einem angegebenen Intervall von Tagen ab dem heutigen Tag (Intervall ist beidseitig einschließlich, siehe Datums-Tag-Operatoren oben für die vollständige Semantik)
• attribute “name” minutesago gte/lte - Attribut relativ zu Minuten zuvor
• attribute “name” any - beliebiger Wert für das Attribut gesetzt
• attribute “name” notset - kein Wert für das Attribut gesetzt

Syntaxbeispiele für Datums-Attribute

• 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) - innerhalb der letzten 30 Tage
• Event("11111-11111", "Subscription", attribute "renewal_at" daysahead 0 30) - Verlängerungen in den nächsten 30 Tagen
• Event("11111-11111", "Subscription", attribute "start_date" minutesago gte 60) - vor 60+ Minuten

Preis-Event-Attribute

• attribute “name” eq - Attribut ist gleich einem angegebenen Preiswert
• attribute “name” noteq - Attribut ist ungleich einem angegebenen Preiswert
• attribute “name” gte - Attribut ist größer oder gleich einem angegebenen Preis
• attribute “name” lte - Attribut ist kleiner oder gleich einem angegebenen Preis
• attribute “name” between - Attribut liegt in einem angegebenen Preisbereich
• attribute “name” in - Attribut ist gleich einem der angegebenen Preise
• attribute “name” notin - Attribut ist ungleich einem der angegebenen Preise
• attribute “name” any - beliebiger Wert für das Attribut gesetzt
• attribute “name” notset - kein Wert für das Attribut gesetzt

Syntaxbeispiel für Preis-Attribute

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

Listen-Event-Attribute

• attribute “name” in - Attribut enthält einen der angegebenen Werte
• attribute “name” notin - Attribut enthält keinen der angegebenen Werte
• attribute “name” any - beliebiger Wert für das Attribut gesetzt
• attribute “name” notset - kein Wert für das Attribut gesetzt

Syntaxbeispiel für Listen-Attribute

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

Zusätzliche Bedingungstypen

Geo-Bedingung

Geräte basierend auf dem geografischen Standort innerhalb eines bestimmten Radius ansprechen.

Syntax: Geo("<App-Code>", <Breitengrad>, <Längengrad>, <Reichweite-in-km>)

Geo-Syntaxbeispiel

Geo("11111-11111", 53.2734, -7.77832031, 100.05) - Geräte innerhalb von 100,05 km von den Koordinaten

BTTS-Bedingung

Geräte nach ihrer besten Sendezeit für Benachrichtigungen ansprechen (Stunde des Tages, 0-23).

Operatoren:

• any - beliebiger Wert für die beste Sendezeit gesetzt
• eq - exakte Stundenübereinstimmung
• noteq - ungleich der Stunde
• gte - Stunde größer oder gleich
• lte - Stunde kleiner oder gleich

BTTS-Syntaxbeispiele

• BTTS("11111-11111", eq 10) - Geräte mit bester Sendezeit um 10:00 Uhr
• BTTS("11111-11111", gte 18) - Geräte mit bester Sendezeit ab 18:00 Uhr
• BTTS("11111-11111", any) - Geräte mit beliebigem Wert für die beste Sendezeit

Updated-Bedingung

Geräte nach ihrem letzten Aktualisierungszeitstempel filtern.

Operatoren:

• gte - aktualisiert nach oder am angegebenen Datum
• lte - aktualisiert vor oder am angegebenen Datum
• between - aktualisiert innerhalb des Datumsbereichs

Updated-Syntaxbeispiele

• Updated("11111-11111", gte "2022-01-01 00:00:00") - Geräte, die nach dem 1. Januar 2022 aktualisiert wurden
• Updated("11111-11111", lte "2022-12-31 23:59:59") - Geräte, die vor dem 31. Dezember 2022 aktualisiert wurden
• Updated("11111-11111", between "2022-01-01 00:00:00" "2022-12-31 23:59:59") - Geräte, die 2022 aktualisiert wurden

Segment-Bedingung

Auf einen anderen Filter/ein anderes Segment über dessen Code verweisen.

Segment-Syntaxbeispiel

Segment("11111-11111", "22222-22222") - verweist auf Filter mit dem Code „22222-22222“

Flags für die Gerätepräsenz in Anwendungsbedingungen

Anwendungsbedingungen unterstützen zusätzliche Flags zur Steuerung der Geräte- und Token-Filterung:

• with_tokens - Geräte mit Push-Benachrichtigungs-Tokens
• without_tokens - Geräte ohne Push-Benachrichtigungs-Tokens
• with_devices - Benutzer mit registrierten Geräten
• without_devices - Benutzer/Profile ohne registrierte Geräte

Syntaxbeispiele für Anwendungs-Flags

• A("11111-11111", ["ios", "android"], [with_tokens]) - Geräte mit Push-Tokens
• A("11111-11111", ["ios", "android"], [without_tokens]) - Geräte ohne Push-Tokens
• A("11111-11111", [], [with_devices]) - alle Geräte mit Gerätedatensätzen
• A("11111-11111", ["ios", "android"], [without_tokens, with_devices]) - Geräte ohne Tokens, aber mit Gerätedatensätzen

Beispiele für Filterausdrücke

Hinweis

Achten Sie beim Schreiben von JSON-Abfragen darauf, Anführungszeichen (") und Backslashes (\) mit einem Backslash (\) zu escapen. Ein Beispiel für eine Anfrage finden Sie unter /exportSegment.

Grundlegende Beispiele

1. iOS- und Android-Geräte, auf denen die App installiert ist und die Push-Tokens haben:

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

2. iOS- und Android-Geräte, auf denen die App installiert ist, aber ohne Push-Tokens:

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

3. iOS- und Android-Geräte, auf denen die App installiert ist, unabhängig davon, ob sie Push-Tokens haben oder nicht:

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

4. Alle App-Abonnenten, die etwas in der App gekauft haben:

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

Fortgeschrittene Beispiele

5. Benutzer in Tokio, die die App in den letzten 7 Tagen geöffnet haben:

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

6. Benutzer, die in den letzten 30 Tagen einen Kauf über 50 $ getätigt haben:

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

7. Benutzer, deren Namen mit „J“ beginnen oder mit „e“ enden:

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

8. Aktive iOS-Benutzer innerhalb von 100 km von New York, die in letzter Zeit nichts gekauft haben:

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

9. Benutzer mit der besten Sendezeit zwischen 9 und 17 Uhr:

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

10. Benutzer, die in der letzten Stunde ein bestimmtes Event auf Android oder iOS ausgelöst haben:

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

11. Geräte, die in den letzten 3 Monaten aktualisiert wurden und die App-Version 4.2 oder höher haben:

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