Verbundenes Zielgruppen-Objekt

Ein verbundener Zielgruppen-Filter ist ein dynamischer Zielgruppenfilter, den Sie direkt in Ihrer API-Anfrage definieren. So können Sie zum Sendezeitpunkt die richtigen Nutzer:innen ansprechen, ohne Segmente im Braze-Dashboard erstellen oder verwalten zu müssen.

Anstatt für jede mögliche Zielgruppenkombination vorab ein Segment zu erstellen, übergeben Sie die Filterkriterien direkt in Ihrem API-Aufruf. Je nach Endpunkt wird dieses Objekt als audience oder custom_audience übergeben. Braze wertet jede:n Nutzer:in in Realtime anhand dieser Kriterien aus und stellt die Nachricht nur an Nutzer:innen zu, die den Kriterien entsprechen. Das bedeutet, dass eine einzelne Campaign, ein Canvas oder eine reine API-Nachrichtendefinition eine unbegrenzte Anzahl von Zielgruppenvarianten bedienen kann – vollständig gesteuert durch Ihre Geschäftslogik.

So funktioniert es

1. Definieren Sie Ihre Nachricht, indem Sie entweder eine API-getriggerte Campaign oder ein Canvas im Braze-Dashboard erstellen, oder definieren Sie den Nachrichteninhalt vollständig inline mithilfe der Messaging-Objekte in Ihrer API-Anfrage. Verwenden Sie Trigger-Eigenschaften oder Canvas-Kontext für dynamische Personalisierung.
2. Rufen Sie einen unterstützten Endpunkt auf und fügen Sie Ihre Connected-Audience-Filter im Parameter audience ein, oder in custom_audience für /messages/live_activity/start. Sie können nach angepassten Attributen, Push-Abo-Status, E-Mail-Abo-Status und dem Zeitpunkt der letzten App-Nutzung filtern.
3. Braze wertet die Filter zum Sendezeitpunkt aus und stellt die Nachricht nur an Nutzer:innen zu, die Ihren Kriterien entsprechen.

Tipp

Eine campaign_id ist nicht erforderlich, wenn Sie den Parameter audience verwenden. Die Endpunkte /messages/send und /messages/schedule/create ermöglichen es Ihnen, Nachrichteninhalte inline zu definieren, ohne eine vorab erstellte Campaign. Wenn Sie jedoch Campaign-Metriken (wie Sends, Klicks oder Bounces) im Dashboard verfolgen möchten, fügen Sie eine campaign_id hinzu.

Da die Zielgruppe pro Anfrage definiert wird, können Ihre Backend-Systeme kontextuell relevante Nachrichten als Reaktion auf jedes Geschäftsereignis (eine Preisänderung, eine Wetterwarnung, ein Live-Spielstand-Update) auslösen – ohne Eingriff über das Dashboard.

Kompatible Endpunkte

Sie können das Connected-Audience-Objekt mit diesen Endpunkten verwenden:

• /messages/send
• /campaigns/trigger/send
• /canvas/trigger/send
• /messages/schedule/create
• /campaigns/trigger/schedule/create
• /canvas/trigger/schedule/create
• /messages/live_activity/start (verwendet custom_audience)

Beachten Sie, dass der Parameter audience kein Array von Objekten unterstützt.

Anwendungsfälle

Verwenden Sie Connected Audiences für Szenarien, in denen Ihre Backend-Systeme ein Ereignis erkennen und eine dynamisch bestimmte Gruppe von Nutzer:innen benachrichtigen müssen:

In jedem Fall wird eine einzelne Campaign oder eine reine API-Nachrichtendefinition für alle Variationen verwendet. Ihr Backend bestimmt die Filterwerte und übergibt sie in der API-Anfrage, sodass Sie kein separates Segment oder keine separate Campaign für jedes Produkt, jede Serie, jedes Team oder jeden Standort erstellen müssen.

