DocumentatieExperience PlatformHandleiding voor Web SDK

Offer Decisioning gebruiken met de Experience Platform Web SDK

Last update: Mon May 05 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 Decisioningte 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 gegevensstromendocumentatie.

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

Offer Decisioning inschakelen

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

  1. Toegelaten Adobe Experience Platform in uw datastreamen controleer de "Offer Decisioning"doos

    aanbod-besluit-rand-config

  2. Volg de instructies om SDKte 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 codetoe

      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 bibliotheekdie 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