DocumentatieExperience PlatformHandleiding voor Web SDK

Offer Decisioning gebruiken met de Experience Platform Web SDK

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Adobe Experience Platform Web SDK kan persoonlijke aanbiedingen die in Offer Decisioning worden beheerd, aanbieden en weergeven. U kunt uw aanbiedingen en andere verwante objecten maken met de gebruikersinterface (UI) of API's van Offer Decisioning.

Vereisten

  • Organisatie is ingeschakeld voor randbesluitvorming
  • Aanbiedingen, gemaakte activiteiten
  • DataStream wordt gepubliceerd

Terminologie

Het is belangrijk dat u de volgende terminologie begrijpt wanneer u met Offer Decisioning werkt. Voor meer informatie en om extra termijnen te bekijken, gelieve de ​ verklarende woordenlijst van Offer Decisioning ​ te bezoeken.

  • Scopes van het Besluit: voor Offer Decisioning, zijn het besluitvormingswerkingsgebied Base64 gecodeerde koorden van JSON die de activiteit en plaatsings IDs bevatten u de dienst van de aanbiedingsbeslissing wilt gebruiken om aanbiedingen voor te stellen.

    werkingsgebied JSON van het Besluit:

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

    het werkingsgebied Base64 van het Besluit gecodeerde koord:

    code language-json 
    "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
    note tip
    TIP
    U kunt de waarde van het besluitvormingswerkingsgebied van de pagina van het Overzicht van de Activiteit in UI kopiëren.

    montages van het Beslissingsexemplaar.

  • Datastreams: voor meer informatie, te lezen gelieve de ​ gegevensstromen ​ documentatie.

  • Identiteit: Voor meer informatie, te lezen gelieve deze documentatie die schetst hoe ​ Experience Platform Web SDK de Dienst van de Identiteit ​ gebruikt.

Offer Decisioning inschakelen

Voer de volgende stappen uit om Offer Decisioning in te schakelen:

  1. Toegelaten Adobe Experience Platform in uw ​ datastream ​ en controleer de "Offer Decisioning"doos

    aanbod-besluit-rand-config

  2. Volg de instructies om ​ SDK ​ te installeren (SDK kan standalone of door UI worden geïnstalleerd. Zie de ​ snel begingids van markeringen ​) voor meer informatie.

  3. Configureer de SDK for Offer Decisioning met personalization.decisionScopes . Hieronder vindt u aanvullende specifieke Offer Decisioning-stappen.

    • De zelfstandige SDK installeren

      1. De handeling "sendEvent" configureren met personalization.decisionScopes
      code language-javascript 
      alloy("sendEvent", {
  ...
  "personalization": {
    "decisionScopes": [
      "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIwOWMxM2JkZDIyNCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMDZhODRkMDViMTEifQ==",
      "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIyNWI5NTUwNWIxZiIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMjFmOTQzMDE0MmIifQ=="
    ]
  }
});

    • De SDK installeren via tags

      1. Een tag-eigenschap maken

      2. ​ voeg de ingebedde code ​ toe

      3. Installeer en configureer de Experience Platform Web SDK-extensie met de DataStream die u hebt gemaakt door de configuratie te selecteren in het vervolgkeuzemenu "DataStream". Zie de documentatie op ​ uitbreidingen ​.

        install-a-web-sdk-uitbreiding

        vorm-sep-web-sdk-uitbreiding

      4. Creeer de noodzakelijke ​ Elementen van Gegevens ​. Bij het absolute minimum, moet u een de Identiteitskaart van Experience Platform Web SDK en een het gegevenselement van de Objecten van SDK XDM van het Web van Experience Platform tot stand brengen.

        identiteit-kaart-gegeven-element

        xdm-voorwerp-gegeven-element

      5. Creeer uw ​ Regels ​.

        • Voeg een Experience Platform Web SDK Send Event-actie toe en voeg de relevante decisionScopes toe aan de configuratie van die actie

        send-event-action-DecisionScopes

      6. ​ creeer en publiceer een bibliotheek ​ die alle relevante Regels, Elementen van Gegevens, en Uitbreidingen bevat u hebt gevormd

Voorbeeldverzoeken en -antwoorden

Eén decisionScopes -waarde

