Skip to content


Angepasste Attribute für iOS festlegen

Braze bietet Methoden für die Zuweisung von Attributen an Nutzer:innen. Im Dashboard können Sie Ihre Nutzer:innen nach diesen Attributen filtern und segmentieren.

Lesen Sie vor der Implementierung unbedingt die Beispiele für die Segmentierungsoptionen, die angepasste Events, angepasste Attribute und Kauf-Events bieten, in unseren Best Practices sowie unsere Hinweise zu den Namenskonventionen für Events.

Zuweisen von Standard-Nutzerattributen

Um Nutzerattribute zuzuweisen, müssen Sie das entsprechende Feld für das gemeinsame ABKUser-Objekt festlegen.

Im Folgenden sehen Sie ein Beispiel für das Festlegen des Vorname-Attributs:

1

[Appboy sharedInstance].user.firstName = @"first_name";

1

Appboy.sharedInstance()?.user.firstName = "first_name"

Die folgenden Attribute sollten für das ABKUser-Objekt festgelegt werden:

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

Zuweisen von angepassten Nutzerattributen

Neben den Standard-Nutzerattributen können Sie in Braze auch angepasste Attribute mit verschiedenen Datentypen definieren. Weitere Informationen zu den Segmentierungsoptionen, die Ihnen jedes dieser Attribute bietet, finden Sie in unserer Dokumentation zur Datenerfassung.

Angepasstes Attribut mit einem String-Wert

1

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andStringValue:"your_attribute_value"];

1

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andStringValue: "your_attribute_value")

Angepasstes Attribut mit einem Integer-Wert

1

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andIntegerValue:yourIntegerValue];

1

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andIntegerValue: yourIntegerValue)

Angepasstes Attribut mit einem Double-Wert

Braze behandelt float- und double-Werte in der Datenbank gleich.

1

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andDoubleValue:yourDoubleValue];

1

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andDoubleValue: yourDoubleValue)

Angepasstes Attribut mit einem booleschen Wert

1

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andBOOLValue:yourBOOLValue];

1

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andBOOLValue: yourBoolValue)

Angepasstes Attribut mit einem Datumswert

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 Format yyyy-MM-dd'T'HH:mm:ss:SSSZ (2016-12-14T13:32:31.601-0800) vorliegen.

1

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andDateValue:yourDateValue];

1

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andDateValue:yourDateValue)

Angepasstes Attribut mit einem Array-Wert

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.

1
2
3
4
5
6
7
8

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

1
2
3
4
5
6

// Setting a custom attribute with an array value
Appboy.sharedInstance()?.user.setCustomAttributeArrayWithKey("array_name", array: ["value1",  "value2"])
// Adding to a custom attribute with an array value
Appboy.sharedInstance()?.user.addToCustomAttributeArrayWithKey("array_name", value: "value3")
// Removing a value from an array type custom attribute
Appboy.sharedInstance()?.user.removeFromCustomAttributeArrayWithKey("array_name", value: "value2")

Aufheben eines angepassten Attributs

Angepasste Attribute können auch mit der folgenden Methode aufgehoben werden:

1

[[Appboy sharedInstance].user unsetCustomAttributeWithKey:@"your_attribute_key"];

1

Appboy.sharedInstance()?.user.unsetCustomAttributeWithKey("your_attribute_key")

Inkrementieren/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 Integer- oder Long-Wert erhöhen:

1

[[Appboy sharedInstance].user incrementCustomUserAttribute:@"your_attribute_key" by:incrementIntegerValue];

1

Appboy.sharedInstance()?.user.incrementCustomUserAttribute("your_attribute_key", by: incrementIntegerValue)

Festlegen eines angepassten Attributs über die REST API

Sie können auch die REST API verwenden, um Nutzerattribute festzulegen. Einzelheiten finden Sie in der Nutzer-API-Dokumentation.

Wertgrenzen für angepasste Attribute

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

Zusätzliche Informationen

Einrichten von Nutzer-Abos

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

Abostatus Definition
ABKOptedin Abonniert und ausdrücklich angemeldet
ABKSubscribed Abonniert, aber nicht ausdrücklich angemeldet
ABKUnsubscribed Abbestellt und/oder ausdrücklich abgemeldet

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

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

Einstellen von E-Mail-Abos

1

[[Appboy sharedInstance].user setEmailNotificationSubscriptionType: ABKNotificationSubscriptionType]

1

Appboy.sharedInstance()?.user.setEmailNotificationSubscriptionType(ABKNotificationSubscriptionType)

Einstellen von Push-Benachrichtigungs-Abos

1

[[Appboy sharedInstance].user setPushNotificationSubscriptionType: ABKNotificationSubscriptionType]

1

Appboy.sharedInstance()?.user.setPushNotificationSubscriptionType(ABKNotificationSubscriptionType)

Weitere Einzelheiten finden Sie unter Verwalten von Nutzer-Abos.
New Stuff!