DokumentationExperience PlatformAnvändarhandbok om webb-SDK

Använda Offer decisioning med Platform Web SDK

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Utvecklare
NOTE
Offer decisioning i Adobe Experience Platform Web SDK är tillgänglig i ett tidigt skede för vissa användare. Den här funktionen är inte tillgänglig för alla organisationer.

Adobe Experience Platform Web SDK kan leverera och återge personaliserade erbjudanden som hanteras i Offer decisioning. Du kan skapa erbjudanden och andra relaterade objekt med hjälp av användargränssnittet (UI) eller API:erna för Offera decisioningen.

Förhandskrav

  • Organisationen är aktiverad för kantbeslut
  • Erbjudanden, skapade aktiviteter
  • Datastream publiceras

Terminologi

Det är viktigt att förstå följande terminologi när du arbetar med Offer decisioning. Om du vill ha mer information och visa ytterligare villkor går du till Offera decisioningens ordlista.

  • Beslutsomfattningar: För Offer decisioning är beslutsomfattningar de Base64-kodade strängarna för JSON som innehåller de aktivitets- och placerings-ID som du vill att offera decisioningen ska använda för att föreslå erbjudanden.

    Beslutsomfattnings-JSON:

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

    Beslutsomfattarens Base64-kodade sträng:

    code language-json 
    "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
    note tip
    TIP
    Du kan kopiera värdet för beslutsomfånget från sidan Aktivitetsöversikt i användargränssnittet.

    Inställningar för beslutskopiering.

  • Datastreams: Mer information finns i dokumentationen för datastreams.

  • Identitet: Mer information finns i den här dokumentationen som beskriver hur Platform Web SDK använder identitetstjänsten.

Aktivera Offer decisioning

Så här aktiverar du Offer decisioning:

  1. Aktiverade Adobe Experience Platform i din datastream och markera kryssrutan Offer decisioning

    offer-decisioning-edge-config

  2. Följ instruktionerna för att installera SDK (SDK kan installeras fristående eller via användargränssnittet. Mer information finns i snabbstartsguiden för taggar).

  3. Konfigurera SDK för Offer decisioning med personalization.decisionScopes. Ytterligare Offer decisioning-specifika steg finns nedan.

    • Installera fristående SDK

      1. Konfigurera åtgärden sendEvent med personalization.decisionScopes
      code language-javascript 
      alloy("sendEvent", {
  ...
  "personalization": {
    "decisionScopes": [
      "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIwOWMxM2JkZDIyNCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMDZhODRkMDViMTEifQ==",
      "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIyNWI5NTUwNWIxZiIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMjFmOTQzMDE0MmIifQ=="
    ]
  }
});

    • Installera SDK via taggar

      1. Skapa en taggegenskap

      2. Lägg till inbäddningskoden

      3. Installera och konfigurera Platform Web SDK-tillägget med den dataström du skapade genom att välja konfigurationen i listrutan Datastream. Mer information finns i dokumentationen om tillägg.

        install-aep-web-sdk-extension

        configure-aep-web-sdk-extension

      4. Skapa nödvändiga dataelement. Minimikravet är att du måste skapa en plattformsbaserad SDK-identitetskarta och ett XDM-objektdataelement för plattformswebben.

        identity-map-data-element

        xdm-object-data-element

      5. Skapa dina regler.

        • Lägg till en SDK-sändningsåtgärd för en plattform och lägg till relevant decisionScopes i åtgärdens konfiguration

        send-event-action-DecisionScopes

      6. Skapa och publicera ett bibliotek som innehåller alla relevanta regler, dataelement och tillägg som du har konfigurerat

Exempelbegäranden och svar

Ett decisionScopes-värde

