Enregistrer les achats pour iOS

Enregistrez les achats réalisés via l’application afin que vous puissiez suivre vos revenus au fil du temps ainsi que les sources de revenus et segmenter vos utilisateurs par leur valeur à vie.

Braze prend en charge les achats dans plusieurs devises. Les achats que vous effectuez dans une devise autre qu’USD seront affichés dans le tableau de bord en USD en fonction du taux de change à la date à laquelle ils ont été enregistrés.

Avant la mise en œuvre, assurez-vous de consulter des exemples des options de segmentation offertes par les événements personnalisés, les attributs personnalisés et les événements d’achat dans nos meilleures pratiques, ainsi que nos notes sur les conventions de nommage des événements.

Suivi des achats et des revenus

Pour utiliser cette fonction, ajoutez cet appel de méthode après un achat réussi dans votre application :

• objective-c
• swift

1
2
3
[[Appboy sharedInstance] logPurchase:@"your product ID"
inCurrency:@"USD"
atPrice:[[[NSDecimalNumber alloc] initWithString:@"0.99"] autorelease]];

1
Appboy.sharedInstance()?.logPurchase("your product ID", inCurrency: "USD", atPrice: NSDecimalNumber(string: "0.99"))

• Les symboles de devise pris en charge sont les suivants : USD, CAD, EUR, GBP, JPY, AUD, CHF, NOK, MXN, NZD, CNY, RUB, TRY, INR, IDR, ILS, SAR, ZAR, AED, SEK, HKD, SPD, DKK, etc.
  • Tout autre symbole de devise fourni générera un avertissement enregistré et aucune autre action prise par le SDK.
• L’ID de produit peut comporter un maximum de 255 caractères
• Notez que 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 passant soit un tableau de propriétés d’événement, soit en passant un NSDictionary rempli avec des valeurs de NSNumber, NSString ou NSDate.

Consultez la documentation de la classe iOS pour plus de détails.

Ajout d’une quantité

Vous pouvez ajouter une quantité à vos achats si les clients effectuent le même achat plusieurs fois au cours d’une même commande. Vous pouvez y parvenir en transmettant un NSUInteger pour la quantité.

• La quantité saisie doit être comprise entre [0 et 100] pour que le SDK enregistre un achat.
• Les méthodes sans entrée de quantité auront une valeur de quantité égale à 1 par défaut.
• Les méthodes avec une entrée de quantité n’ont pas de valeur par défaut et doivent recevoir une entrée de quantité pour que le SDK puisse enregistrer un achat.

Reportez-vous à la documentation de la classe iOS pour plus de détails.

• objective-c
• swift

1
2
3
4
[[Appboy sharedInstance] logPurchase:@"your product ID"
inCurrency:@"USD"
atPrice:[[[NSDecimalNumber alloc] initWithString:@"0.99"] autorelease]
withProperties:@{@"key1":"value1"}];

1
Appboy.sharedInstance()?.logPurchase("your product ID", inCurrency: "USD", atPrice: NSDecimalNumber(string: "0.99"), withProperties: ["key1":"value1"])

Journaliser les achats au niveau de la commande

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

API REST

Vous pouvez également utiliser notre API REST pour enregistrer les achats. Reportez-vous à la Documentation de l’API utilisateur pour plus de détails.