Skip to content

Nutzerattribute festlegen

Erfahren Sie, wie Sie Nutzerattribute 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 bietet vordefinierte Methoden zum Festlegen der folgenden Nutzer:innen-Attribute innerhalb der User-Klasse:

  • 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:den aktuelle:n Nutzer:in Ihrer App zu erhalten. Anschließend können Sie Methoden aufrufen, um ein Nutzerattribut festzulegen.




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






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






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

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

Beispielsweise kann das Geschlechtsattribut einen der folgenden Werte annehmen: "m" | "f" | "o" | "u" | "n" | "p". Um das Geschlecht einer:eines Nutzer:in als weiblich festzulegen, erstellen Sie ein Custom-HTML-Tag mit folgendem Inhalt:




<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 User Update-Canvas-Schritt entfernen oder zurücksetzen. Verwenden Sie für Array- und boolesche Attribute null. Für andere Datentypen verwenden Sie einen leeren String ("").

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




braze.getUser().setFirstName(null);






braze.getUser().setGender(null);






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

Angepasste Nutzerattribute

Angepasste Attribute festlegen

Zusätzlich zu den Standard-Nutzerattribut-Methoden 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:




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

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




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:




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 standardmäßige und maximale Höchstzahl an Elementen in einem Array beträgt 500. Sie können die Höchstzahl an Elementen im Braze-Dashboard unter Data Settings > 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:




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 Custom-HTML-Tag mit dem folgenden Inhalt:




<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 zugehörige Methode.




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

Verschachtelte angepasste Attribute

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




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);

REST API verwenden

Sie können auch unsere REST API verwenden, um Nutzerattribute festzulegen oder zurückzusetzen. Weitere Informationen finden Sie unter Nutzerdaten-Endpunkte.

Nutzer:innen-Abos festlegen

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

Abo-Status Definition
braze.User.NotificationSubscriptionTypes.OPTED_IN Abonniert und explizites Opt-in
braze.User.NotificationSubscriptionTypes.SUBSCRIBED Abonniert, aber kein explizites Opt-in
braze.User.NotificationSubscriptionTypes.UNSUBSCRIBED Abgemeldet und/oder explizites Opt-out

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

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

Nutzer:in von E-Mail abmelden




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

Nutzer:in von Push abmelden




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 bietet vordefinierte Methoden zum Festlegen der folgenden Nutzer:innen-Attribute innerhalb der BrazeUser-Klasse. Informationen zu den Methodenspezifikationen finden Sie in unserem KDoc.

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

Standardattribute festlegen

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




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






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

Standardattribute aufheben

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




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






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

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 Nutzerdatenerfassung.

Angepasste Attribute festlegen

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




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






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

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




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);
  }
}






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-Integer-Wert fest:




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






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

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




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






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

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




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






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

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




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






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






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);
  }
});






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 Standardanzahl und Höchstzahl an Elementen in einem Array beträgt 500. Sie können die Höchstzahl an Arrays im Braze-Dashboard unter Data Settings > angepasste Attribute aktualisieren. Arrays, die die Höchstzahl an Elementen überschreiten, werden auf die maximale Elementanzahl gekürzt. Weitere Informationen zu angepassten Attribut-Arrays und deren Verhalten finden Sie unter Arrays.




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");
  }
});






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 aufheben

Um ein angepasstes Attribut aufzuheben, übergeben Sie den entsprechenden Attribut-Key an die Methode unsetCustomUserAttribute.




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






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 Kundenprofil festgelegt. Weitere Details finden Sie unter Verschachtelte angepasste Attribute.




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;
});






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

REST API verwenden

Sie können auch unsere REST API verwenden, um Nutzerattribute festzulegen oder aufzuheben. Weitere Informationen finden Sie unter Nutzerdaten-Endpunkte.

Abos für Nutzer:innen festlegen

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

Abo-Status Definition
OPTED_IN Abonniert und ausdrücklich Opt-in erteilt
SUBSCRIBED Abonniert, aber nicht ausdrücklich Opt-in erteilt
UNSUBSCRIBED Abgemeldet und/oder ausdrücklich Opt-out erteilt

E-Mail-Abos festlegen




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






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

Push-Benachrichtigungs-Abo festlegen




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






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 auf dem Braze.User-Objekt festgelegt werden:

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

Standardattribute festlegen

Um ein Standardattribut für eine:n Nutzer:in festzulegen, setzen Sie das entsprechende Feld auf dem gemeinsamen Braze.User-Objekt. Das folgende Beispiel zeigt, wie Sie das Vorname-Attribut festlegen:




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






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

Standardattribute zurücksetzen

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




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






[AppDelegate.braze.user setFirstName:nil];

Angepasste Nutzerattribute

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

Angepasste Attribute festlegen

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




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






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

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




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






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

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




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






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

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




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






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

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




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






