Skip to content

Nutzer:in-Attribute festlegen

Lernen Sie, wie Sie Nutzer:innen-Attribute mit dem Braze SDK festlegen können.

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Internet Braze SDK integrieren.

Standard-Nutzerattribute

Vordefinierte Methoden

Braze stellt vordefinierte Methoden zum Festlegen der folgenden Nutzerattribute in der Klasse User bereit:

  • Vorname
  • Nachname
  • Sprache
  • Land
  • Geburtsdatum
  • E-Mail
  • Geschlecht
  • Heimatstadt
  • Telefonnummer

Standardattribute festlegen

Um ein Standardattribut für eine:n Nutzer:in festzulegen, rufen Sie die Methode getUser() auf Ihrer Braze-Instanz auf, um eine Referenz auf die aktuelle Nutzer:in Ihrer App zu erhalten. Anschließend können Sie Methoden aufrufen, um ein Nutzerattribut zu setzen.

1

braze.getUser().setFirstName("SomeFirstName");

1

braze.getUser().setGender(braze.User.Genders.FEMALE);

1

braze.getUser().setDateOfBirth(2000, 12, 25);

Mit Google Tag Manager sollten Standard-Nutzerattribute (wie z. B. der Vorname) auf dieselbe Weise wie angepasste Nutzerattribute protokolliert werden. Stellen Sie sicher, dass die Werte, die Sie für Standardattribute übergeben, dem erwarteten Format entsprechen, das in der Dokumentation der Klasse User angegeben ist.

Das Attribut „Geschlecht“ kann zum Beispiel folgende Werte annehmen: "m" | "f" | "o" | "u" | "n" | "p". Um also das Geschlecht als weiblich festzulegen, erstellen Sie ein angepasstes HTML-Tag mit folgendem Inhalt:

1
2
3

<script>
window.braze.getUser().setGender("f")
</script>

Standardattribute zurücksetzen

Sie können ein Nutzerattribut über Ihren App-Code, eine REST-API-Anfrage oder einen Nutzeraktualisierung-Canvas-Schritt entfernen oder zurücksetzen. Für Array- und boolesche Attribute verwenden Sie null. Für andere Datentypen verwenden Sie einen leeren String ("").

Um ein Standardattribut mit dem Web SDK zurückzusetzen, übergeben Sie null an die entsprechende Methode. Zum Beispiel:

1

braze.getUser().setFirstName(null);

1

braze.getUser().setGender(null);

1

braze.getUser().setDateOfBirth(null, null, null);

Angepasste Nutzerattribute

Angepasste Attribute festlegen

Zusätzlich zu den Standardmethoden für Nutzerattribute können Sie auch angepasste Attribute für Ihre Nutzer:innen festlegen. Die vollständigen Methodenspezifikationen finden Sie in unseren JSDocs.

So legen Sie ein angepasstes Attribut mit einem string-Wert fest:

1
2
3
4

braze.getUser().setCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  YOUR_STRING_VALUE
);

So legen Sie ein angepasstes Attribut mit einem integer-Wert fest:

1
2
3
4
5
6
7
8
9
10

braze.getUser().setCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  YOUR_INT_VALUE
);

// Integer attributes may also be incremented using code like the following
braze.getUser().incrementCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  THE_INTEGER_VALUE_BY_WHICH_YOU_WANT_TO_INCREMENT_THE_ATTRIBUTE
);

So legen Sie ein angepasstes Attribut mit einem date-Wert fest:

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

braze.getUser().setCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  YOUR_DATE_VALUE
);

// This method will assign the current time to a custom attribute at the time the method is called
braze.getUser().setCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  new Date()
);

// This method will assign the date specified by secondsFromEpoch to a custom attribute
braze.getUser().setCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  new Date(secondsFromEpoch * 1000)
);

Die Standard- und Höchstzahl an Elementen in einem Array beträgt 500. Sie können die Höchstzahl an Elementen im Braze-Dashboard unter Dateneinstellungen > Angepasste Attribute aktualisieren. Arrays, die die Höchstzahl an Elementen überschreiten, werden auf die Höchstzahl an Elementen gekürzt.

So legen Sie ein angepasstes Attribut mit einem array-Wert fest:

1
2
3
4
5
6
7

braze.getUser().setCustomUserAttribute(YOUR_ATTRIBUTE_KEY_STRING, YOUR_ARRAY_OF_STRINGS);

// Adding a new element to a custom attribute with an array value
braze.getUser().addToCustomAttributeArray(YOUR_ATTRIBUTE_KEY_STRING, "new string");

// Removing an element from a custom attribute with an array value
braze.getUser().removeFromCustomAttributeArray(YOUR_ATTRIBUTE_KEY_STRING, "value to be removed");

