Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction,
ouvrez un ticket sur GitHub.
Enregistrer les achats
Apprenez à enregistrer les achats in-app via le SDK de 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 en utilisant des événements personnalisés, des attributs personnalisés et des événements d’achat.
note:
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, veuillez définir la devise en USD.
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é sur Braze.
Pour une implémentation standard du SDK Web, vous pouvez utiliser la méthode suivante :
1
| braze.logPurchase(product_id, price, "USD", quantity);
|
Si vous souhaitez utiliser Google Tag Manager à la place, vous pouvez utiliser le type d’étiquette Purchase pour appeler la méthodelogPurchase . Utilisez cette balise pour suivre les achats avec Braze, y compris, en option, les propriétés d’achat. Pour ce faire :
- Les champs ID produit et Prix sont obligatoires.
- Utilisez le bouton Ajouter une ligne pour ajouter des propriétés d’achat.

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));
|
warning:
productID ne peut contenir plus de 255 caractères. En outre, 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 les valeurs Int, Double, String, Bool ou Date.
Pour une implémentation 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 à l’aide de l’élément de couche de données d’événement e-commerce standard dans Google Tag Manager, vous pouvez utiliser le type d’étiquette E-commerce Purchase. Ce type d’action enregistre un « achat » séparé dans Braze pour chaque article envoyé dans la liste de items.
Vous pouvez également préciser les noms supplémentaires des propriétés que vous souhaitez inclure comme propriétés d’achat en spécifiant leurs clés dans la liste des Propriétés d’achat. Veuillez remarquer que Braze observe la personne item qui est enregistrée pour toute propriété d’achat que vous ajoutez à la liste.
Par exemple, si l’on considère la charge utile suivante pour le commerce électronique :
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 transmettre uniquementitem_brand et item_name comme propriétés d’achat, il vous suffit d’ajouter ces deux champs au tableau des propriétés d’achat. Si vous ne fournissez pas de propriétés, aucune propriété d’achat ne sera envoyée dans l’appel à Braze. 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);
|
Ajout d’une quantité
Par défaut, quantity est défini comme 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 l’API REST
Vous pouvez également utiliser notre API REST pour enregistrer les achats. Pour plus d’informations, reportez-vous aux 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, reportez-vous aux spécifications de l’objet de l’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