Verwenden von Offer decisioning mit dem Platform Web SDK

HINWEIS

Die Verwendung von Offer decisioning im Adobe Experience Platform Web SDK ist für ausgewählte Benutzer in einem frühen Stadium verfügbar. Diese Funktion ist nicht für alle IMS-Organisationen verfügbar.

Adobe Experience Platform Web SDK kann personalisierte Angebote bereitstellen und rendern, die unter Offer decisioning verwaltet werden. Sie können Ihre Angebote und andere verwandte Objekte mithilfe der Offer decisioning-Benutzeroberfläche (UI) oder APIs erstellen.

Voraussetzungen

  • Die IMS-Organisation ist für Edge-Entscheidungen aktiviert.
  • Angebote, erstellte Aktivitäten
  • Datenspeicher wird veröffentlicht

Terminologie

Bei der Arbeit mit Offer decisioning ist es wichtig, die folgende Terminologie zu verstehen. Weitere Informationen und zusätzliche Begriffe finden Sie im Offer decisioning-Glossar.

  • Container: Ein Container ist ein Isolationsmechanismus, der unterschiedliche Anliegen voneinander trennt. Die Container-ID ist das erste Pfadelement für alle Repository-APIs. Alle Entscheidungsobjekte befinden sich in einem Container.

  • Entscheidungsbereiche: Für Offer decisioning sind Entscheidungsbereiche die Base64-kodierten Zeichenfolgen von JSON, die die Aktivitäts- und Platzierungs-IDs enthalten, die der offer decisioning-Dienst verwenden soll, um Angebote vorzuschlagen.

    Entscheidungsbereich JSON:

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

    Entscheidungsbereich Base64-kodierte Zeichenfolge:

    "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
    
    TIPP

    Sie können den Wert für den Entscheidungsbereich von der Seite Aktivitätsübersicht in der Benutzeroberfläche kopieren.

  • Datenspeicher: Weitere Informationen finden Sie in der 🔗 Dokumentation zu Datenspeichern.

  • Identität: Weitere Informationen dazu, wie das Platform Web SDK Identity Service verwendet, finden Sie in dieser Dokumentation.

Aktivieren von Offer decisioning

Führen Sie die folgenden Schritte aus, um Offer decisioning zu aktivieren:

  1. Adobe Experience Platform in Ihrem datastream aktiviert und das Kontrollkästchen "Offer decisioning"aktiviert

    offer-decisioning-edge-config

  2. Befolgen Sie die Anweisungen unter Installieren des SDK (Das SDK kann eigenständig oder über die Datenerfassungs-Benutzeroberfläche installiert werden. Weitere Informationen finden Sie in der Tags-Schnellstartanleitung).

  3. Konfigurieren Sie das SDK für Offer decisioning. Weitere Offer decisioning-spezifische Schritte finden Sie unten.

    • Installieren des eigenständigen SDK

      1. Konfigurieren Sie die Aktion "sendEvent"mit decisionScopes .

         alloy("sendEvent", {
            ...
            "decisionScopes": [
                "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIwOWMxM2JkZDIyNCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMDZhODRkMDViMTEifQ==",
                "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIyNWI5NTUwNWIxZiIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMjFmOTQzMDE0MmIifQ=="
            ]
         })
        
    • SDK über Tags installieren

      1. Tag-Eigenschaft erstellen

      2. Hinzufügen des Einbettungscodes

      3. Installieren und konfigurieren Sie die Platform Web SDK-Erweiterung mit dem von Ihnen erstellten Datastream, indem Sie die Konfiguration aus der Dropdown-Liste "Datastream"auswählen. Weitere Informationen finden Sie in der Dokumentation zu extensions.

        install-aep-web-sdk-extension

        configure-aep-web-sdk-extension

      4. Erstellen Sie die erforderlichen Datenelemente. Sie müssen mindestens eine Platform Web SDK Identity Map und ein Platform Web SDK XDM Object -Datenelement erstellen.

        identity-map-data-element

        xdm-object-data-element

      5. Erstellen Sie Ihre Regeln.

        • Fügen Sie die Aktion "Ereignis senden"des Platform Web SDK hinzu und fügen Sie die relevante decisionScopes zur Konfiguration dieser Aktion hinzu.

          send-event-action-decisionScopes

      6. Erstellen und veröffentlichen Sie eine Bibliothek mit allen relevanten Regeln, Datenelementen und Erweiterungen, die Sie konfiguriert haben

Beispielanfragen und -antworten

Ein decisionScopes-Wert