Angepasste Nutzerattribute sind aufgrund einer Einschränkung in der Skriptsprache von Google Tag Manager nicht verfügbar. Um angepasste Attribute zu protokollieren, erstellen Sie ein angepasstes HTML-Tag mit folgendem Inhalt:

1
2
3
4
5

<script>
  // Note: If using SDK version 3.x or below, use `window.appboy` instead of `window.braze`
  // Version 4 or greater should use `window.braze`
window.braze.getUser().setCustomUserAttribute("attribute name", "attribute value");
</script>

Angepasste Attribute zurücksetzen

Um ein angepasstes Attribut zurückzusetzen, übergeben Sie null an die entsprechende Methode.

1

braze.getUser().setCustomUserAttribute(YOUR_ATTRIBUTE_KEY_STRING, null);

Verschachtelte angepasste Attribute

Sie können Eigenschaften auch in angepassten Attributen verschachteln. Im folgenden Beispiel wird ein favorite_book-Objekt mit verschachtelten Eigenschaften als angepasstes Attribut im Nutzerprofil festgelegt. Weitere Informationen finden Sie unter Verschachtelte angepasste Attribute.

1
2
3
4
5
6
7
8
9

import * as braze from "@braze/web-sdk";

const favoriteBook = {
  title: "The Hobbit",
  author: "J.R.R. Tolkien",
  publishing_date: "1937"
};

braze.getUser().setCustomUserAttribute("favorite_book", favoriteBook);

Verwendung der REST API

Sie können auch unsere REST API verwenden, um Nutzerattribute zu setzen oder zurückzusetzen. Weitere Informationen finden Sie unter Endpunkte für Nutzerdaten.

Nutzer-Abos einrichten

Um ein Abo für Ihre Nutzer:innen einzurichten (entweder per E-Mail oder per Push), rufen Sie die Funktionen setEmailNotificationSubscriptionType() bzw. setPushNotificationSubscriptionType() auf. Beide Funktionen verwenden den enum-Typ braze.User.NotificationSubscriptionTypes als Argumente. Dieser Typ hat drei verschiedene Zustände:

Abostatus Definition
braze.User.NotificationSubscriptionTypes.OPTED_IN Abonniert und ausdrücklich angemeldet
braze.User.NotificationSubscriptionTypes.SUBSCRIBED Abonniert, aber nicht ausdrücklich angemeldet
braze.User.NotificationSubscriptionTypes.UNSUBSCRIBED Abbestellt und/oder ausdrücklich abgemeldet

Wenn sich Nutzer:innen für Push registrieren, fordert der Browser sie auf, Benachrichtigungen zuzulassen oder zu blockieren. Wenn sie Push zulassen, wird standardmäßig OPTED_IN gesetzt.

Weitere Informationen zur Implementierung von Abos und expliziten Opt-ins finden Sie unter Verwaltung von Nutzer-Abos.

Nutzer:in von E-Mails abmelden

1

braze.getUser().setEmailNotificationSubscriptionType(braze.User.NotificationSubscriptionTypes.UNSUBSCRIBED);

Nutzer:in von Push-Benachrichtigungen abmelden

1

braze.getUser().setPushNotificationSubscriptionType(braze.User.NotificationSubscriptionTypes.UNSUBSCRIBED);

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Android Braze SDK integrieren.

Standard-Nutzerattribute

Vordefinierte Methoden

Braze stellt vordefinierte Methoden zur Verfügung, um die folgenden Nutzerattribute innerhalb der Klasse BrazeUser festzulegen. Für Methodenspezifikationen lesen Sie bitte unser KDoc.

  • Vorname
  • Nachname
  • Land
  • Sprache
  • Geburtsdatum
  • E-Mail
  • Geschlecht
  • Wohnort
  • Telefonnummer

Standardattribute festlegen

Um ein Standardattribut für eine Nutzer:in festzulegen, rufen Sie die Methode getCurrentUser() auf Ihrer Braze-Instanz auf, um eine Referenz auf die aktuelle Nutzer:in Ihrer App zu erhalten. Anschließend können Sie Methoden aufrufen, um ein Nutzerattribut zu setzen.

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setFirstName("first_name");
  }
}

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setFirstName("first_name")
}

Standardattribute zurücksetzen

Um ein Nutzerattribut zurückzusetzen, übergeben Sie null an die entsprechende Methode.

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setFirstName(null);
  }
}

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setFirstName(null)
}

Angepasste Nutzerattribute

Zusätzlich zu den Standard-Nutzerattributen ermöglicht Braze Ihnen auch, angepasste Attribute mit verschiedenen Datentypen zu definieren. Weitere Informationen zu den Segmentierungsoptionen der einzelnen Attribute finden Sie unter Datenerfassung.

Angepasste Attribute festlegen

