Track transactions

Last updated Mar 11, 2026View as Markdown

This SDK mainly receives critical fixes. New capabilities are shipping in the CSQ SDK first.

Migrate to the CSQ SDK using our AI wizard.

To associate a user's session with their potential purchases (and corresponding revenue), you must send the transaction via a dedicated API. For each transaction, we send:

Price (mandatory)
Currency (mandatory)
Transaction ID (optional)

Swift
Objective-C

// numeric currency
// CustomerTransaction(id: String?, value: Float, currency: Currency)
let transaction = CustomerTransaction(id: "transaction_id", value: 430.99, currency: Currency.eur)
Contentsquare.send(transaction: transaction)

// alphanumeric currency
// CustomerTransaction(id: String?, value: Float, currency: String)
let transaction = CustomerTransaction(id: "transaction_id", value: 430.99, currency: "EUR")
Contentsquare.send(transaction: transaction)

// numeric currency
CustomerTransaction *transaction = [[CustomerTransaction alloc] initWithId:@"transaction_id"
                                                                    value:430.99
                                                                  currency:CurrencyEur];
[Contentsquare sendWithTransaction:transaction];

// alphanumeric currency
CustomerTransaction *transaction = [[CustomerTransaction alloc] initWithId:@"transaction_id"
                                                                    value:430.99
                                                            stringCurrency:"EUR"];
[Contentsquare sendWithTransaction:transaction];

Currency

The currency is conforming to the ISO 4217 ↗ standard. The currency can be passed either as "alphanumeric code" or "numeric code".

If the currency passed doesn't match the supported currencies, the SDK will send a currency value of -1. It will be processed as the default currency of the project.