Zum Inhalt springen

Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

Nutzerattribute festlegen

Erfahren Sie, wie Sie Nutzerattribute mit dem Braze SDK festlegen können.

Hinweis

Für Wrapper-SDKs, die nicht aufgeführt sind, verwenden Sie stattdessen die entsprechende native Android- oder Swift-Methode.

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie das Braze Web 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

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 Nutzer:innen-Attribut festzulegen.

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

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

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

Über Google Tag Manager sollten Standard-Nutzerattribute (wie z. B. der Vorname) auf die gleiche 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 User-Klasse angegeben ist.

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

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

Standardattribute zurücksetzen

Sie können ein Nutzer:innen-Attribut über Ihren App-Code, eine REST-API-Anfrage oder einen User Update-Canvas-Schritt entfernen oder zurücksetzen. Verwenden Sie für Array- und Boolean-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

methoden verwenden
google tag manager

Zusätzlich zu den Standardmethoden für Nutzerattribute können Sie auch angepasste Attribute für Ihre Nutzer:innen festlegen. Vollständige 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 maximale Anzahl von Arrays im Braze-Dashboard unter Data Settings > Custom Attributes 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:

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

Wichtig

Datumsangaben, die mit dieser Methode an Braze übergeben werden, müssen JavaScript-Date-Objekte sein.

Wichtig

Schlüssel und Werte angepasster Attribute dürfen maximal 255 Zeichen lang sein. Weitere Informationen zu gültigen Werten für angepasste Attribute finden Sie in der Referenzdokumentation.

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 folgendem 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>

Wichtig

Das GTM-Template unterstützt keine verschachtelten Eigenschaften für Ereignisse oder Käufe. Sie können das vorstehende HTML verwenden, um Ereignisse oder Käufe zu protokollieren, die verschachtelte Eigenschaften erfordern.

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 Nutzerprofil 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 explizit angemeldet (Opt-in)
`braze.User.NotificationSubscriptionTypes.SUBSCRIBED`	Abonniert, aber nicht explizit angemeldet (Opt-in)
`braze.User.NotificationSubscriptionTypes.UNSUBSCRIBED`	Abgemeldet und/oder explizit abgemeldet (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. Für Methodenspezifikationen lesen Sie unsere KDoc.

Vorname
Nachname
Land
Sprache
Geburtsdatum
E-Mail
Geschlecht
Heimatstadt
Telefonnummer

Hinweis

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

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 Nutzer:innen-Attribut festzulegen.

java
kotlin

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 zurücksetzen

Um ein Nutzer:innen-Attribut zurückzusetzen, übergeben Sie null an die entsprechende Methode.

java
kotlin

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

java
kotlin

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:

java
kotlin

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:

java
kotlin

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:

java
kotlin

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:

java
kotlin

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:

java
kotlin

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

java
kotlin

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

Warnung

Datumsangaben, die mit dieser Methode an Braze übergeben werden, müssen entweder im ISO-8601-Format (z. B. 2013-07-16T19:20:30+01:00) oder im yyyy-MM-dd'T'HH:mm:ss:SSSZ-Format (z. B. 2016-12-14T13:32:31.601-0800) vorliegen.

Die Standard- 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 > Custom Attributes 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.

java
kotlin

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 zurücksetzen

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

java
kotlin

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

java
kotlin

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 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 NotificationSubscriptionType als Argument entgegen. Dieser Typ hat drei verschiedene Zustände:

Abo-Status	Definition
`OPTED_IN`	Abonniert und explizit angemeldet
`SUBSCRIBED`	Abonniert, aber nicht explizit angemeldet
`UNSUBSCRIBED`	Abgemeldet und/oder explizit abgemeldet

Wichtig

Unter Android ist kein explizites Opt-in erforderlich, um Nutzer:innen Push-Benachrichtigungen zu senden. Wenn Nutzer:innen für Push registriert werden, werden sie standardmäßig auf SUBSCRIBED statt auf OPTED_IN gesetzt. Weitere Informationen zur Implementierung von Abos und expliziten Opt-ins finden Sie unter Nutzer:innen-Abos verwalten.

E-Mail-Abos festlegen

java
kotlin

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

java
kotlin

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 Braze Swift 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 gemeinsam genutzten Braze.User-Objekt. Das folgende Beispiel zeigt, wie das Vorname-Attribut festgelegt wird:

swift
objective-c

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.

swift
objective-c

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

[AppDelegate.braze.user setFirstName:nil];

Angepasste Nutzerattribute

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

Wichtig

Angepasste Attributwerte haben eine maximale Länge von 255 Zeichen; längere Werte werden abgeschnitten. Weitere Informationen finden Sie unter Braze.User.

Angepasste Attribute festlegen

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

swift
objective-c

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:

swift
objective-c

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:

swift
objective-c

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:

swift
objective-c

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:

swift
objective-c

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

swift
objective-c

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

swift
objective-c

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

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

Angepasste Attribute zurücksetzen

swift
objective-c

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

swift
objective-c

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.

Nutzer:innen-Abos 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 nehmen den Enum-Typ Braze.User.SubscriptionState als Argumente entgegen. Dieser Typ hat drei verschiedene Zustände:

Abo-Status	Definition
`optedIn`	Abonniert und ausdrücklich angemeldet (Opt-in)
`subscribed`	Abonniert, aber nicht ausdrücklich angemeldet (Opt-in)
`unsubscribed`	Abgemeldet und/oder ausdrücklich abgemeldet (Opt-out)

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

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

E-Mail-Abos festlegen

swift
objective-c

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

[AppDelegate.braze.user setEmailSubscriptionState: BRZUserSubscriptionState]

Push-Benachrichtigungs-Abos festlegen

swift
objective-c

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

Wichtig

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

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

Wichtig

Angepasste Attributwerte haben eine maximale Länge von 255 Zeichen; längere Werte werden abgeschnitten.

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 Braze Roku SDK integrieren.

Standard-Nutzerattribute

Vordefinierte Methoden

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

FirstName
LastName
Email
Gender
DateOfBirth
Country
Language
HomeCity
PhoneNumber

Standardattribute festlegen

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

m.Braze.setFirstName("Alex")

m.Braze.setLastName("Smith")

m.Braze.setEmail("[email protected]")

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 Standardattributen ermöglicht Braze Ihnen auch, angepasste Attribute mit verschiedenen Datentypen zu definieren.

Angepasste Attribute festlegen

So legen Sie ein angepasstes Attribut mit einem 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 float- und double-Werte identisch. So legen Sie ein angepasstes Attribut mit einem dieser 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)