Beispielanfrage

Das folgende Beispiel verwendet den Endpunkt /campaigns/trigger/send, um Nutzer:innen anzusprechen, die eine bestimmte Show als Favorit markiert haben und für Push-Benachrichtigungen angemeldet sind:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

{
  "campaign_id": "YOUR_CAMPAIGN_ID",
  "audience": {
    "AND": [
      {
        "custom_attribute": {
          "custom_attribute_name": "favorite_shows",
          "comparison": "includes_value",
          "value": "Example Show"
        }
      },
      {
        "push_subscription_status": {
          "comparison": "is",
          "value": "opted_in"
        }
      }
    ]
  },
  "trigger_properties": {
    "show_title": "Example Show",
    "episode_title": "Season 3, Episode 1",
    "deep_link": "https://example.com/shows/example-show/s3e1"
  },
  "broadcast": true
}

Setzen Sie broadcast auf true, wenn Sie recipients weglassen und die Zielgruppe mit audience definieren. Für /campaigns/trigger/send ist broadcast erforderlich, um an eine verbundene Zielgruppe ohne Empfänger:innenliste zu senden. Wenn broadcast auf true gesetzt ist, fügen Sie keine recipients-Liste hinzu.

Objektkörper

Das Connected-Audience-Objekt besteht entweder aus einem einzelnen Connected-Audience-Filter oder aus mehreren Connected-Audience-Filtern, die mit den Operatoren AND und OR kombiniert werden.

Beispiel mit mehreren Filtern:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
  "AND":
    [
      Connected Audience Filter,
      {
        "OR" :
          [
            Connected Audience Filter,
            Connected Audience Filter
          ]
      },
      Connected Audience Filter
    ]
}

Verbundene Zielgruppenfilter

Kombinieren Sie mehrere Filter mit AND- und OR-Operatoren, um einen verbundenen Zielgruppenfilter zu erstellen.

Hinweise

Verbundene Zielgruppen können Nutzer:innen nicht nach folgenden Kriterien filtern:

• Standardattribute
• Angepasste Events
• Segments
• Engagement-Events für Nachrichten
• Verschachtelte angepasste Attribute

Um diese Filter zu verwenden, empfehlen wir, sie in ein Zielgruppen-Segment einzubinden und dieses Segment dann im Parameter segment_id für den /messages/send-Endpunkt anzugeben. Wenn Sie andere Endpunkte verwenden, müssen Sie das Segment zuerst im Braze-Dashboard zur API-getriggerten Campaign oder zum Canvas hinzufügen. Wenn Sie nach verschachtelten Attributen filtern müssen, verwenden Sie stattdessen ein Standard-Segment.

Filter für angepasste Attribute

Dieser Filter ermöglicht es Ihnen, Nutzer:innen basierend auf einem angepassten Attribut zu segmentieren. Diese Filter enthalten bis zu drei Felder:

1
2
3
4
5
6
7
8

{
  "custom_attribute":
    {
      "custom_attribute_name": (String) the name of the custom attribute to filter on,
      "comparison": (String) one of the allowed comparisons to make against the provided value,
      "value": (String, Numeric, Boolean) the value to be compared using the provided comparison
    }
}

Zulässige Vergleiche nach Datentyp

Der Datentyp des angepassten Attributs bestimmt, welche Vergleiche für einen bestimmten Filter gültig sind.

Hinweise zu Attributvergleichen

Mehrfachwert-Vergleiche

Sowohl is_any_of als auch is_none_of unterstützen den Abgleich mit mehreren Werten in einem einzelnen Vergleich. Diese Vergleiche funktionieren sowohl mit String- als auch mit Array-basierten angepassten Attributen.