So legen Sie ein angepasstes Attribut mit einem string-Wert fest:

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", "your_attribute_value");
  }
}

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", "your_attribute_value")
}

So legen Sie ein angepasstes Attribut mit einem int-Wert fest:

1
2
3
4
5
6
7
8
9

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_INT_VALUE);

    // Integer attributes may also be incremented using code like the following:
    brazeUser.incrementCustomUserAttribute("your_attribute_key", YOUR_INCREMENT_VALUE);
  }
}

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_INT_VALUE)

  // Integer attributes may also be incremented using code like the following:
  brazeUser.incrementCustomUserAttribute("your_attribute_key", YOUR_INCREMENT_VALUE)
}

So legen Sie ein angepasstes Attribut mit einem long-Ganzzahlwert fest:

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_LONG_VALUE);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_LONG_VALUE)
}

So legen Sie ein angepasstes Attribut mit einem float-Wert fest:

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_FLOAT_VALUE);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_FLOAT_VALUE)
}

So legen Sie ein angepasstes Attribut mit einem double-Wert fest:

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_DOUBLE_VALUE);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_DOUBLE_VALUE)
}

So legen Sie ein angepasstes Attribut mit einem boolean-Wert fest:

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_BOOLEAN_VALUE);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_BOOLEAN_VALUE)
}

1
2
3
4
5
6
7
8
9
10

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_DATE_VALUE);
    // This method will assign the current time to a custom attribute at the time the method is called:
    brazeUser.setCustomUserAttributeToNow("your_attribute_key");
    // This method will assign the date specified by SECONDS_FROM_EPOCH to a custom attribute:
    brazeUser.setCustomUserAttributeToSecondsFromEpoch("your_attribute_key", SECONDS_FROM_EPOCH);
  }
});

1
2
3
4
5
6
7

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_DATE_VALUE)
  // This method will assign the current time to a custom attribute at the time the method is called:
  brazeUser.setCustomUserAttributeToNow("your_attribute_key")
  // This method will assign the date specified by SECONDS_FROM_EPOCH to a custom attribute:
  brazeUser.setCustomUserAttributeToSecondsFromEpoch("your_attribute_key", SECONDS_FROM_EPOCH)
}

Die Standard- und Höchstzahl an Elementen in einem Array beträgt 500. Sie können die Höchstzahl an Elementen im Braze-Dashboard unter Dateneinstellungen > Angepasste Attribute aktualisieren. Arrays, die die Höchstzahl an Elementen überschreiten, werden gekürzt, sodass nur die Höchstzahl an Elementen enthalten bleibt. Weitere Informationen zu angepassten Attribut-Arrays und deren Verhalten finden Sie unter Arrays.

1
2
3
4
5
6
7
8
9
10
11

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    // Setting a custom attribute with an array value
    brazeUser.setCustomAttributeArray("your_attribute_key", testSetArray);
    // Adding to a custom attribute with an array value
    brazeUser.addToCustomAttributeArray("your_attribute_key", "value_to_add");
    // Removing a value from an array type custom attribute
    brazeUser.removeFromCustomAttributeArray("your_attribute_key", "value_to_remove");
  }
});

1
2
3
4
5
6
7
8

Braze.getInstance(context).getCurrentUser { brazeUser ->
  // Setting a custom attribute with an array value
  brazeUser.setCustomAttributeArray("your_attribute_key", testSetArray)
  // Adding to a custom attribute with an array value
  brazeUser.addToCustomAttributeArray("your_attribute_key", "value_to_add")
  // Removing a value from an array type custom attribute
  brazeUser.removeFromCustomAttributeArray("your_attribute_key", "value_to_remove")
}

Angepasste Attribute zurücksetzen

Um ein angepasstes Attribut zurückzusetzen, übergeben Sie den entsprechenden Attributschlüssel an die Methode unsetCustomUserAttribute.

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.unsetCustomUserAttribute("your_attribute_key");
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.unsetCustomUserAttribute("your_attribute_key")
}

Verschachtelte angepasste Attribute

Sie können Eigenschaften auch innerhalb angepasster Attribute verschachteln. Im folgenden Beispiel wird ein favorite_book-Objekt mit verschachtelten Eigenschaften als angepasstes Attribut im Nutzerprofil festgelegt. Weitere Informationen finden Sie unter Verschachtelte angepasste Attribute.

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

JSONObject favoriteBook = new JSONObject();
try {
  favoriteBook.put("title", "The Hobbit");
  favoriteBook.put("author", "J.R.R. Tolkien");
  favoriteBook.put("publishing_date", "1937");
} catch (JSONException e) {
  e.printStackTrace();
}

braze.getCurrentUser(user -> {
  user.setCustomUserAttribute("favorite_book", favoriteBook);
  return null;
});

1
2
3
4
5
6
7
8