Wichtig

Angepasste Attributwerte haben eine maximale Länge von 255 Zeichen; längere Werte werden abgeschnitten.

Angepasste Attribute inkrementieren und dekrementieren

Dieser Code ist ein Beispiel für ein inkrementierendes angepasstes Attribut. Sie können den Wert eines angepassten Attributs um einen beliebigen 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 Nutzerattribute festzulegen oder zurückzusetzen. Weitere Informationen finden Sie unter Nutzerdaten-Endpunkte.

E-Mail-Abos festlegen

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

Abostatus	Definition
`OptedIn`	Abonniert und ausdrücklich angemeldet
`Subscribed`	Abonniert, aber nicht ausdrücklich angemeldet
`UnSubscribed`	Abgemeldet und/oder ausdrücklich abgemeldet

Hinweis

Diese Typen fallen unter BrazeConstants().SUBSCRIPTION_STATES.

Die Methode zum Festlegen des E-Mail-Abostatus ist setEmailSubscriptionState(). Nutzer:innen werden beim Empfang einer gültigen E-Mail-Adresse automatisch auf Subscribed gesetzt. Wir empfehlen jedoch, einen ausdrücklichen Opt-in-Prozess einzurichten und diesen Wert bei Erhalt der ausdrücklichen Zustimmung Ihrer Nutzer:innen auf OptedIn zu setzen. Weitere Informationen finden Sie unter Nutzerabos verwalten.

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 bietet vordefinierte Methoden zum Festlegen der folgenden Nutzer:innen-Attribute mithilfe des BrazeBinding-Objekts. Weitere Informationen finden Sie in der Braze Unity-Deklarationsdatei.

Vorname
Nachname
E-Mail
Geschlecht
Geburtsdatum
Land
Heimatstadt
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.SetUserEmail("[email protected]");

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 Standard-Nutzerattribut zurückzusetzen, übergeben Sie null an die entsprechende Methode.

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

Angepasste Attribute festlegen

Um ein angepasstes Attribut festzulegen, verwenden Sie die entsprechende Methode für den jeweiligen 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');

Hinweis

An Braze übergebene Datumsangaben müssen entweder im ISO-8601-Format (z. B. 2013-07-16T19:20:30+01:00) oder im Format yyyy-MM-dd'T'HH:mm:ss:SSSZ (z. B. 2016-12-14T13:32:31.601-0800) vorliegen.

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

Wichtig

Angepasste Attributwerte haben eine maximale Länge von 255 Zeichen; längere Werte werden abgeschnitten.

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 verwenden Appboy.Models.AppboyNotificationSubscriptionType als Argumente, die drei verschiedene Zustände haben:

Abo-Status	Definition
`OPTED_IN`	Abonniert und explizit angemeldet
`SUBSCRIBED`	Abonniert, aber nicht explizit angemeldet
`UNSUBSCRIBED`	Abgemeldet und/oder explizit abgemeldet

Hinweis

Unter Windows ist kein explizites Opt-in erforderlich, um Nutzer:innen Push-Benachrichtigungen zu senden. Wenn Nutzer:innen für Push registriert werden, werden sie standardmäßig auf SUBSCRIBED statt auf OPTED_IN gesetzt. Weitere Informationen finden Sie in unserer Dokumentation zur Implementierung von Abos und expliziten Opt-ins.

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

Hinweis

Diese Typen gehören zu Appboy.Models.AppboyNotificationSubscriptionType.

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.

Angepasste Attribute protokollieren

Braze bietet Methoden, um Nutzer:innen Attribute zuzuweisen. Sie können Ihre Nutzer:innen anhand dieser Attribute im Dashboard filtern und segmentieren.

Standard-Nutzerattribute

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

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 Heimatstadt sind auf 255 Zeichen begrenzt.

Angepasste Nutzerattribute

Zusätzlich zu den vordefinierten Methoden für Nutzerattribute bietet Braze auch angepasste Attribute, um Daten aus Ihren Anwendungen zu verfolgen.

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

Angepasste Attribute zurücksetzen

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

New Stuff!