Pages

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from this space and version 5.10

...

For an introduction to conversions and conversion tracking in the Frosmo Platform, see Technical overview and Conversion tracking and attributionsee Introduction to conversion tracking.

For a transaction tracking example that uses the data layer from a modification, see Example: Recommending products purchased together.

Triggering conversion events

...

PropertyDescriptionTypeRole
conversionId

Conversion ID.

If you're tracking a product conversion, use the product ID as the conversion ID. The product ID is the same value you pass in the frosmoProductId property of a product object when tracking products.

Note

If you're tracking a product conversion, and if you do not use the product ID as the conversion ID, the platform has no way of mapping the conversion to the corresponding product in the Frosmo database. For example, if you wanted to create a product recommendation based on the conversions, the recommendation engine would not be able to automatically map the conversions to products and would therefore fail to return the product data for the conversions.


String (128)Required
conversionType

Conversion type.

If you're tracking a product conversion, use the product type as the conversion type. The product type is the same value you pass in the frosmoProductCategory property of a product object.

String (128)Required
conversionValue

Monetary value of the conversion (in the currency set for your site).

If you're tracking a product conversion, this property should not reflect the product price, but rather some other monetary value associated with the conversion, as this property does not map to any product data. If you want to track a purchase-based product conversion, use a transaction object instead.

NumberRequired
frosmoConversionName

Conversion description.

If you're tracking a product conversion, use the product name as the conversion description. The product name is the same value you pass in the frosmoProductName property of a product object.

String (128)Required

...

You track transactions to determine which products visitors purchase, how much revenue those purchases generate, and which modifications drive the purchases. You can use the tracking data to, for example, implement product recommendations. If you want to track non-purchase product conversions, use the conversion object.

...

PropertyDescriptionTypeRole
id

Product ID.

The product ID is the same value you pass in the frosmoProductId property of a product object when tracking products.

Note

If you do not use the product ID as the property value, the platform has no way of mapping the purchased product to the corresponding product in the Frosmo database. For example, if you wanted to create a product recommendation based on the transactions, the recommendation engine would not be able to automatically map the purchased products to tracked products and would therefore fail to return the product data for the transactions.

This property is optional if name or sku is defined. You must define at least one of the three.

String (128)Required/Optional
name

Product name.

The product name is the same value you pass in the frosmoProductName property of a product object when tracking products.

This property is optional if id or sku is defined. You must define at least one of the three.

String (128)Required/Optional
priceUnit price used for the product in the transaction.NumberRequired
quantityNumber of items purchased in the transaction.NumberOptional
sku

Stock keeping unit (SKU) code for the product.

This property is optional if id or name is defined. You must define at least one of the three.

String (128)Required/Optional

...