Moloco Commerce Media

Datafly Signal sends retail-media user events to Moloco Commerce Media (MCM) server-to-server through the User Event API, so Moloco can attribute and optimise sponsored-product ads.

Why route Moloco Commerce Media through Datafly Signal

Conversions survive ad blockers and tracking prevention. A browser tag served from an advertising domain is blocked outright for part of your traffic, and Safari’s ITP shortens the cookies it can set. Signal sends the event from your own server, so what Moloco Commerce Media receives is not filtered by the browser.
One consent decision governs every destination. Moloco Commerce Media is gated by the same consent state as the rest of your stack, so a withdrawal applies everywhere at once.
No vendor tag on the page. Removing it removes its page weight and its independent access to your visitors.

Prerequisites

Get your platform details

Your Moloco representative provides the platform name (the event host is <platform name>-evt.mcm-api.moloco.com) and the platform ID.

Create an API key

Create the User Event API key in the Moloco Portal credentials section.

Use the same IDs in the Decision API

Signal sends the user ID and visitor ID as SHA-256 hashes, as Moloco recommends. Your Decision API calls must use the same hashed values.

Configure in Signal

Configuration Fields

Field	Required	Description
`platform_name`	Yes	Your Moloco Commerce Media platform name, the first part of the event API host (<platform name>-evt.mcm-api.moloco.com). Provided by your Moloco representative with the platform ID.
`platform_id`	Yes	Your Moloco Commerce Media platform ID, part of the User Event API path (/rmp/event/v1/platforms/<platform ID>/userevents). Provided by your Moloco representative.
`api_key`	Yes	The User Event API key from the Moloco Portal credentials section. Sent as the X-API-Key header.
`event_token`	No	Not used: the Moloco Commerce Media User Event API authenticates with the API key only. Retained so existing configurations still load.

Management UI Setup

Go to Integrations > Add Integration > Moloco Commerce Media.
Choose a preset: Default (default), Retail (ecommerce).
Fill in the fields above and click Save.

Request format

One event per request. Items carry a Money price (currency and amount) and PURCHASE carries revenue.

POST https://{platform_name}-evt.mcm-api.moloco.com/rmp/event/v1/platforms/{platform_id}/userevents

{
 "channel_type": "SITE",
 "device": {
  "language": "en",
  "persistent_id": "1b67d6af59c6bf7d0501fc1d88bf9f95c00995a26f63518364153224c8141635",
  "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
 },
 "event_type": "PURCHASE",
 "id": "evt-e2-1",
 "items": [
  {
   "id": "SKU_1",
   "price": {
    "amount": 120,
    "currency": "GBP"
   },
   "quantity": 2
  },
  {
   "id": "SKU_2",
   "price": {
    "amount": 19.99,
    "currency": "GBP"
   },
   "quantity": 1
  }
 ],
 "revenue": {
  "amount": 259.99,
  "currency": "GBP"
 },
 "timestamp": 1758500000123,
 "user_id": "d2863329af6d3300c06cca11c621a6854dce32e06c217fe09ae25687dc4573a8"
}

Event Mapping

Signal event	Vendor event	Presets
`page`	`PAGE_VIEW`	Default, Retail
`search`	`SEARCH`	Default, Retail
`view_item`	`ITEM_PAGE_VIEW`	Default, Retail
`add_to_cart`	`ADD_TO_CART`	Default, Retail
`add_to_wishlist`	`ADD_TO_WISHLIST`	Default, Retail
`purchase`	`PURCHASE`	Default, Retail

Items are required for ITEM_PAGE_VIEW, ADD_TO_CART, ADD_TO_WISHLIST and PURCHASE, page_id (the page path) for PAGE_VIEW and search_query for SEARCH; an event without them is not sent.

Signal forwards event properties the preset does not map unless the integration’s strict output contract is on. Turn on strict_output_contract for this integration so only the documented fields are sent.

Identity

user_id (the signed-in user ID) and device.persistent_id (the Signal visitor ID) are SHA-256 hashes. User agent and language are sent in device. No email is sent: the API has no email field.

Moloco Commerce Media is an advertising destination and requires marketing consent by default.

Known limitations

Moloco accepts 25 currencies (USD, GBP, EUR and others); an event in another currency is rejected.

Blueprint

The Moloco Commerce Media blueprint version is 0.6.0. It was last reviewed against the vendor’s documentation on 2026-09-22.