val favoriteBook = JSONObject()
  .put("title", "The Hobbit")
  .put("author", "J.R.R. Tolkien")
  .put("publishing_date", "1937")

braze.getCurrentUser { user ->
  user.setCustomUserAttribute("favorite_book", favoriteBook)
}

Verwendung der REST API

Sie können auch unsere REST API verwenden, um Nutzerattribute zu setzen oder zurückzusetzen. Weitere Informationen finden Sie unter Endpunkte für Nutzerdaten.

Nutzer-Abos einrichten

Um ein Abo für Ihre Nutzer:innen einzurichten (entweder per E-Mail oder per Push), rufen Sie die Funktionen setEmailNotificationSubscriptionType() bzw. setPushNotificationSubscriptionType() auf. Beide Funktionen nehmen den enum-Typ NotificationSubscriptionType als Argumente entgegen. Dieser Typ hat drei verschiedene Zustände:

E-Mail-Abos einrichten

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setEmailNotificationSubscriptionType(emailNotificationSubscriptionType);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setEmailNotificationSubscriptionType(emailNotificationSubscriptionType)
}

Push-Benachrichtigungs-Abo einrichten

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setPushNotificationSubscriptionType(pushNotificationSubscriptionType);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setPushNotificationSubscriptionType(pushNotificationSubscriptionType)
}

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Swift Braze SDK integrieren.

Standard-Nutzerattribute

Unterstützte Attribute

Die folgenden Attribute sollten für das Objekt Braze.User festgelegt werden:

  • firstName
  • lastName
  • email
  • dateOfBirth
  • country
  • language
  • homeCity
  • phone
  • gender

Standardattribute festlegen

Um ein Standardattribut festzulegen, konfigurieren Sie das entsprechende Feld im gemeinsam genutzten Braze.User-Objekt. Im Folgenden sehen Sie ein Beispiel für das Festlegen des Vorname-Attributs:

1

AppDelegate.braze?.user.set(firstName: "Alex")

1

[AppDelegate.braze.user setFirstName:@"Alex"];

Standardattribute aufheben

Um ein Standardattribut aufzuheben, übergeben Sie nil an die entsprechende Methode.

1

AppDelegate.braze?.user.set(firstName: nil)

1

[AppDelegate.braze.user setFirstName:nil];

Angepasste Nutzerattribute

Zusätzlich zu den Standardattributen können Sie in Braze auch angepasste Attribute mit verschiedenen Datentypen definieren. Weitere Informationen zu den Segmentierungsoptionen der einzelnen Attribute finden Sie unter Datenerfassung.

Angepasste Attribute festlegen

So legen Sie ein angepasstes Attribut mit einem string-Wert fest:

1

AppDelegate.braze?.user.setCustomAttribute(key: "your_attribute_key", value: "your_attribute_value")

1

[AppDelegate.braze.user setCustomAttributeWithKey:@"your_attribute_key" stringValue:"your_attribute_value"];

So legen Sie ein angepasstes Attribut mit einem integer-Wert fest:

1

AppDelegate.braze?.user.setCustomAttribute(key: "your_attribute_key", value: yourIntegerValue)

1

[AppDelegate.braze.user setCustomAttributeWithKey:@"your_attribute_key" andIntegerValue:yourIntegerValue];

Braze behandelt float- und double-Werte in der Datenbank gleich. So legen Sie ein angepasstes Attribut mit einem Double-Wert fest:

1

AppDelegate.braze?.user.setCustomAttribute(key: "your_attribute_key", value: yourDoubleValue)

1

[AppDelegate.braze.user setCustomAttributeWithKey:@"your_attribute_key" andDoubleValue:yourDoubleValue];

So legen Sie ein angepasstes Attribut mit einem boolean-Wert fest:

1

AppDelegate.braze?.user.setCustomAttribute("your_attribute_key", value: yourBoolValue)

1

[AppDelegate.braze.user setCustomAttributeWithKey:@"your_attribute_key" andBOOLValue:yourBOOLValue];

So legen Sie ein angepasstes Attribut mit einem date-Wert fest:

1

AppDelegate.braze?.user.setCustomAttribute("your_attribute_key", dateValue:yourDateValue)

1

[AppDelegate.braze.user setCustomAttributeWithKey:@"your_attribute_key" andDateValue:yourDateValue];

Die Standard- und Höchstzahl an Elementen in einem Array beträgt 500. Sie können die Höchstzahl an Elementen im Braze-Dashboard unter Dateneinstellungen > Angepasste Attribute aktualisieren. Arrays, die die Höchstzahl an Elementen überschreiten, werden auf die maximale Elementanzahl gekürzt.

So legen Sie ein angepasstes Attribut mit einem array-Wert fest:

1
2
3
4
5
6

