Formation is available in mParticle as both a feed integration as well as an outbound integration.
Feed Integration
You can learn how to configure a feed integration to receive events from Formation, and what those events will be, at this mParticle docs page.
Outbound Integration
To send events from mParticle to Formation, you will first need to create an API key in the Formation Platform. You can learn how to do that here.
Once you've created the API key, log into mParticle at app.mparticle.com and navigate to the directory. Search for "Formation" and click Setup > Output Event.
Name the configuration and paste the API key from the Formation platform into the apiKey text field. Click save and it should appear in your Connections pane.
Formation will begin receiving Commerce Events from mParticle. We will process product_action events with the action set as purchase.
More details are available at this mParticle docs page.
If you have any issues, questions, or requests please reach out to your CSM or support@formation.ai.
Critical Fields for Formation to successfully receive events from mParticle
Below are the purchase event fields and how Formation handles/uses them in order to successfully progress a customer's offer.
{
"user_identities": [
{
"type": "customer",
"value": "test_customer_id" // Used to determine which of your customers this event is for
}
],
"events": [
{
"type": "product_action", // Used to determine this event is a transaction & should be processed
"action": "purchase", // Used to determine this event is a transaction & should be processed
"transaction_id": "9999-999-99-20210101000000", // Used as a unique identifier - future transactions with this ID will overwrite previous ones
"total_amount": 5, // Used a transaction total spend cents (total_amount * 100)
// If missing we sum (products.total_amount * 100) for this value
"timestamp_ms": 1624490506659, // Used to calculate the transaction timestamp
"products": [
{
"id": "1", // The item's SKU in the Formation Product Catalog
"name": "foo", // Not used
"brand": "bar", // Not used; brand will be determined using the Formation Product Catalog
"category": "baz", // Not used; catalog will be determined using the Formation Product Catalog
"variant": "buzz", // Not used
"position": 1, // Not used
"price": 10, // Line item item_price in cents (price * 100)
"quantity": 0.5, // Line item item_quantity
"total_amount": 5 // Line item item_spend in cents (total_amount * 100)
"custom_attributes": [] // Not used
}
],
"custom_attributes": [] // Not used
}
]
}