Enregistrer les achats

Découvrez comment enregistrer les achats in-app via le SDK Braze, afin de pouvoir déterminer vos chiffres d’affaires au fil du temps et selon les différentes sources. Vous pourrez ainsi segmenter les utilisateurs en fonction de leur valeur vie client à l’aide d’événements personnalisés, d’attributs personnalisés et d’événements d’achat.

Remarque

Pour les SDK wrapper non répertoriés, utilisez plutôt la méthode native Android ou Swift correspondante.

Toute devise autre que l’USD sera affichée dans Braze en USD, sur la base du taux de change en vigueur à la date de déclaration. Afin d’éviter toute conversion monétaire, définissez la devise en USD de manière fixe.

Enregistrement des achats et des chiffres d’affaires

Pour enregistrer les achats et les chiffres d’affaires, appelez logPurchase() après un achat réussi dans votre application. Si l’identifiant du produit est vide, l’achat ne sera pas enregistré dans Braze.

• 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));

Avertissement

productID ne peut contenir plus de 255 caractères. De plus, si l’identifiant du produit est vide, l’achat ne sera pas enregistré dans Braze.

Ajouter des propriétés

Vous pouvez ajouter des métadonnées sur les achats en transmettant un dictionnaire contenant des valeurs Int, Double, String, Bool ou Date.

• 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);

Ajouter une quantité

Par défaut, quantity est défini sur 1. Toutefois, vous pouvez ajouter une quantité à vos achats si les clients effectuent le même achat plusieurs fois lors d’un même passage en caisse. Pour ajouter une quantité, transmettez une valeur Int à quantity.

Utiliser la REST API

Vous pouvez également utiliser notre REST API pour enregistrer les achats. Pour plus d’informations, consultez les endpoints de données utilisateur.

Enregistrement des commandes

Si vous souhaitez enregistrer les achats au niveau de la commande plutôt qu’au niveau du produit, vous pouvez utiliser le nom de la commande ou la catégorie de commande comme product_id. Pour en savoir plus, consultez les spécifications de l’objet d’achat.

Clés réservées

Les clés suivantes sont réservées et ne peuvent pas être utilisées comme propriétés d’achat :

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

Devises prises en charge

Braze prend en charge les symboles monétaires suivants. Tout autre symbole monétaire que vous fournissez génère un avertissement et l’achat n’est pas enregistré dans Braze.

• 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