// Setting a custom attribute with an array value
AppDelegate.braze?.user.setCustomAttributeArray(key: "array_name", array: ["value1",  "value2"])
// Adding to a custom attribute with an array value
AppDelegate.braze?.user.addToCustomAttributeArray(key: "array_name", value: "value3")
// Removing a value from an array type custom attribute
AppDelegate.braze?.user.removeFromCustomAttributeArray(key: "array_name", value: "value2")

1
2
3
4
5
6
7
8

// Setting a custom attribute with an array value
[AppDelegate.braze.user setCustomAttributeArrayWithKey:@"array_name" array:@[@"value1",  @"value2"]];
// Adding to a custom attribute with an array value
[AppDelegate.braze.user addToCustomAttributeArrayWithKey:@"array_name" value:@"value3"];
// Removing a value from an array type custom attribute
[AppDelegate.braze.user removeFromCustomAttributeArrayWithKey:@"array_name" value:@"value2"];
// Removing an entire array and key
[AppDelegate.braze.user setCustomAttributeArrayWithKey:@"array_name" array:nil];

Angepasste Attribute inkrementieren oder dekrementieren

Dieser Code ist ein Beispiel für ein inkrementierendes angepasstes Attribut. Sie können den Wert eines angepassten Attributs um einen beliebigen integer- oder long-Wert erhöhen:

1

AppDelegate.braze?.user.incrementCustomUserAttribute(key: "your_attribute_key", by: incrementIntegerValue)

1

[AppDelegate.braze.user incrementCustomUserAttribute:@"your_attribute_key" by:incrementIntegerValue];

Angepasste Attribute aufheben

Um ein angepasstes Attribut aufzuheben, übergeben Sie den entsprechenden Attributschlüssel an die unsetCustomAttribute-Methode.

1

AppDelegate.braze?.user.unsetCustomAttribute(key: "your_attribute_key")

Um ein angepasstes Attribut aufzuheben, übergeben Sie den entsprechenden Attributschlüssel an die unsetCustomAttributeWithKey-Methode.

1

[AppDelegate.braze.user unsetCustomAttributeWithKey:@"your_attribute_key"];

Verschachtelte angepasste Attribute

Sie können Eigenschaften auch in angepassten Attributen verschachteln. Im folgenden Beispiel wird ein favorite_book-Objekt mit verschachtelten Eigenschaften als angepasstes Attribut im Nutzerprofil festgelegt. Weitere Informationen finden Sie unter Verschachtelte angepasste Attribute.

1
2
3
4
5
6
7

let favoriteBook: [String: Any?] = [
  "title": "The Hobbit",
  "author": "J.R.R. Tolkien",
  "publishing_date": "1937"
]

braze.user.setCustomAttribute(key: "favorite_book", dictionary: favoriteBook)

1
2
3
4
5
6
7

NSDictionary *favoriteBook = @{
  @"title": @"The Hobbit",
  @"author": @"J.R.R. Tolkien",
  @"publishing_date": @"1937"
};

[AppDelegate.braze.user setCustomAttributeWithKey:@"favorite_book" dictionary:favoriteBook];

Verwendung der REST API

Sie können auch unsere REST API verwenden, um Nutzerattribute zu setzen oder aufzuheben. Weitere Informationen finden Sie unter Endpunkte für Nutzerdaten.

Nutzer-Abos einrichten

Um ein Abo für Ihre Nutzer:innen einzurichten (entweder E-Mail oder Push), rufen Sie die Funktion set(emailSubscriptionState:) bzw. set(pushNotificationSubscriptionState:) auf. Beide Funktionen nehmen den enum-Typ Braze.User.SubscriptionState als Argument an. Dieser Typ hat drei verschiedene Zustände:

Nutzer:innen, die einer App die Erlaubnis erteilen, ihnen Push-Benachrichtigungen zu senden, haben standardmäßig den Status optedIn, da iOS eine ausdrückliche Zustimmung erfordert.

Nutzer:innen werden bei Erhalt einer gültigen E-Mail-Adresse automatisch auf subscribed gesetzt. Wir empfehlen Ihnen jedoch, ein explizites Opt-in-Verfahren einzurichten und diesen Wert bei Erhalt einer ausdrücklichen Zustimmung auf optedIn zu setzen. Weitere Einzelheiten finden Sie unter Nutzer-Abos verwalten.

E-Mail-Abos einrichten

1

AppDelegate.braze?.user.set(emailSubscriptionState: Braze.User.SubscriptionState)

1

[AppDelegate.braze.user setEmailSubscriptionState: BRZUserSubscriptionState]

Abos für Push-Benachrichtigungen einrichten

1

AppDelegate.braze?.user.set(pushNotificationSubscriptionState: Braze.User.SubscriptionState)

1

