Skip to content

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.

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. Pour en savoir plus sur la conversion dans le tableau de bord, la mise en cache et l’actualisation des taux de change, consultez Conversion de devises. Pour éviter toute conversion, enregistrez les achats avec USD comme code de devise.

Enregistrer les achats et les 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.

Pour un déploiement standard du SDK Web, vous pouvez utiliser la méthode suivante :

1

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

Si vous préférez utiliser Google Tag Manager, vous pouvez utiliser le type d’étiquette Purchase pour appeler la méthode logPurchase. Utilisez cette étiquette pour suivre les achats dans Braze, en incluant éventuellement des propriétés d’achat. Pour ce faire :

  1. Les champs Product ID et Price sont obligatoires.
  2. Utilisez le bouton Add Row pour ajouter des propriétés d’achat.

Une boîte de dialogue affichant les paramètres de configuration de l'étiquette d'action Braze. Les paramètres incluent « tag type », « external ID », « price », « currency code », « quantity » et « purchase properties ».

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

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.

Pour un déploiement standard du SDK Web, vous pouvez utiliser la méthode suivante :

1

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

Si votre site enregistre les achats en utilisant l’élément de couche de données d’événement eCommerce standard vers Google Tag Manager, vous pouvez utiliser le type d’étiquette E-commerce Purchase. Ce type d’action enregistrera un « achat » distinct dans Braze pour chaque article envoyé dans la liste items.

Vous pouvez également spécifier des noms de propriétés supplémentaires à inclure en tant que propriétés d’achat en indiquant leurs clés dans la liste des propriétés d’achat. Notez que Braze recherchera dans l’item individuel en cours d’enregistrement toutes les propriétés d’achat que vous avez ajoutées à la liste.

Par exemple, avec le payload eCommerce suivant :

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
}]

Si vous souhaitez uniquement transmettre item_brand et item_name en tant que propriétés d’achat, ajoutez simplement ces deux champs au tableau des propriétés d’achat. Si vous ne fournissez aucune propriété, aucune propriété d’achat ne sera envoyée dans l’appel logPurchase à Braze.

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. Cependant, 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 des achats. Pour plus d’informations, consultez les endpoints de données utilisateur.

Enregistrer les 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 la commande comme product_id. Consultez notre spécification de l’objet d’achat pour en savoir plus.

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 de devises suivants. Tout autre symbole de devise que vous fournissez enregistre 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
New Stuff!