DocumentationJourney OptimizerJourney Optimizer Guide

Configure data collection schema-requirements

Last update: Thu Dec 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Applies to:
  • Journey Orchestration

CREATED FOR:

  • Experienced
  • Developer

To be able to get feedback on event types other than decision events, you must set the correct value for each event type in an experience event that is sent into Adobe Experience Platform.

CAUTION
For each event type, make sure the schema used in the dataset has the Experience Event - Proposition Interactions field group associated with it.

Below are the schema requirements you need to implement into your JavaScript code.

Track impressions track-impressions

Make sure the following fields are configured correctly:

Experience event type: decisioning.propositionDisplay

propositionEventType: _experience.decisioning.propositionEventType.display

Source: Web.sdk/Alloy.js (sendEvent command -> xdm : {eventType, interactionMixin}) or batch ingestion

Sample payload:
code language-json 
{
  "_experience": {
    "decisioning": {
      "propositionEventType": {
        "display": 1
      },
      "proposition": [
        {
          "items": [
            {
              "itemSelection": {
                "rankingDetail": {
                  "algorithmID": "RANDOM",
                  "strategyID": "1YYKhS4MImWqIBrpudMIf4",
                  "trafficType": "random",
                  "step": "aiModel"
                },
                "selectionDetail": {
                  "selectionType": "selectionStrategy",
                  "strategyName": "not a real selection strategy",
                  "strategyID": "dps:selection-strategy:1b630b32da42125a",
                  "version": "35a6b5b1-62ff-4a4b-94cd-96852a59d89a"
                }
              },
              "name": "not a real offer",
              "id": "dps:14c7468e7f6271ff8023748a1146d11f05f77b7fc1368081:1b630a7d8d9f2g4j",
              "score": 0.9765416360350985
            }
          ],
          "scopeDetails": {
            "decisionPolicy": {
              "id": "01c3ad3d-6d41-4013-a88f-5a4975579179"
            },
            "decisionProvider": "EXD",
            "placement": {
              "id": "a99d6b1e-5930-4ba6-hd64-17a14bb15032#farouk-img-test"
            },
            "correlationID": "28ca161e-552c-464e-dh37-bc38d4ce944b-0"
          },
          "scope": "a99d6b1e-5930-4ba6-hd64-17a14bb15032#farouk-img-test",
          "id": "86fb8f37-0498-4533-9dab-c206690c1f67"
        }
      ],
      "exdRequestID": "edb61199-ef92-46c8-adc5-f622df5b9078"
    }
  },
  "eventType": "decisioning.propositionDisplay",
  "_id": "04b5384e-c09c-4df8-b6f0-7c476a51b219",
  "timestamp": "2025-10-07T20:22:00Z"
}

Track clicks track-clicks

Make sure the following fields are configured correctly:

Experience event type: decisioning.propositionInteract

propositionEventType: _experience.decisioning.propositionEventType.interact

Source: Web.sdk/Alloy.js (sendEvent command -> xdm : {eventType, interactionMixin}) or batch ingestion

Each offer within a proposition includes a tracking token, which is a unique identifier generated by Adobe. This token must be passed exactly as received — without alteration — in the corresponding click or impression event. Matching tracking tokens ensure that Adobe can precisely associate the user action with the correct offer decision, enabling downstream reporting and AI-based optimization.

CAUTION
If you do not pass the tracking token in the propositionAction.tokens field when tracking clicks, the click events will not be properly attributed to the corresponding offer. This will result in incomplete tracking data and will negatively impact reporting and AI-based ranking optimization. Always ensure that you include the tracking token from the proposition in your click tracking implementation.
Sample payload:
code language-json 
{
  "_experience": {
    "decisioning": {
      "propositionEventType": {
        "interact": 1
      },
      "propositionAction": {
        "tokens": [
          "Vx9fwWXmp6/kyYRVOUZWEQ"
        ]
      },
      "proposition": [
        {
          "items": [
            {
              "itemSelection": {
                "rankingDetail": {
                  "algorithmID": "RANDOM",
                  "strategyID": "1YYKhS4MImWqIBrpudMIf4",
                  "trafficType": "random",
                  "step": "aiModel"
                },
                "selectionDetail": {
                  "selectionType": "selectionStrategy",
                  "strategyName": "not a real selection strategy",
                  "strategyID": "dps:selection-strategy:1b630b32da42125a",
                  "version": "35a6b5b1-62ff-4a4b-94cd-96852a59d89a"
                }
              },
              "name": "not a real offer",
              "id": "dps:14c7468e7f6271ff8023748a1146d11f05f77b7fc1368081:1b630a7d8d9f2g4j",
              "score": 0.9765416360350985
            }
          ],
          "scopeDetails": {
            "decisionPolicy": {
              "id": "01c3ad3d-6d41-4013-a88f-5a4975579179"
            },
            "decisionProvider": "EXD",
            "placement": {
              "id": "a99d6b1e-5930-4ba6-hd64-17a14bb15032#farouk-img-test"
            },
            "correlationID": "28ca161e-552c-464e-dh37-bc38d4ce944b-0"
          },
          "scope": "a99d6b1e-5930-4ba6-hd64-17a14bb15032#farouk-img-test",
          "id": "86fb8f37-0498-4533-9dab-c206690c1f67"
        }
      ],
      "exdRequestID": "edb61199-ef92-46c8-adc5-f622df5b9078"
    }
  },
  "eventType": "decisioning.propositionInteract",
  "_id": "04b5384e-c09c-4df8-b6f0-7c476a51b765",
  "timestamp": "2025-10-07T20:50:00Z"
}

Track custom events track-custom-events

For custom events, the schema used in the dataset must also have the Experience Event - Proposition Interactions field group associated with it, but there is no specific requirement on the experience event type that must be used to tag these events.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76