Kontextdaten und Entscheidungsanfragen context-data-decisioning

Last update: Mon Aug 25 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Entscheidungs-Management

Erstellt für:

Experte
Entwickler

Dieser Abschnitt erläutert das Übergeben von Kontextdaten in Entscheidungsanfragen und deren Verwendung in Eignungsregeln.

recommendation-more-help

Darüber hinaus können Sie auch den Kontext in Rangfolgeformeln nutzen, um Ihre Angebote zu verstärken. Detaillierte Beispiele für Rangfolgeformeln, die Kontextdaten nutzen, finden Sie in diesem Abschnitt.

style

shade-box

Übergeben von Kontextdaten in Entscheidungsanfragen

Kontextdaten in Entscheidungsanfragen werden mithilfe des Schlüssels xdm:ContextData definiert.

Kontextdatenattribute werden nicht vom XDM-Schema gesteuert. Sie können beliebige Kontextdaten in JSON als Teil der Payload der Entscheidungsanfrage übergeben.

Im Folgenden finden Sie ein Beispiel für eine Entscheidungsanfrage mit Kontextdaten (siehe xdm:ContextData):

curl --location 'https://platform-stage.adobe.io/data/core/ods/decisions' \
--header 'Accept: application/vnd.adobe.xdm+json; schema="https://ns.adobe.com/experience/offer-management/decision-response;version=1.0"' \
--header 'Content-Type: application/vnd.adobe.xdm+json; schema="https://ns.adobe.com/experience/offer-management/decision-request;version=1.0"' \
--header 'Authorization: Bearer eyJhbGciOi....' \
--header 'x-api-key: {{api_key}}' \
--header 'x-gw-ims-org-id: {{ims_org}}' \
--header 'x-sandbox-name: {{sandbox_name}}' \
--header 'x-request-id: {{$guid}}' \
--data-raw '{
    "xdm:propositionRequests": [
        {
            "xdm:activityId": "dps:offer-activity:19978bf95ebfc8fb",
            "xdm:placementId": "dps:offer-placement:199772e1c90d50ac"
        }
    ],
    "xdm:profiles": [
        {
            "xdm:identityMap": {
                "Email": [
                    {
                        "xdm:id": "test@test.com",
                        "primary": true
                    }
                ]
            },
            "xdm:contextData": [
                {
                    "@type": "_xdm.context.additionalParameters;version=1",
                    "xdm:data": {
                        "xdm:channel": "mobile",
                        "xdm:language": "en",
                        "xdm:isThirdParty": true,
                        "xdm:mobileVersion": "3.0.5106",
                        "xdm:mobileVersionMajor": "3",
                        "xdm:mobileVersionMinor": "0",
                        "xdm:mobileVersionPatch": "125",
                        "xdm:deviceType": "iOS",
                        "xdm:features": [
                            "p1000",
                            "p1001"
                        ]
                    }
                }
            ]
        }
    ],
    "xdm:allowDuplicatePropositions": {
        "xdm:acrossActivities": true,
        "xdm:acrossPlacements": true
    },
    "xdm:responseFormat": {
        "xdm:includeContent": true,
        "xdm:includeMetadata": {
            "xdm:activity": [
                "name"
            ],
            "xdm:option": [
                "name"
            ],
            "xdm:placement": [
                "name"
            ]
        }
    }
}'

Verwenden von Kontextdaten in Eignungsregeln

Im Folgenden finden Sie Beispiele, die veranschaulichen, wie Kontextdaten verwendet werden, die in Entscheidungsanfragen in Eignungsregeln übergeben werden.

Geeignet, wenn die Kontextdatenfunktionen einen bestimmten Wert enthalten:

code language-none
`select contextData from @{_xdm.context.additionalParameters;version=1} where contextData.features AND (select personetic from contextData.features where personetic.contains("123"))`

Geeignet, wenn der Kanal nicht leer und mit „Mobile“ identisch ist:

code language-none
`select contextData from @{_xdm.context.additionalParameters;version=1} where !contextData.channel.isNull() AND contextData.channel!="" AND contextData.channel="mobile"`

b22c9c5d-9208-48f4-b874-1cefb8df4d76