Track transactions

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 (number, mandatory)
• Currency (CurrencyCode or string, mandatory)
• Transaction ID (string, optional)

The plugin defines a TransactionItem type to prevent potential typing errors.

import { ContentsquareCDVPlugin, CurrencyCode, TransactionItem } from '@contentsquare/cordova-plugin-types';

declare var ContentsquarePlugin: ContentsquareCDVPlugin;

const myTransaction: TransactionItem = {
      transactionValue: 10.99,
      transactionCurrency: CurrencyCode.USD,
      transactionId: 'my_transaction_id',
};

ContentsquarePlugin.sendTransaction(myTransaction, (result) => {
  // Success
}, (err) => {
    // Handle Error
});

The currency is conforming to the ISO 4217 ↗ standard. Although the currency can be passed as "alphanumeric code", you should always prefer using the plugin's CurrencyCode object values. If you have to pass the ISO code as a string, capitalization is not a factor ("USD", "Usd" or "usd" will all be treated as the US Dollar).

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