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 bei Verwendung des Parameters audience nicht erforderlich. 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-Ergebnis-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 Event erkennen und eine dynamisch bestimmte Gruppe von Nutzer:innen benachrichtigen müssen:

In jedem Fall verarbeitet eine einzelne Campaign oder eine reine API-Nachrichtendefinition alle Variationen. 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": false
}

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
    ]
}

Verknüpfte Zielgruppenfilter

Kombinieren Sie mehrere Filter mit den Operatoren AND und OR, um einen verknüpften Zielgruppenfilter zu erstellen.

Hinweise

Verknüpfte Zielgruppen können Nutzer:innen nicht nach folgenden Kriterien filtern:

• Standardattribute
• Angepasste Events
• Segments
• Nachrichten-Engagement-Events
• 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. Bei der Verwendung anderer Endpunkte müssen Sie das Segment zunächst 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, basierend auf einem angepassten Attribut einer Nutzerin oder eines Nutzers 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

Mehrwert-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-Attributen.

• is_any_of: Stimmt mit Nutzer:innen überein, deren Attributwert einem der angegebenen Werte entspricht. Der value kann ein einzelner String oder ein String-Array sein.
• is_none_of: Stimmt mit Nutzer:innen überein, 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 Nutzerin oder des Nutzers 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 Mehrwert-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 Mehrwert-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 stimmt mit Nutzer:innen überein, deren subscribed_products-Array einen der Werte "1001", "1002" oder "1003" enthält.

Push-Abo-Filter

Dieser Filter ermöglicht es Ihnen, basierend auf dem Push-Abo-Status einer Nutzerin oder eines Nutzers zu segmentieren.

Filter-Body

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, basierend auf dem E-Mail-Abo-Status einer Nutzerin oder eines Nutzers zu segmentieren.

Filter-Body

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, basierend darauf zu segmentieren, wann die Nutzerin oder der Nutzer die App zuletzt verwendet hat. Diese Filter enthalten zwei Felder:

Filter-Body

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: Datetime (ISO-8601-String)