Begäran

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
          ]
        }
      }
    }
  ]
}
Egenskap
Obligatoriskt
Beskrivning
Gränser
Exempel
identityMap
Ja
Se Identitetstjänstens dokumentation.
En identitet per begäran.
{ "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }.

Obs! Användare behöver inte ta med parametern ECID i API-anropet. Den här parametern läggs automatiskt till i samtalet om det behövs.
decisionScopes
Ja
En array med Base64-kodade strängar av JSON som innehåller aktivitets- och placerings-ID:n.
Högst 30 decisionScopes per begäran.
"decisionScopes": ["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="]

Svar

{
  "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
    }
  ]
}
Egenskap
Beskrivning
Exempel
scope
Beslutets omfattning som resulterade i de föreslagna erbjudandena.
"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id
Unikt ID för erbjudandeaktiviteten.
"id": "xcore:offer-activity:11cfb1fa93381aca"
placement.id
Erbjudandets unika ID.
"id": "xcore:offer-placement:1175009612b0100c"
items.id
ID för det föreslagna erbjudandet.
"id": "xcore:personalized-offer:124cc332095cfa74"
schema
Schemat för innehållet som är associerat med det föreslagna erbjudandet.
"schema": "https://ns.adobe.com/experience/offer-management/content-component-html"
data.id
ID för det föreslagna erbjudandet.
"id": "xcore:personalized-offer:124cc332095cfa74"
format
Formatet på innehållet som är associerat med det föreslagna erbjudandet.
"format": "text/html"
language
En array med språk som är associerade med innehållet i det föreslagna erbjudandet.
"language": [ "en-US" ]
content
Innehåll som är associerat med det föreslagna erbjudandet i form av en sträng.
"content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl
Bildinnehåll som är associerat med det föreslagna erbjudandet i formatet för en URL.
"deliveryURL": "https://image.jpeg"
characteristics
Egenskaper som är kopplade till det föreslagna erbjudandet i formatet JSON-objekt.
"characteristics": { "foo": "bar", "foo1": "bar1" }

Flera decisionScopes-värden

Begäran

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyYzkxMzg1Mjc2MDE4YyIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMzMxZjU2MTYyYWEyZjcifQ=="
          ]
        }
      }
    }
  ]
}
Egenskap
Obligatoriskt
Beskrivning
Gränser
Exempel
identityMap
Ja
Se Identitetstjänstens dokumentation.
En identitet per begäran.
{ "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }.

Obs! Användare behöver inte ta med parametern ECID i API-anropet. Den här parametern läggs automatiskt till i samtalet om det behövs.
decisionScopes
Ja
En array med Base64-kodade strängar av JSON som innehåller aktivitets- och placerings-ID:n.
Högst 30 decisionScopes per begäran.
"decisionScopes":["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==", "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ=="

Svar

{
  "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
    }
  ]
}
Egenskap
Beskrivning
Exempel
scope
Beslutets omfattning som resulterade i de föreslagna erbjudandena.
"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id
Unikt ID för erbjudandeaktiviteten.
"id": "xcore:offer-activity:11cfb1fa93381123"
placement.id
Erbjudandets unika ID.
"xcore:offer-placement:1175009612b01123"
items.id
ID för det föreslagna erbjudandet.
"id": "xcore:personalized-offer:11e36d4a22954123"
schema
Schemat för innehållet som är associerat med det föreslagna erbjudandet.
"schema": "https://ns.adobe.com/experience/offer-management/content-component-text"
data.id
ID för det föreslagna erbjudandet.
"id": "xcore:personalized-offer:11e36d4a22954123"
format
Formatet på innehållet som är associerat med det föreslagna erbjudandet.
"format": "text/text"
language
En array med språk som är associerade med innehållet i det föreslagna erbjudandet.
"language": [ "en-US" ]
content
Innehåll som är associerat med det föreslagna erbjudandet i form av en sträng.
"content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl
Bildinnehåll som är associerat med det föreslagna erbjudandet i formatet för en URL.
"deliveryURL": "https://image.jpeg"
characteristics
Egenskaper som är kopplade till det föreslagna erbjudandet i formatet JSON-objekt.
"characteristics": { "foo": "bar", "foo1": "bar1" }

Begränsningar

Vissa begränsningar för erbjudanden stöds för närvarande inte i arbetsflödena för mobila Edge Network, till exempel Capping. Fältvärdet för begränsning anger hur många gånger ett erbjudande kan visas för alla användare. Mer information finns i Erbjud berättiganderegler och begränsningsdokumentation.

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