Verzoek

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
          ]
        }
      }
    }
  ]
}
Eigenschap
Vereist
Beschrijving
Limieten
Voorbeeld
identityMap
Ja
Verwijs naar deze ​ documentatie van de Dienst van de Identiteit ​.
Eén identiteit per aanvraag.
{ "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }.

Opmerking: gebruikers hoeven de parameter ECID niet op te nemen in de API-aanroep. Deze parameter wordt automatisch toegevoegd aan de vraag indien nodig.
decisionScopes
Ja
Een array met Base64-gecodeerde tekenreeksen van JSON die de activiteit- en plaatsings-id's bevatten.
Maximaal 30 decisionScopes per aanvraag.
"decisionScopes": ["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="]

Reactie

{
  "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
    }
  ]
}
Eigenschap
Beschrijving
Voorbeeld
scope
De reikwijdte van de beslissing die tot de voorgestelde aanbiedingen heeft geleid.
"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id
De unieke id van de aanbiedingsactiviteit.
"id": "xcore:offer-activity:11cfb1fa93381aca"
placement.id
De unieke id van de plaatsing van de aanbieding.
"id": "xcore:offer-placement:1175009612b0100c"
items.id
De id van de voorgestelde aanbieding.
"id": "xcore:personalized-offer:124cc332095cfa74"
schema
Het schema van de inhoud verbonden aan de voorgestelde aanbieding.
"schema": "https://ns.adobe.com/experience/offer-management/content-component-html"
data.id
De id van de voorgestelde aanbieding.
"id": "xcore:personalized-offer:124cc332095cfa74"
format
Het formaat van de inhoud die aan de voorgestelde aanbieding is gekoppeld.
"format": "text/html"
language
Een array met talen die zijn gekoppeld aan de inhoud van het voorgestelde aanbod.
"language": [ "en-US" ]
content
De inhoud die aan de voorgestelde aanbieding in het formaat van een koord wordt geassocieerd.
"content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl
De afbeeldingsinhoud die aan de voorgestelde aanbieding is gekoppeld, wordt weergegeven in de vorm van een URL.
"deliveryURL": "https://image.jpeg"
characteristics
Kenmerken van de voorgestelde aanbieding in de vorm van een JSON-object.
"characteristics": { "foo": "bar", "foo1": "bar1" }

Meerdere decisionScopes waarden

Verzoek

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyYzkxMzg1Mjc2MDE4YyIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMzMxZjU2MTYyYWEyZjcifQ=="
          ]
        }
      }
    }
  ]
}
Eigenschap
Vereist
Beschrijving
Limieten
Voorbeeld
identityMap
Ja
Verwijs naar deze ​ documentatie van de Dienst van de Identiteit ​.
Eén identiteit per aanvraag.
{ "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }.

Opmerking: gebruikers hoeven de parameter ECID niet op te nemen in de API-aanroep. Deze parameter wordt automatisch toegevoegd aan de vraag indien nodig.
decisionScopes
Ja
Een array met Base64-gecodeerde tekenreeksen van JSON die de activiteit- en plaatsings-id's bevatten.
Maximaal 30 decisionScopes per aanvraag.
"decisionScopes":["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==", "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ=="

Reactie

{
  "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
    }
  ]
}
Eigenschap
Beschrijving
Voorbeeld
scope
De reikwijdte van de beslissing die tot de voorgestelde aanbiedingen heeft geleid.
"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id
De unieke id van de aanbiedingsactiviteit.
"id": "xcore:offer-activity:11cfb1fa93381123"
placement.id
De unieke id van de plaatsing van de aanbieding.
"xcore:offer-placement:1175009612b01123"
items.id
De id van de voorgestelde aanbieding.
"id": "xcore:personalized-offer:11e36d4a22954123"
schema
Het schema van de inhoud verbonden aan de voorgestelde aanbieding.
"schema": "https://ns.adobe.com/experience/offer-management/content-component-text"
data.id
De id van de voorgestelde aanbieding.
"id": "xcore:personalized-offer:11e36d4a22954123"
format
Het formaat van de inhoud die aan de voorgestelde aanbieding is gekoppeld.
"format": "text/text"
language
Een array met talen die zijn gekoppeld aan de inhoud van het voorgestelde aanbod.
"language": [ "en-US" ]
content
De inhoud die aan de voorgestelde aanbieding in het formaat van een koord wordt geassocieerd.
"content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl
De afbeeldingsinhoud die aan de voorgestelde aanbieding is gekoppeld, wordt weergegeven in de vorm van een URL.
"deliveryURL": "https://image.jpeg"
characteristics
Kenmerken van de voorgestelde aanbieding in de vorm van een JSON-object.
"characteristics": { "foo": "bar", "foo1": "bar1" }

Beperkingen

Sommige aanbiedingsbeperkingen worden momenteel niet ondersteund door de mobiele Edge Network-workflows, bijvoorbeeld Afdekkingen. De waarde van het gebied van de Plak specificeert het aantal tijden een aanbieding over alle gebruikers kan worden voorgesteld. Voor meer details, zie ​ de geschiktheidsregels en beperkingsdocumentatie van de Aanbieding ​.

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