[AppDelegate.braze.user setPushNotificationSubscriptionState: BRZUserSubscriptionState]

Weitere Einzelheiten finden Sie unter Nutzer-Abos verwalten.

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Flutter Braze SDK integrieren.

Standard-Nutzerattribute

Unterstützte Attribute

Die folgenden Attribute werden unterstützt:

  • Vorname
  • Nachname
  • Geschlecht
  • Geburtsdatum
  • Heimatstadt
  • Land
  • Telefonnummer
  • Sprache
  • E-Mail

Einstellung von Standardattributen

Um Nutzer:innen-Attribute zu setzen, die von Braze automatisch erfasst werden, können Sie die im SDK enthaltenen Setter-Methoden verwenden.

1

braze.setFirstName('Name');

Angepasste Nutzerattribute

Anpassen der Attribute

Zusätzlich zu den standardmäßigen Nutzer:innen-Attributen können Sie in Braze auch angepasste Attribute unter Verwendung einer Reihe verschiedener Datentypen definieren:

So legen Sie ein angepasstes Attribut mit einem string Wert fest:

1

braze.setStringCustomUserAttribute("custom string attribute", "string custom attribute");

So passen Sie ein angepasstes Attribut mit einem integer Wert an:

1
2
3
4

// Set Integer Attribute
braze.setIntCustomUserAttribute("custom int attribute key", integer);
// Increment Integer Attribute
braze.incrementCustomUserAttribute("key", integer);

So legen Sie ein angepasstes Attribut mit einem double Wert fest:

1

braze.setDoubleCustomUserAttribute("custom double attribute key", double);

So legen Sie ein angepasstes Attribut mit einem boolean Wert fest:

1

braze.setBoolCustomUserAttribute("custom boolean attribute key", boolean);

So legen Sie ein angepasstes Attribut mit einem date Wert fest:

1

braze.setDateCustomUserAttribute("custom date attribute key", date);

So passen Sie ein angepasstes Attribut mit einem array Wert an:

1
2
3
4

// Adding to an Array
braze.addToCustomAttributeArray("key", "attribute");
// Removing an item from an Array
braze.removeFromCustomAttributeArray("key", "attribute");

Angepasste Attribute nicht anpassen

Um ein angepasstes Attribut wieder freizugeben, übergeben Sie den entsprechenden Attributschlüssel an die Methode unsetCustomUserAttribute.

1

braze.unsetCustomUserAttribute('attribute_key');

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Roku Braze SDK integrieren.

Standard-Nutzerattribute

Vordefinierte Methoden

Braze bietet vordefinierte Methoden zum Festlegen der folgenden Nutzer:innen-Attribute unter Verwendung des m.Braze-Objekts.

  • FirstName
  • LastName
  • Email
  • Gender
  • DateOfBirth
  • Country
  • Language
  • HomeCity
  • PhoneNumber

Standardattribute festlegen

Um ein Standardattribut festzulegen, rufen Sie die entsprechende Methode für das m.Braze-Objekt auf.

1

m.Braze.setFirstName("Alex")

1

m.Braze.setLastName("Smith")

1

m.Braze.setGender("m") ' Accepts: "m", "f", "o", "n", "u", "p"

1

m.Braze.setDateOfBirth(1990, 5, 15) ' Year, month, day

1

m.Braze.setCountry("United States")

1

m.Braze.setLanguage("en")

1

m.Braze.setHomeCity("New York")

1

m.Braze.setPhoneNumber("+1234567890")

Angepasste Nutzerattribute

Zusätzlich zu den standardmäßigen Nutzer:innen-Attributen können Sie in Braze auch angepasste Attribute unter Verwendung verschiedener Datentypen definieren.

Angepasste Attribute festlegen

So legen Sie für ein angepasstes Attribut einen string-Wert fest:

1

m.Braze.setCustomAttribute("stringAttribute", "stringValue")

So legen Sie ein angepasstes Attribut mit einem integer-Wert fest:

1

m.Braze.setCustomAttribute("intAttribute", 5)

Braze behandelt die Werte von float und double genau gleich. So legen Sie ein angepasstes Attribut mit einem der beiden Werte fest:

1

m.Braze.setCustomAttribute("floatAttribute", 3.5)

So legen Sie ein angepasstes Attribut mit einem boolean-Wert fest:

1

m.Braze.setCustomAttribute("boolAttribute", true)

So legen Sie ein angepasstes Attribut mit einem date-Wert fest:

1
2
3

dateAttribute = CreateObject("roDateTime")
dateAttribute.fromISO8601String("1992-11-29 00:00:00.000")
m.Braze.setCustomAttribute("dateAttribute", dateAttribute)

So legen Sie ein angepasstes Attribut mit einem array-Wert fest:

1
2
3
4
5

