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. Um eine Währungsumrechnung zu vermeiden, legen Sie die Währung auf USD fest.

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 Bezeichner des Produkts 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 kann maximal 255 Zeichen lang sein. Wenn der Bezeichner des Produkts leer ist, wird der Kauf außerdem nicht in Braze protokolliert.

Eigenschaften hinzufügen

Sie können Metadaten über Käufe hinzufügen, indem Sie ein Wörterbuch mit den Werten 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 eingestellt. Sie können jedoch eine Menge zu Ihren Einkäufen hinzufügen, wenn Kund:innen denselben Einkauf mehrmals in einem einzigen Bezahlvorgang tätigen. Um eine Menge hinzuzufügen, übergeben Sie einen Int-Wert an quantity.

Verwendung der REST API

Sie können auch unsere REST API verwenden, um Einkäufe zu erfassen. Weitere Informationen finden Sie unter Endpunkte für Nutzerdaten.

Bestellungen protokollieren

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

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. Bei Verwendung eines anderen Währungssymbols wird eine Warnung protokolliert, und der Kauf wird nicht in Braze erfasst.

• 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