DocumentazioneExperience PlatformGuida di SDK Web

Utilizzo di Offer Decisioning con Experience Platform Web SDK

Last update: Fri Apr 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

Adobe Experience Platform Web SDK può distribuire ed eseguire il rendering di offerte personalizzate gestite in Offer Decisioning. Puoi creare le offerte e altri oggetti correlati utilizzando l’interfaccia utente o le API di Offer Decisioning.

Prerequisiti

  • L’organizzazione è abilitata per le decisioni edge
  • Offerte, attività create
  • Lo stream di dati è pubblicato

Terminologia

Quando si lavora con Offer Decisioning, è importante comprendere la seguente terminologia. Per ulteriori informazioni e per visualizzare altri termini, visitare il glossario di Offer Decisioning.

  • Ambiti decisionali: Per Offer Decisioning, gli ambiti decisionali sono le stringhe con codifica Base64 di JSON contenenti gli ID di attività e posizionamento che il servizio offer decisioning deve utilizzare per proporre le offerte.

    JSON ambito decisione:

    code language-json 
    {
  "activityId":"xcore:offer-activity:11cfb1fa93381aca",
  "placementId":"xcore:offer-placement:1175009612b0100c"
}

    Stringa con codifica Base64 per ambito decisionale:

    code language-json 
    "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
    note tip
    TIP
    Puoi copiare il valore dell'ambito della decisione dalla pagina Panoramica attività nell'interfaccia utente.

    Impostazioni copia decisione.

  • Datastreams: Per ulteriori informazioni, consulta la documentazione di datastreams.

  • Identità: per ulteriori informazioni, leggere questa documentazione che illustra come Experience Platform Web SDK utilizza Identity Service.

Abilitazione di Offer Decisioning