Anfrage

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
          ]
        }
      }
    }
  ]
}
Eigenschaft Erforderlich Beschreibung Beschränkungen Beispiel
identityMap Ja Weitere Informationen finden Sie in der Dokumentation zum Identity Service. Eine Identität pro Anfrage. { "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }
decisionScopes Ja Ein Array Base64-kodierter Zeichenfolgen von JSON, die die Aktivitäts- und Platzierungs-IDs enthalten. Maximal 30 decisionScopes pro Anfrage. "decisionScopes": ["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="]

Antwort

{
  "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
    }
  ]
}
Eigenschaft Beschreibung Beispiel
scope Der Entscheidungsbereich, der zu den vorgeschlagenen Angeboten führte. "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id Die eindeutige Kennung der Angebotsaktivität. "id": "xcore:offer-activity:11cfb1fa93381aca"
placement.id Die eindeutige ID der Angebotsplatzierung. "id": "xcore:offer-placement:1175009612b0100c"
items.id Die Kennung des vorgeschlagenen Angebots. "id": "xcore:personalized-offer:124cc332095cfa74"
schema Das Schema des dem vorgeschlagenen Angebot zugeordneten Inhalts. "schema": "https://ns.adobe.com/experience/offer-management/content-component-html"
data.id Die Kennung des vorgeschlagenen Angebots. "id": "xcore:personalized-offer:124cc332095cfa74"
format Das Format des mit dem vorgeschlagenen Angebot verknüpften Inhalts. "format": "text/html"
language Eine Reihe von Sprachen, die mit dem Inhalt des vorgeschlagenen Angebots verknüpft sind. "language": [ "en-US" ]
content Inhalt, der mit dem vorgeschlagenen Angebot in Form einer Zeichenfolge verknüpft ist. "content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl Bildinhalt, der mit dem vorgeschlagenen Angebot verknüpft ist, im Format einer URL. "deliveryURL": "https://image.jpeg"
characteristics Eigenschaften, die mit dem vorgeschlagenen Angebot im Format eines JSON-Objekts verknüpft sind. "characteristics": { "foo": "bar", "foo1": "bar1" }

Mehrere decisionScopes-Werte

Anfrage

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyYzkxMzg1Mjc2MDE4YyIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMzMxZjU2MTYyYWEyZjcifQ=="
          ]
        }
      }
    }
  ]
}
Eigenschaft Erforderlich Beschreibung Beschränkungen Beispiel
identityMap Ja Weitere Informationen finden Sie in der Dokumentation zum Identity Service. Eine Identität pro Anfrage. { "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }
decisionScopes Ja Ein Array Base64-kodierter Zeichenfolgen von JSON, die die Aktivitäts- und Platzierungs-IDs enthalten. Maximal 30 decisionScopes pro Anfrage. "decisionScopes":["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==", "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ=="

Antwort

{
  "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
    }
  ]
}
Eigenschaft Beschreibung Beispiel
scope Der Entscheidungsbereich, der zu den vorgeschlagenen Angeboten führte. "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id Die eindeutige Kennung der Angebotsaktivität. "id": "xcore:offer-activity:11cfb1fa93381123"
placement.id Die eindeutige ID der Angebotsplatzierung. "xcore:offer-placement:1175009612b01123"
items.id Die Kennung des vorgeschlagenen Angebots. "id": "xcore:personalized-offer:11e36d4a22954123"
schema Das Schema des dem vorgeschlagenen Angebot zugeordneten Inhalts. "schema": "https://ns.adobe.com/experience/offer-management/content-component-text"
data.id Die Kennung des vorgeschlagenen Angebots. "id": "xcore:personalized-offer:11e36d4a22954123"
format Das Format des mit dem vorgeschlagenen Angebot verknüpften Inhalts. "format": "text/text"
language Eine Reihe von Sprachen, die mit dem Inhalt des vorgeschlagenen Angebots verknüpft sind. "language": [ "en-US" ]
content Inhalt, der mit dem vorgeschlagenen Angebot in Form einer Zeichenfolge verknüpft ist. "content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl Bildinhalt, der mit dem vorgeschlagenen Angebot verknüpft ist, im Format einer URL. "deliveryURL": "https://image.jpeg"
characteristics Eigenschaften, die mit dem vorgeschlagenen Angebot im Format eines JSON-Objekts verknüpft sind. "characteristics": { "foo": "bar", "foo1": "bar1" }

Einschränkungen

Einige Angebotsbegrenzungen werden derzeit nicht von den mobilen Experience Edge-Workflows unterstützt, z. B. Capping. Der Wert des Felds Begrenzung gibt an, wie oft ein Angebot für alle Benutzer angezeigt werden kann. Weitere Informationen finden Sie in der Dokumentation zu Regeln und Begrenzungen für Angebote.

Auf dieser Seite