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.

Käufe für iOS protokollieren

Erfassen Sie In-App-Käufe, damit Sie Ihren Umsatz im Zeitverlauf und über verschiedene Umsatzquellen hinweg verfolgen und Ihre Nutzer:innen nach ihrem LTV segmentieren können.

Braze unterstützt Einkäufe in mehreren Währungen. Einkäufe, die Sie in einer anderen Währung als dem USD melden, werden im Dashboard in USD auf der Grundlage des Wechselkurses an dem Tag, an dem sie gemeldet wurden, angezeigt.

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.

Käufe und Umsätze protokollieren

Um dieses Feature zu nutzen, fügen Sie diesen Methodenaufruf nach einem erfolgreichen Kauf in Ihrer App hinzu:

• objective-c
• swift

1
2
3
[[Appboy sharedInstance] logPurchase:@"your product ID"
inCurrency:@"USD"
atPrice:[[[NSDecimalNumber alloc] initWithString:@"0.99"] autorelease]];

1
Appboy.sharedInstance()?.logPurchase("your product ID", inCurrency: "USD", atPrice: NSDecimalNumber(string: "0.99"))

• Unterstützte Währungssymbole sind unter anderem: USD, CAD, EUR, GBP, JPY, AUD, CHF, NOK, MXN, NZD, CNY, RUB, TRY, INR, IDR, ILS, SAR, ZAR, AED, SEK, HKD, SPD, DKK.
  • Jedes andere angegebene Währungssymbol führt zu einer protokollierten Warnung, ohne dass das SDK weitere Aktionen durchführt.
• Der Produkt-Bezeichner kann maximal 255 Zeichen lang sein.
• Beachten Sie, dass der Kauf nicht in Braze protokolliert wird, wenn der Produkt-Bezeichner leer ist.

Eigenschaften hinzufügen

Sie können Metadaten zu Käufen hinzufügen, indem Sie entweder ein Event-Eigenschaft-Array oder ein NSDictionary übergeben, das mit NSNumber-, NSString- oder NSDate-Werten gefüllt ist.

Weitere Details finden Sie in der iOS-Klassendokumentation.

Menge hinzufügen

Sie können Ihren Käufen eine Menge hinzufügen, wenn Kund:innen denselben Kauf mehrmals in einem einzelnen Bezahlvorgang tätigen. Dazu übergeben Sie einen NSUInteger für die Menge.

• Der Mengenwert muss im Bereich [0, 100] liegen, damit das SDK einen Kauf protokolliert.
• Methoden ohne Mengeneingabe haben einen Standardwert von 1.
• Methoden mit Mengeneingabe haben keinen Standardwert und müssen eine Mengeneingabe erhalten, damit das SDK einen Kauf protokolliert.

Weitere Details finden Sie in der iOS-Klassendokumentation.

• objective-c
• swift

1
2
3
4
[[Appboy sharedInstance] logPurchase:@"your product ID"
inCurrency:@"USD"
atPrice:[[[NSDecimalNumber alloc] initWithString:@"0.99"] autorelease]
withProperties:@{@"key1":"value1"}];

1
Appboy.sharedInstance()?.logPurchase("your product ID", inCurrency: "USD", atPrice: NSDecimalNumber(string: "0.99"), withProperties: ["key1":"value1"])

Tipp

Wenn Sie einen Wert von 10 USD und eine Menge von 3 übergeben, werden im Profil der Nutzer:innen drei Käufe zu je 10 Dollar protokolliert, also insgesamt 30 Dollar.

Käufe auf Bestellebene protokollieren

Wenn Sie Käufe auf Bestellebene statt auf Produktebene protokollieren möchten, können Sie den Bestellnamen oder die Bestellkategorie als product_id verwenden. Weitere Informationen finden Sie in unserer Kauf-Objekt-Spezifikation.

Reservierte Schlüssel

Die folgenden Schlüssel sind reserviert und können nicht als Kauf-Eigenschaften verwendet werden:

• time
• product_id
• quantity
• event_name
• price
• currency

REST API

Sie können auch unsere REST API verwenden, um Käufe zu erfassen. Weitere Details finden Sie in der User-API-Dokumentation.