The FindMine Transaction Analytics Pixel is used to capture transactional data. Implementing this Pixel or API request is essential to measuring business impact and analyzing purchase data to better serve your customers.
The pixel should be implemented across all order confirmation pages on your site.
https://api.findmine.com/api/v3/analytics?event_type=transaction
Order Parameters
| Parameter | Required | Description |
|---|---|---|
application |
Yes | A unique ID identifying a specific client's traffic provided to you by your account representative. |
session_id |
Yes | Sometimes referred to as a ‘visitor id’ on the client side. If you are using a module in your PDP implementation, you must grab the _fmSession cookie to use as the session ID. |
customer_id |
Yes | A unique ID representing the customer performing the transaction - should not change for a logged-in user. It can be a hash of a customer ID corresponding to a logged in user. |
transaction_id |
Yes | A unique ID for the transaction (e.g. ABC123) |
total_price |
Yes | Total cost of the order after discounts are applied and excluding tax and shipping(e.g. 59.99) |
total_discount |
Yes | Amount discounted from the order (e.g. 5.00) |
country |
No | The site's 2-letter ISO country code (for international clients only) |
language |
No | The site's 2-letter ISO language code (for international clients only) |
currency |
No | The transaction's 3-letter ISO-4217 code for the purchase's currency (for international clients only) |
Item Parameters
For transactions containing multiple items, please use comma-separated lists for the values.
| Parameter | Required | Description |
|---|---|---|
product_ids |
Yes | Product identifier not specific to size (ex. product_ids=1,2,3) This ID must match exactly to the product ID passed into the JavaScript module and/or API, as well as the product ID sent through your product feed. This |
color_ids |
Yes | Color identifier (e.g.color_ids=blue5,blue3,blue3).This ID must match exactly to the color ID passed into the JavaScript module and/or API, as well as the color ID sent through your product feed. Not all implementations use color ID. Confirm with your FindMine account manager if your implementations uses Color ID. |
product_quantities |
Yes | Number of units bought per product |
product_prices |
Yes | Prices of the products after discount |
product_list_prices |
No | Prices of the products before discount |
If the Client is running an a/b test
| Parameter | Required | Description |
|---|---|---|
experiment_name |
Yes | The name of the experiment being run. E.g. experiment_name=page_redesign |
experiment_branch |
Yes | The name of the experiment branch the customer is in. E.g. **experiment_branch=control, experiment_branch=treatment. The specific branch names and their splits should be confirmed with your FindMine account manager. |
The preferred integration is via an image tag on your order confirmation page:
<**img**
height="1"
width="1"
style="display:none"
src="<https://api.findmine.com/api/v3/analytics?event_type=transaction&application=AB1212CDABCD-SAMPLE-APP&transaction_id=OMAW047468974&total_price=17.55&total_discount=8.45&customer_id=388828042&product_ids=101409&product_skus=23770290&product_quantities=1&product_prices=19.5&product_list_prices=26&session_id=8edaaf04-019e-4019-b97e-3797368a6b0d>"
/>