stringArray = createObject("roArray", 3, true)
stringArray.Push("string1")
stringArray.Push("string2")
stringArray.Push("string3")
m.Braze.setCustomAttribute("arrayAttribute", stringArray)

Inkrementieren und Dekrementieren von angepassten Attributen

Dieser Code ist ein Beispiel für ein inkrementierendes angepasstes Attribut. Sie können den Wert eines angepassten Attributs um jeden positiven oder negativen ganzzahligen Wert erhöhen.

1

m.Braze.incrementCustomUserAttribute("intAttribute", 3)

Angepasste Attribute zurücksetzen

Um ein angepasstes Attribut zurückzusetzen, übergeben Sie den entsprechenden Attributschlüssel an die Methode unsetCustomAttribute.

1

m.Braze.unsetCustomAttribute("attributeName")

Verwendung der REST API

Sie können auch unsere REST API verwenden, um Nutzer:innen-Attribute zu setzen oder zu löschen. Weitere Informationen finden Sie unter Endpunkte für Nutzerdaten.

E-Mail-Abonnements einstellen

Sie können die folgenden E-Mail-Abo-Status für Ihre Nutzer:innen programmatisch über das SDK einstellen.

Die Methode zum Einstellen des E-Mail-Abo-Status lautet setEmailSubscriptionState(). Nutzer:innen werden bei Erhalt einer gültigen E-Mail-Adresse automatisch auf Subscribed gesetzt. Wir empfehlen Ihnen jedoch, ein explizites Opt-in-Verfahren einzurichten und diesen Wert bei Erhalt einer ausdrücklichen Zustimmung Ihrer Nutzer:innen auf OptedIn zu setzen. Weitere Informationen finden Sie unter Verwalten von Nutzer:innen-Abonnements.

1

m.Braze.setEmailSubscriptionState(BrazeConstants().SUBSCRIPTION_STATES.OPTED_IN)

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Unity Braze SDK integrieren.

Standard-Nutzerattribute

Vordefinierte Methoden

Braze stellt vordefinierte Methoden zur Verfügung, um die folgenden Nutzerattribute mithilfe des BrazeBinding-Objekts festzulegen. Weitere Informationen finden Sie in der Braze Unity-Deklarationsdatei.

  • Vorname
  • Nachname
  • E-Mail-Adresse
  • Geschlecht
  • Geburtsdatum
  • Land
  • Heimatort
  • E-Mail-Abo
  • Push-Abo
  • Telefonnummer

Standardattribute festlegen

Um ein Standardattribut festzulegen, rufen Sie die entsprechende Methode auf dem BrazeBinding-Objekt auf.

1

BrazeBinding.SetUserFirstName("first name");

1

BrazeBinding.SetUserLastName("last name");

1

BrazeBinding.SetUserGender(Appboy.Models.Gender);

1

BrazeBinding.SetUserDateOfBirth("year(int)", "month(int)", "day(int)");

1

BrazeBinding.SetUserCountry("country name");

1

BrazeBinding.SetUserHomeCity("city name");

1

BrazeBinding.SetUserEmailNotificationSubscriptionType(AppboyNotificationSubscriptionType);

1

BrazeBinding.SetUserPushNotificationSubscriptionType(AppboyNotificationSubscriptionType);

1

BrazeBinding.SetUserPhoneNumber("phone number");

Standardattribute zurücksetzen

Um ein Standardattribut zurückzusetzen, übergeben Sie null an die entsprechende Methode.

1

BrazeBinding.SetUserFirstName(null);

Angepasste Nutzerattribute

Zusätzlich zu den Standard-Nutzerattributen ermöglicht Braze auch die Definition angepasster Attribute mit verschiedenen Datentypen. Weitere Informationen zu den Segmentierungsoptionen der einzelnen Attribute finden Sie unter Datenerfassung.

Angepasste Attribute festlegen

Um ein angepasstes Attribut festzulegen, verwenden Sie die entsprechende Methode für den jeweiligen Attributtyp:

1

AppboyBinding.SetCustomUserAttribute("custom string attribute key", "string custom attribute");

1
2
3
4

// Set Integer Attribute
AppboyBinding.SetCustomUserAttribute("custom int attribute key", 'integer value');
// Increment Integer Attribute
AppboyBinding.IncrementCustomUserAttribute("key", increment(int))

1

AppboyBinding.SetCustomUserAttribute("custom float attribute key", 'float value');

1

AppboyBinding.SetCustomUserAttribute("custom boolean attribute key", 'boolean value');

1

AppboyBinding.SetCustomUserAttributeToNow("custom date attribute key");

1

AppboyBinding.SetCustomUserAttributeToSecondsFromEpoch("custom date attribute key", 'integer value');

1
2
3
4
5
6

