Einkäufe protokollieren

Erfahren Sie, wie Sie In-App-Käufe über das Braze SDK protokollieren können, damit Sie Ihren Umsatz im Zeitverlauf und über verschiedene Quellen hinweg bestimmen können. So können Sie Nutzer:innen anhand ihres Lifetime-Value mit angepassten Events, angepassten Attributen und Kauf-Events segmentieren.

Hinweis

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

Alle gemeldeten Nicht-USD-Währungen werden in Braze auf Basis des Wechselkurses am Tag der Meldung in USD angezeigt. Informationen zur Dashboard-Konversion, zum Caching und zur Aktualisierung der Wechselkurse finden Sie unter Währungsumrechnung. Um eine Konversion zu vermeiden, protokollieren Sie Einkäufe mit USD als Währungscode.

Käufe und Umsätze protokollieren

Um Käufe und Umsätze zu protokollieren, rufen Sie logPurchase() nach einem erfolgreichen Kauf in Ihrer App auf. Wenn der Produkt-Bezeichner leer ist, wird der Kauf nicht in Braze protokolliert.

• web
• android
• swift
• cordova
• flutter
• react native
• roku
• unity

1
braze.logPurchase(product_id, price, "USD", quantity);

1
2
3
4
5
6
Braze.getInstance(context).logPurchase(
   String productId,
   String currencyCode,
   BigDecimal price,
   int quantity
);

1
2
3
4
5
6
Braze.getInstance(context).logPurchase(
  productId: String,
  currencyCode: String,
  price: BigDecimal,
  quantity: Int
)

1
AppDelegate.braze?.logPurchase(productID: "product_id", currency: "USD", price: price)

1
2
3
[AppDelegate.braze logPurchase:"product_id"
                      currency:@"USD"
                         price:price];

1
2
3
var properties = {};
properties["KEY"] = "VALUE";
BrazePlugin.logPurchase("PRODUCT_ID", 10, "USD", 5, properties);

1
braze.logPurchase(productId, currencyCode, price, quantity, properties: properties);

1
Braze.logPurchase(productId, price, currencyCode, quantity, properties);

1
m.Braze.logPurchase("product_id", "currency_code", Double price, Integer quantity)

1
AppboyBinding.LogPurchase("product_id", "currencyCode", price(decimal));

Warnung

productID darf maximal 255 Zeichen lang sein. Wenn der Produkt-Bezeichner leer ist, wird der Kauf außerdem nicht in Braze protokolliert.

Eigenschaften hinzufügen

Sie können Metadaten zu Käufen hinzufügen, indem Sie ein Dictionary mit Werten vom Typ Int, Double, String, Bool oder Date übergeben.

• web
• android
• swift
• cordova
• flutter
• react native
• roku
• unity

1
braze.logPurchase(product_id, price, "USD", quantity, {key: "value"});

1
2
3
4
5
6
7
items: [{
  item_name: "5 L WIV ECO SAE 5W/30",
  item_id: "10801463",
  price: 24.65,
  item_brand: "EUROLUB",
  quantity: 1
}]

1
2
3
BrazeProperties purchaseProperties = new BrazeProperties();
purchaseProperties.addProperty("key", "value");
Braze.getInstance(context).logPurchase(..., purchaseProperties);

1
2
3
val purchaseProperties = BrazeProperties()
purchaseProperties.addProperty("key", "value")
Braze.getInstance(context).logPurchase(..., purchaseProperties)

1
2
let purchaseProperties = ["key": "value"]
AppDelegate.braze?.logPurchase(productID: "product_id", currency: "USD", price: price, properties: purchaseProperties)

1
2
3
4
5
NSDictionary *purchaseProperties = @{@"key": @"value"};
[AppDelegate.braze logPurchase:@"product_id"
                      currency:@"USD"
                         price:price
                   properties:purchaseProperties];

1
2
3
var properties = {};
properties["key"] = "value";
BrazePlugin.logPurchase("PRODUCT_ID", 10, "USD", 5, properties);

1
braze.logPurchase(productId, currencyCode, price, quantity, properties: {"key": "value"});

1
Braze.logPurchase(productId, price, currencyCode, quantity, { key: "value" });

1
m.Braze.logPurchase("product_id", "currency_code", Double price, Integer quantity, {"stringPropKey" : "stringPropValue", "intPropKey" : Integer intPropValue})

1
2
3
4
5
Dictionary<string, object> purchaseProperties = new Dictionary<string, object>
{
    { "key", "value" }
};
AppboyBinding.LogPurchase("product_id", "currencyCode", price(decimal), purchaseProperties);

Menge hinzufügen

Standardmäßig ist quantity auf 1 gesetzt. Sie können Ihren Käufen jedoch eine Menge hinzufügen, wenn Kund:innen denselben Kauf mehrmals in einem einzigen Checkout tätigen. Um eine Menge hinzuzufügen, übergeben Sie einen Int-Wert an quantity.

REST API verwenden

Sie können auch unsere REST API verwenden, um Käufe zu erfassen. Weitere Informationen finden Sie unter Nutzerdaten-Endpunkte.

Bestellungen 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-Details verwendet werden:

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

Unterstützte Währungen

Braze unterstützt die folgenden Währungssymbole. Jedes andere Währungssymbol, das Sie angeben, löst eine Warnung aus und der Kauf wird nicht in Braze protokolliert.

• AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN
• BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL
• BSD, BTC, BTN, BWP, BYR, BZD
• CAD, CDF, CHF, CLF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK
• DJF, DKK, DOP, DZD
• EEK, EGP, ERN, ETB, EUR
• FJD, FKP
• GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD
• HKD, HNL, HRK, HTG, HUF
• IDR, ILS, IMP, INR, IQD, IRR, ISK
• JEP, JMD, JOD, JPY
• KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT
• LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD
• MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MTL, MUR, MVR, MWK, MXN, MYR, MZN
• NAD, NGN, NIO, NOK, NPR, NZD
• OMR
• PAB, PEN, PGK, PHP, PKR, PLN, PYG
• QAR
• RON, RSD, RUB, RWF
• SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, STD, SVC, SYP, SZL
• THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS
• UAH, UGX, USD, UYU, UZS
• VEF, VND, VUV
• WST
• XAF, XAG, XAU, XCD, XDR, XOF, XPD, XPF, XPT
• YER
• ZAR, ZMK, ZMW, ZWL