Creare un’offerta personalizzata create-personalized-offer

Un’offerta personalizzata è un messaggio di marketing personalizzabile basato su regole e vincoli di idoneità.

Per creare un’offerta personalizzata, devi effettuare una richiesta POST al Offer Library API.

Intestazioni Accept e Content-Type accept-and-content-type-headers

La tabella seguente mostra i valori validi che compongono Content-Type nell’intestazione della richiesta:

Nome intestazione
Valore
Content-Type
application/json

Formato API

POST /{ENDPOINT_PATH}/offers/{ID}?offer-type=personalized
Parametro
Descrizione
Esempio
{ENDPOINT_PATH}
Percorso endpoint per le API di persistenza.
https://platform.adobe.io/data/core/dps/

Richiesta

curl -X POST 'https://platform.adobe.io/data/core/dps/offers?offer-type=personalized' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
    "name": "Test personalized offer with frequency constraint",
    "status": "draft",
    "representations": [
        {
            "channel": "https://ns.adobe.com/xdm/channel-types/web",
            "placement": "offerPlacement1234",
            "components": [
                {
                    "type": "html",
                    "format": "text/html",
                    "language": [
                        "en-us"
                    ],
                    "content": "Hello You qualify for our Discount of 60%"
                }
            ]
        }
    ],
    "selectionConstraint": {
        "startDate": "2022-07-27T05:00:00.000+00:00",
        "endDate": "2023-07-29T05:00:00.000+00:00",
        "profileConstraintType": "none"
    },
    "rank": {
        "priority": 0
    },
    "cappingConstraint": {},
    "frequencyCappingConstraints": [
        {
            "enabled": false,
            "limit": 1,
            "startDate": "2023-05-15T14:25:49.622+00:00",
            "endDate": "2023-05-25T14:25:49.622+00:00",
            "scope": "global",
            "entity": "offer",
            "repeat": {
                "enabled": false,
                "unit": "month",
                "unitCount": 1
            }
        }
    ]
}'

Risposta

In caso di esito positivo, la risposta restituisce i dettagli dell’offerta personalizzata appena creata, incluso l’ID. È possibile utilizzare id nei passaggi successivi per aggiornare o eliminare l’offerta personalizzata.

{
    "etag": 1,
    "createdBy": "{CREATED_BY}",
    "lastModifiedBy": "{MODIFIED_BY}",
    "id": "{ID}",
    "sandboxId": "{SANDBOX_ID}",
    "createdDate": "2023-05-31T15:09:11.771Z",
    "lastModifiedDate": "2023-05-31T15:09:11.771Z",
    "createdByClientId": "{CREATED_CLIENT_ID}",
    "lastModifiedByClientId": "{MODIFIED_CLIENT_ID}"
}

Limitazioni limitations

Le rappresentazioni di offerta e alcuni vincoli di offerta non sono attualmente supportati con il dispositivo mobile Experience Edge flussi di lavoro, ad esempio Capping. Il Capping Il valore del campo specifica quante volte un’offerta può essere presentata a tutti gli utenti. Per ulteriori dettagli, consulta Documentazione su regole di idoneità e vincoli per le offerte.

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