Per abilitare Offer Decisioning, effettua le seguenti operazioni:

  1. Abilitazione di Adobe Experience Platform nello stream di dati e selezione della casella "Offer Decisioning"

    offer-decisioning-edge-config

  2. Segui le istruzioni per installare SDK (SDK può essere installato in modo autonomo o tramite l'interfaccia utente. Per ulteriori informazioni, consulta la guida rapida ai tag).

  3. Configurare SDK per Offer Decisioning utilizzando personalization.decisionScopes. Di seguito sono riportati ulteriori passaggi specifici per Offer Decisioning.

    • Installare il SDK autonomo

      1. Configurare l'azione "sendEvent" con personalization.decisionScopes
      code language-javascript 
      alloy("sendEvent", {
  ...
  "personalization": {
    "decisionScopes": [
      "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIwOWMxM2JkZDIyNCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMDZhODRkMDViMTEifQ==",
      "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIyNWI5NTUwNWIxZiIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMjFmOTQzMDE0MmIifQ=="
    ]
  }
});

    • Installare SDK tramite tag

      1. Creare una proprietà tag

      2. Aggiungi il codice di incorporamento

      3. Installa e configura l’estensione Experience Platform Web SDK con lo stream di dati creato selezionando la configurazione dal menu a discesa "Stream di dati". Consulta la documentazione sulle estensioni.

        install-aep-web-sdk-extension

        configure-aep-web-sdk-extension

      4. Creare gli elementi dati necessari. È necessario creare almeno una mappa identità di Experience Platform Web SDK e un elemento dati Experience Platform Web SDK XDM Object.

        identity-map-data-element

        xdm-object-data-element

      5. Crea le regole.

        • Aggiungi un'azione Invia evento di Experience Platform Web SDK e aggiungi decisionScopes alla configurazione di tale azione

        send-event-action-decisionScopes

      6. Crea e pubblica una libreria contenente tutte le regole, gli elementi dati e le estensioni pertinenti che hai configurato

Richieste di esempio e risposte

Un valore decisionScopes

Richiesta

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
          ]
        }
      }
    }
  ]
}
Proprietà
Obbligatorio
Descrizione
Limiti
Esempio
identityMap
Sì
Consulta questa documentazione del servizio Identity.
Un’identità per richiesta.
{ "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }.

Nota: gli utenti non devono includere il parametro ECID nella chiamata API. Se necessario, questo parametro viene aggiunto automaticamente alla chiamata.
decisionScopes
Sì
Array di stringhe JSON con codifica Base64 contenenti gli ID di attività e posizionamento.
Massimo 30 decisionScopes per richiesta.
"decisionScopes": ["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="]

Risposta

{
  "requestId": "94c4f2f1-9218-43ce-afd3-eb0d853c5174",
  "handle": [
    {
      "payload": [
        {
          "id": "2862bb89-5df2-4bc6-85c2-d8f7e1a091de",
          "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
          "activity": {
            "id": "xcore:offer-activity:11cfb1fa93381aca",
            "etag": "2"
          },
          "placement": {
            "id": "xcore:offer-placement:1175009612b0100c",
            "etag": "1"
          },
          "items": [
            {
              "id": "xcore:personalized-offer:124cc332095cfa74",
              "schema": "https://ns.adobe.com/experience/offer-management/content-component-html",
              "etag": "1",
              "data": {
                "id": "xcore:personalized-offer:124cc332095cfa74",
                "format": "text/html",
                "language": [
                  "en-US"
                ],
                "content": "<p>20% Off on shipping</p>",
                "characteristics": {
                  "foo": "bar",
                  "foo1": "bar1"
                }
              }
            }
          ]
        }
      ],
      "type": "personalization:decisions",
      "eventIndex": 0
    }
  ]
}
Proprietà
Descrizione
Esempio
scope
Ambito della decisione che ha portato alle offerte proposte.
"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id
ID univoco dell’attività di offerta.
"id": "xcore:offer-activity:11cfb1fa93381aca"
placement.id
ID univoco del posizionamento dell’offerta.
"id": "xcore:offer-placement:1175009612b0100c"
items.id
ID dell’offerta proposta.
"id": "xcore:personalized-offer:124cc332095cfa74"
schema
Schema del contenuto associato all’offerta proposta.
"schema": "https://ns.adobe.com/experience/offer-management/content-component-html"
data.id
ID dell’offerta proposta.
"id": "xcore:personalized-offer:124cc332095cfa74"
format
Il formato del contenuto associato all’offerta proposta.
"format": "text/html"
language
Un array di lingue associate al contenuto dell’offerta proposta.
"language": [ "en-US" ]
content
Contenuto associato all’offerta proposta sotto forma di stringa.
"content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl
Contenuto immagine associato all’offerta proposta sotto forma di URL.
"deliveryURL": "https://image.jpeg"
characteristics
Caratteristiche associate all’offerta proposta nel formato di un oggetto JSON.
"characteristics": { "foo": "bar", "foo1": "bar1" }

Più valori decisionScopes

Richiesta

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyYzkxMzg1Mjc2MDE4YyIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMzMxZjU2MTYyYWEyZjcifQ=="
          ]
        }
      }
    }
  ]
}
Proprietà
Obbligatorio
Descrizione
Limiti
Esempio
identityMap
Sì
Consulta questa documentazione del servizio Identity.
Un’identità per richiesta.
{ "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }.

Nota: gli utenti non devono includere il parametro ECID nella chiamata API. Se necessario, questo parametro viene aggiunto automaticamente alla chiamata.
decisionScopes
Sì
Array di stringhe JSON con codifica Base64 contenenti gli ID di attività e posizionamento.
Massimo 30 decisionScopes per richiesta.
"decisionScopes":["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==", "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ=="

Risposta

{
  "requestId": "94c4f2f1-9218-43ce-afd3-eb0d853c5174",
  "handle": [
    {
      "payload": [
        {
          "id": "a2804dfb-a0ec-4df9-8311-59d3ecdeb642",
          "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MTEyMyIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDExMjMifQ==",
          "activity": {
            "id": "xcore:offer-activity:11cfb1fa93381123",
            "etag": "1"
          },
          "placement": {
            "id": "xcore:offer-placement:1175009612b01123",
            "etag": "3"
          },
          "items": [
            {
              "id": "xcore:personalized-offer:11e36d4a22954123",
              "schema": "https://ns.adobe.com/experience/offer-management/content-component-text",
              "etag": "2",
              "data": {
                "id": "xcore:personalized-offer:11e36d4a22954123",
                "format": "text/text",
                "language": [
                  "en"
                ],
                "content": "20% Off on shipping",
                "characteristics": {
                  "foo2": "bar2"
                }
              }
            }
          ]
        },
        {
          "id": "a2804dfb-a0ec-4df9-8311-59d3ecdeb642",
          "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
          "activity": {
            "id": "xcore:offer-activity:11cfb1fa93381aca",
            "etag": "2"
          },
          "placement": {
            "id": "xcore:offer-placement:1175009612b0100c",
            "etag": "1"
          },
          "items": [
            {
              "id": "xcore:personalized-offer:11e36d4a2295415d",
              "schema": "https://ns.adobe.com/experience/offer-management/content-component-imagelink",
              "etag": "1",
              "data": {
                "id": "xcore:personalized-offer:11e36d4a2295415d",
                "format": "image/png",
                "language": [
                  "en"
                ],
                "deliveryURL": "https://image.jpeg",
                "characteristics": {
                  "foo": "bar",
                  "foo1": "bar1"
                }
              }
            }
          ]
        }
      ],
      "type": "personalization:decisions",
      "eventIndex": 0
    }
  ]
}
Proprietà
Descrizione
Esempio
scope
Ambito della decisione che ha portato alle offerte proposte.
"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id
ID univoco dell’attività di offerta.
"id": "xcore:offer-activity:11cfb1fa93381123"
placement.id
ID univoco del posizionamento dell’offerta.
"xcore:offer-placement:1175009612b01123"
items.id
ID dell’offerta proposta.
"id": "xcore:personalized-offer:11e36d4a22954123"
schema
Schema del contenuto associato all’offerta proposta.
"schema": "https://ns.adobe.com/experience/offer-management/content-component-text"
data.id
ID dell’offerta proposta.
"id": "xcore:personalized-offer:11e36d4a22954123"
format
Il formato del contenuto associato all’offerta proposta.
"format": "text/text"
language
Un array di lingue associate al contenuto dell’offerta proposta.
"language": [ "en-US" ]
content
Contenuto associato all’offerta proposta sotto forma di stringa.
"content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl
Contenuto immagine associato all’offerta proposta sotto forma di URL.
"deliveryURL": "https://image.jpeg"
characteristics
Caratteristiche associate all’offerta proposta nel formato di un oggetto JSON.
"characteristics": { "foo": "bar", "foo1": "bar1" }

Limitazioni

Alcuni vincoli di offerta non sono attualmente supportati con i flussi di lavoro mobili di Edge Network, ad esempio il limite. Il valore del campo Limite specifica quante volte un’offerta può essere presentata a tutti gli utenti. Per ulteriori dettagli, consulta Documentazione su regole e vincoli di idoneità per le offerte.

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636