[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 der Arrays 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:




// 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")






// 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 jeden beliebigen integer- oder long-Wert erhöhen:




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






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

Angepasste Attribute zurücksetzen

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




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

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




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

Verschachtelte angepasste Attribute

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




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

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






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 festzulegen oder zurückzusetzen. Weitere Informationen finden Sie unter Nutzerdaten-Endpunkte.

Abo-Status für Nutzer:innen festlegen

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

Abo-Status Definition
optedIn Abonniert und explizites Opt-in erteilt
subscribed Abonniert, aber kein explizites Opt-in erteilt
unsubscribed Abgemeldet und/oder explizites Opt-out erteilt

Nutzer:innen, die einer App die Erlaubnis erteilen, ihnen Push-Benachrichtigungen zu senden, erhalten standardmäßig den Status optedIn, da iOS ein explizites Opt-in erfordert.

Nutzer:innen werden beim Erhalt einer gültigen E-Mail-Adresse automatisch auf subscribed gesetzt. Wir empfehlen Ihnen jedoch, einen expliziten Opt-in-Prozess einzurichten und diesen Wert bei ausdrücklicher Zustimmung Ihrer Nutzer:innen auf optedIn zu setzen. Weitere Informationen finden Sie unter Nutzer:innen-Abos verwalten.

E-Mail-Abos festlegen




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






[AppDelegate.braze.user setEmailSubscriptionState: BRZUserSubscriptionState]

Push-Benachrichtigungs-Abos festlegen




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






[AppDelegate.braze.user setPushNotificationSubscriptionState: BRZUserSubscriptionState]

Weitere Informationen finden Sie unter Nutzer:innen-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.




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:




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

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




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




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

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




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

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




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

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




// 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.




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.




m.Braze.setFirstName("Alex")






m.Braze.setLastName("Smith")






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






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






m.Braze.setCountry("United States")






m.Braze.setLanguage("en")






m.Braze.setHomeCity("New York")






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:




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

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




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:




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

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




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

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




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:




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.




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.




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.




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
  • Geschlecht
  • Geburtsdatum
  • Land
  • Wohnort
  • E-Mail-Abo
  • Push-Abo
  • Telefonnummer

Standardattribute festlegen

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




BrazeBinding.SetUserFirstName("first name");






BrazeBinding.SetUserLastName("last name");






BrazeBinding.SetUserGender(Appboy.Models.Gender);






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






BrazeBinding.SetUserCountry("country name");






BrazeBinding.SetUserHomeCity("city name");






BrazeBinding.SetUserEmailNotificationSubscriptionType(AppboyNotificationSubscriptionType);






BrazeBinding.SetUserPushNotificationSubscriptionType(AppboyNotificationSubscriptionType);






BrazeBinding.SetUserPhoneNumber("phone number");

Standardattribute zurücksetzen

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




BrazeBinding.SetUserFirstName(null);

Angepasste Nutzerattribute

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

Angepasste Attribute festlegen

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




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






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






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






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






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






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






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






// 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")

Sie können angepasste Attribute mit verschachtelten Objekten festlegen (verfügbar ab Unity SDK 5.1.0). Weitere Informationen finden Sie unter Verschachtelte angepasste Attribute. Die folgenden Beispiele zeigen, wie Sie ein verschachteltes Objektattribut festlegen, Aktualisierungen in ein bestehendes Objekt zusammenführen und ein Array verschachtelter Objekte festlegen.




AppboyBinding.SetCustomUserAttribute("custom object attribute key", dictionary(Dictionary<string, object>));

Um ein bestehendes verschachteltes Objekt zu aktualisieren, verwenden Sie den Merge-Parameter:




AppboyBinding.SetCustomUserAttribute("custom object attribute key", dictionary(Dictionary<string, object>), merge(bool));

Sie können auch ein Array verschachtelter Objekte festlegen:




AppboyBinding.SetCustomUserAttribute("custom object array attribute key", list(List<Dictionary<string, object>>));

Angepasste Attribute zurücksetzen

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




AppboyBinding.UnsetCustomUserAttribute("custom attribute key");

Verwendung der REST API

Sie können auch unsere REST API verwenden, um Nutzerattribute festzulegen oder zurückzusetzen. Weitere Informationen finden Sie unter Nutzerdaten-Endpunkte.

Nutzer:innen-Abos festlegen

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




// 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 abgemeldet
Abo-Typ Beschreibung
EmailNotificationSubscriptionType Nutzer:innen werden beim Erhalt einer gültigen E-Mail-Adresse automatisch auf SUBSCRIBED gesetzt. Wir empfehlen jedoch, einen ausdrücklichen Opt-in-Prozess einzurichten und diesen Wert bei ausdrücklicher Zustimmung Ihrer Nutzer:in auf OPTED_IN zu setzen. Weitere Details finden Sie in unserer Dokumentation zum Ändern von Nutzer:innen-Abos.
PushNotificationSubscriptionType Nutzer:innen werden bei einer gültigen Push-Registrierung automatisch auf SUBSCRIBED gesetzt. Wir empfehlen jedoch, einen ausdrücklichen Opt-in-Prozess einzurichten und diesen Wert bei ausdrücklicher Zustimmung Ihrer Nutzer:in auf OPTED_IN zu setzen. Weitere Details finden Sie in unserer Dokumentation zum Ändern von Nutzer:innen-Abos.

E-Mail-Abos festlegen




AppboyBinding.SetUserEmailNotificationSubscriptionType(AppboyNotificationSubscriptionType.OPTED_IN);

Push-Benachrichtigungs-Abos festlegen




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.




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.




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

Angepasste Attribute nicht anpassen




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

Angepasste Attribut-Arrays




// 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);

Documentation for the Braze customer engagement platform.

Resources
Legal
Company
© 2026 Braze, Inc. All rights reserved.
Braze-Status wird geprüft
New Stuff!