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.

Warnung

Das AppboyKit (auch bekannt als Objective-C SDK) wird nicht mehr unterstützt und wurde durch das Swift SDK. ] ersetzt. Es wird keine neuen Features, Fehlerbehebungen, Sicherheitsupdates oder technischen Support mehr erhalten - Messaging und Analytics werden jedoch weiterhin wie gewohnt funktionieren. Weitere Informationen finden Sie unter Einführung in das neue Braze Swift SDK.

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 auf dem gemeinsam genutzten ABKUser-Objekt festlegen.

Das Folgende ist ein Beispiel für das Festlegen des Vorname-Attributs:

objective-c
swift

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

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

Die folgenden Attribute sollten auf dem 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 unter Verwendung verschiedener Datentypen definieren. Weitere Informationen zu den Segmentierungsoptionen, die Ihnen die einzelnen Attribute bieten, finden Sie in unserer Nutzerdatenerfassung.

Angepasstes Attribut mit einem String-Wert

objective-c
swift

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

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

Angepasstes Attribut mit einem ganzzahligen Wert

objective-c
swift

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

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

Angepasstes Attribut mit einem Double-Wert

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

objective-c
swift

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

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

Angepasstes Attribut mit einem booleschen Wert

objective-c
swift

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

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.

objective-c
swift

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

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

Angepasstes Attribut mit einem Array-Wert

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 Dateneinstellungen > Angepasste Attribute aktualisieren. Arrays, die die Höchstzahl an Elementen überschreiten, werden auf die Höchstzahl an Elementen gekürzt.

objective-c
swift

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

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

Zurücksetzen eines angepassten Attributs

Angepasste Attribute können auch mit der folgenden Methode zurückgesetzt werden:

objective-c
swift

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

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 einen beliebigen positiven oder negativen Integer- oder Long-Wert erhöhen:

objective-c
swift

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

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

Festlegen eines angepassten Attributs über die REST API

Sie können auch unsere REST API verwenden, um Nutzerattribute festzulegen. Weitere Informationen finden Sie in der Nutzer-API-Dokumentation.

Wertbegrenzungen für angepasste Attribute

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

Zusätzliche Informationen

Weitere Details finden Sie in der ABKUser.h-Datei.
Weitere Informationen finden Sie in der ABKUser-Dokumentation.

Abos für Nutzer:innen einrichten

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

Abo-Status	Definition
`ABKOptedin`	Abonniert und explizites Opt-in erteilt
`ABKSubscribed`	Abonniert, aber kein explizites Opt-in erteilt
`ABKUnsubscribed`	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 ABKOptedin, da iOS ein explizites Opt-in erfordert.

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

[[Appboy sharedInstance].user setEmailNotificationSubscriptionType: ABKNotificationSubscriptionType]

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

Push-Benachrichtigungsabos festlegen

objective-c
swift

[[Appboy sharedInstance].user setPushNotificationSubscriptionType: ABKNotificationSubscriptionType]

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

Weitere Informationen finden Sie unter Nutzerabos verwalten.

New Stuff!