• is_any_of: Trifft auf Nutzer:innen zu, deren Attributwert einem der angegebenen Werte entspricht. Der value kann ein einzelner String oder ein String-Array sein.
• is_none_of: Trifft auf Nutzer:innen zu, deren Attributwert keinem der angegebenen Werte entspricht. Der value kann ein einzelner String oder ein String-Array sein. Beachten Sie, dass Nutzer:innen ohne dieses Attribut in ihrem Profil immer für diesen Vergleich qualifiziert sind.

Für Array-Attribute:

• includes_value kann ebenfalls ein Array von Werten akzeptieren, um zu prüfen, ob das Array der Nutzer:innen einen der angegebenen Werte enthält.
• Bei Verwendung von is_any_of oder is_none_of mit Array-Attributen funktionieren diese genauso wie includes_value bzw. does_not_include_value.

Tipp

Verwenden Sie für den Mehrfachwert-Abgleich is_any_of anstelle von includes_value.

Beispiele für angepasste Attribute

1
2
3
4
5
6
7
8

{
  "custom_attribute":
    {
      "custom_attribute_name": "eye_color",
      "comparison": "equals",
      "value": "blue"
    }
}

1
2
3
4
5
6
7
8

{
  "custom_attribute":
  {
    "custom_attribute_name": "favorite_foods",
    "comparison": "includes_value",
    "value": "pizza"
  }
}

1
2
3
4
5
6
7
8

{
  "custom_attribute":
  {
    "custom_attribute_name": "last_purchase_time",
    "comparison": "less_than_x_days_ago",
    "value": 2
  }
}

Beispiele für Mehrfachwert-Vergleiche

is_any_of mit einem String-Array

1
2
3
4
5
6
7
8

{
  "custom_attribute":
  {
    "custom_attribute_name": "favorite_color",
    "comparison": "is_any_of",
    "value": ["red", "blue", "green"]
  }
}

is_none_of mit einem String-Array

1
2
3
4
5
6
7
8

{
  "custom_attribute":
  {
    "custom_attribute_name": "subscription_tier",
    "comparison": "is_none_of",
    "value": ["bronze", "silver"]
  }
}

includes_value mit einem Array (Array-Attribut)

1
2
3
4
5
6
7
8

{
  "custom_attribute":
  {
    "custom_attribute_name": "subscribed_products",
    "comparison": "includes_value",
    "value": ["1001", "1002", "1003"]
  }
}

Dies trifft auf Nutzer:innen zu, deren Array subscribed_products einen der Werte "1001", "1002" oder "1003" enthält.

Push-Abo-Filter

Dieser Filter ermöglicht es Ihnen, Nutzer:innen basierend auf ihrem Push-Abo-Status zu segmentieren.

Filterkörper

1
2
3
4
5
6
7

{
  "push_subscription_status":
  {
    "comparison": (String) one of the following allowed comparisons,
    "value": (String) one of the following allowed values
  }
}

• Zulässige Vergleiche: is, is_not
• Zulässige Werte: opted_in, subscribed, unsubscribed

E-Mail-Abo-Filter

Dieser Filter ermöglicht es Ihnen, Nutzer:innen basierend auf ihrem E-Mail-Abo-Status zu segmentieren.

Filterkörper

1
2
3
4
5
6
7

{
  "email_subscription_status":
  {
    "comparison": (String) one of the following allowed comparisons,
    "value": (String) one of the following allowed values
  }
}

• Zulässige Vergleiche: is, is_not
• Zulässige Werte: opted_in, subscribed, unsubscribed

Filter für zuletzt verwendete App

Dieser Filter ermöglicht es Ihnen, Nutzer:innen basierend darauf zu segmentieren, wann sie die App zuletzt verwendet haben. Diese Filter enthalten zwei Felder:

Filterkörper

1
2
3
4
5
6
7

{
  "last_used_app":
  {
    "comparison": (String) one of the allowed comparisons listed,
    "value": (String) the value to be compared using the provided comparison
  }
}

• Zulässige Vergleiche: after, before
• Zulässige Werte: Datum/Uhrzeit (ISO-8601-String)