Creare un’offerta personalizzata

Ultimo aggiornamento: 2023-12-29
  • Argomenti:
  • Decision Management
    Visualizza ulteriori informazioni su questo argomento
  • API
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Experienced
    Developer

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 , fornendo al tempo stesso l'ID contenitore.

Intestazioni Accept e Content-Type

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

Nome intestazione Valore
Accetta application/vnd.adobe.platform.xcore.xdm.receipt+json; version=1
Content-Type application/schema-instance+json; version=1; schema="https://ns.adobe.com/experience/offer-management/personalized-offer;version=0.5"

Formato API

POST /{ENDPOINT_PATH}/{CONTAINER_ID}/instances
Parametro Descrizione Esempio
{ENDPOINT_PATH} Percorso dell’endpoint per le API dell’archivio. https://platform.adobe.io/data/core/xcore/
{CONTAINER_ID} Il contenitore in cui si trovano le offerte personalizzate. e0bd8463-0913-4ca1-bd84-6309134ca1f6

Richiesta

curl -X POST \
  'https://platform.adobe.io/data/core/xcore/e0bd8463-0913-4ca1-bd84-6309134ca1f6/instances' \
  -H 'Accept: application/vnd.adobe.platform.xcore.xdm.receipt+json; version=1' \
  -H 'Content-Type: application/schema-instance+json; version=1;  schema="https://ns.adobe.com/experience/offer-management/personalized-offer;version=0.5"' \
-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 '{
        "xdm:name": "Sale offer",
        "xdm:status": "draft",
        "xdm:representations": [
        {
                "xdm:components": [
                {
                        "dc:language": [
                            "en"
                    ],
                        "@type": "https://ns.adobe.com/experience/offer-management/content-component-html",
                        "dc:format": "text/html"
                }
                ],
                "xdm:placement": "xcore:offer-placement:124e0be5699743d3"
        }
    ],
        "xdm:selectionConstraint": {
            "xdm:startDate": "2020-10-01T16:00:00Z",
            "xdm:endDate": "2021-12-13T16:00:00Z",
            "xdm:eligibilityRule": "xcore:eligibility-rule:124e0faf5b8ee89b"
        },
        "xdm:rank": {
            "xdm:priority": 1
    },
        "xdm:cappingConstraint": {
            "xdm:globalCap": 150
    },
        "xdm:tags": [
            "xcore:tag:124e147572cd7866"
    ]
}'

Risposta

In caso di esito positivo, la risposta restituisce informazioni sull’offerta personalizzata appena creata, tra cui l’ID istanza e il posizionamento univoci @id. Puoi utilizzare l’ID istanza nei passaggi successivi per aggiornare o eliminare l’offerta personalizzata.

{
    "instanceId": "0f4bc230-13df-11eb-bc55-c11be7252432",
    "@id": "xcore:personalized-offer:124e181c8b0d7878",
    "repo:etag": 1,
    "repo:createdDate": "2020-10-21T20:50:32.018624Z",
    "repo:lastModifiedDate": "2020-10-21T20:50:32.018624Z",
    "repo:createdBy": "{CREATED_BY}",
    "repo:lastModifiedBy": "{MODIFIED_BY}",
    "repo:createdByClientId": "{CREATED_CLIENT_ID}",
    "repo:lastModifiedByClientId": "{MODIFIED_CLIENT_ID}"
}

Limitazioni

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.

In questa pagina