// Setting An Array
AppboyBinding.SetCustomUserAttributeArray("key", array(List), sizeOfTheArray(int))
// Adding to an Array
AppboyBinding.AddToCustomUserAttributeArray("key", "Attribute")
// Removing an item from an Array
AppboyBinding.RemoveFromCustomUserAttributeArray("key", "Attribute")

Angepasste Attribute zurücksetzen

Um ein angepasstes Attribut zurückzusetzen, übergeben Sie den entsprechenden Attributschlüssel an die Methode UnsetCustomUserAttribute.

1

AppboyBinding.UnsetCustomUserAttribute("custom attribute key");

REST API verwenden

Sie können auch unsere REST API verwenden, um Nutzerattribute zu setzen oder zu entfernen. Weitere Informationen finden Sie unter Endpunkte für Nutzerdaten.

Abos für Nutzer:innen einrichten

Um ein E-Mail- oder Push-Abo für Ihre Nutzer:innen einzurichten, rufen Sie eine der folgenden Funktionen auf.

1
2
3
4
5

// Email notifications
AppboyBinding.SetUserEmailNotificationSubscriptionType()

// Push notifications
AppboyBinding.SetPushNotificationSubscriptionType()`

Beide Funktionen nehmen Appboy.Models.AppboyNotificationSubscriptionType als Argument entgegen, das drei verschiedene Zustände hat:

Abo-Status Definition
OPTED_IN Abonniert und ausdrücklich angemeldet
SUBSCRIBED Abonniert, aber nicht ausdrücklich angemeldet
UNSUBSCRIBED Abgemeldet und/oder ausdrücklich abbestellt
Abo-Typ Beschreibung
EmailNotificationSubscriptionType Nutzer:innen werden beim Empfang einer gültigen E-Mail-Adresse automatisch auf SUBSCRIBED gesetzt. Wir empfehlen Ihnen jedoch, ein explizites Opt-in-Verfahren einzurichten und diesen Wert auf OPTED_IN zu setzen, sobald Sie die ausdrückliche Zustimmung erhalten haben. Weitere Details finden Sie in unserer Dokumentation zum Ändern von Nutzer-Abos.
PushNotificationSubscriptionType Nutzer:innen werden bei einer gültigen Push-Registrierung automatisch auf SUBSCRIBED gesetzt. Wir empfehlen Ihnen jedoch, ein explizites Opt-in-Verfahren einzurichten und diesen Wert auf OPTED_IN zu setzen, sobald Sie die ausdrückliche Zustimmung erhalten haben. Weitere Details finden Sie in unserer Dokumentation zum Ändern von Nutzer-Abos.

E-Mail-Abos einrichten

1

AppboyBinding.SetUserEmailNotificationSubscriptionType(AppboyNotificationSubscriptionType.OPTED_IN);

Push-Benachrichtigungs-Abos einrichten

1

AppboyBinding.SetUserPushNotificationSubscriptionType(AppboyNotificationSubscriptionType.OPTED_IN);

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das React Native Braze SDK integrieren.

Benutzerdefinierte Attribute protokollieren

Braze bietet Methoden für die Zuweisung von Attributen an Benutzer. Auf dem Dashboard können Sie Ihre Benutzer nach diesen Attributen filtern und segmentieren.

Standard-Nutzerattribute

Um Nutzer:innen-Attribute zu setzen, die von Braze automatisch gesammelt werden, können Sie die Setter-Methoden verwenden, die mit dem SDK geliefert werden.

1

Braze.setFirstName("Name");

Die folgenden Attribute werden unterstützt:

  • Vorname
  • Nachname
  • Geschlecht
  • Geburtsdatum
  • Heimatstadt
  • Land
  • Telefonnummer
  • Sprache
  • E-Mail

Alle String-Werte wie Vorname, Nachname, Land und Wohnort sind auf 255 Zeichen begrenzt.

Angepasste Nutzerattribute

Zusätzlich zu unseren vordefinierten Methoden für Benutzerattribute bietet Braze auch benutzerdefinierte Attribute, um Daten aus Ihren Anwendungen zu verfolgen.

1
2
3

Braze.setCustomUserAttribute("attribute_key", "attribute_value", function(){
    // optional onResult callback
});

Angepasste Attribute nicht anpassen

1
2
3

Braze.unsetCustomUserAttribute("attribute_key", function(){
    // optional onResult callback
});

Angepasste Attribut-Arrays

1
2
3
4
5
6
7
8

// Adds a string to a custom attribute string array, or creates that array if one doesn't exist.
Braze.addToCustomUserAttributeArray("my-attribute-array", "new or existing value", optionalCallback);

// Removes a string from a custom attribute string array.


Braze.removeFromCustomUserAttributeArray("my-attribute-array", "existing value", optionalCallback);
New Stuff!