Verwenden von Offer decisioning mit Platform Web SDK

NOTE
Ausgewählten Benutzern wird vorab Zugriff auf die Verwendung von Offer decisioning in Adobe Experience Platform Web SDK gewährt. Diese Funktion ist nicht für alle Organisationen verfügbar.

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

Voraussetzungen

  • Organisation ist für Edge Decisioning aktiviert
  • Erstellte Angebote und Aktivitäten
  • Datenstrom wird veröffentlicht

Terminologie

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

  • Entscheidungsumfänge: Beim Offer decisioning sind Entscheidungsumfänge die Base64-codierten JSON-Zeichenfolgen, die die Aktivitäts- und Platzierungs-IDs enthalten, die der offer decisioning-Service zum Unterbreiten von Angeboten verwenden soll.

    Entscheidungsumfang JSON:

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

    Entscheidungsumfang Base64-kodierte Zeichenfolge:

    code language-json
    "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
    
    note tip
    TIP
    Sie können den Wert des Entscheidungsumfangs von der Seite Aktivitätsübersicht in der Benutzeroberfläche kopieren.

    Einstellungen für Entscheidungskopien.

  • Datenströme: Weitere Informationen finden Sie in der Dokumentation Datenströme.

  • Identität: Weitere Informationen finden Sie in dieser Dokumentation, in der erläutert wird, wie Platform Web SDK Identity Service verwendet.

Offer decisioning wird aktiviert

Um das Offer decisioning zu aktivieren, führen Sie die folgenden Schritte aus:

  1. Adobe Experience Platform in Ihrem Datenstrom“ aktiviertdas Kontrollkästchen "Offer decisioning" aktivieren

    offer-decisioning-edge-config

  2. Befolgen Sie die Anweisungen zum Installieren des SDK (SDK kann eigenständig oder über die Benutzeroberfläche installiert werden. Weitere Informationen finden Sie Tags-Schnellstartanleitung.

  3. Konfigurieren Sie den SDK für das Offer decisioning mit personalization.decisionScopes. Weitere Offer decisioning-spezifische Schritte sind unten aufgeführt.

    • Installieren des eigenständigen SDKS

      1. Konfigurieren der Aktion „sendEvent“ mit personalization.decisionScopes
      code language-javascript
      alloy("sendEvent", {
        ...
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIwOWMxM2JkZDIyNCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMDZhODRkMDViMTEifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIyNWI5NTUwNWIxZiIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMjFmOTQzMDE0MmIifQ=="
          ]
        }
      });
      
    • Installieren von SDK über Tags

      1. Erstellen einer Tag-Eigenschaft

      2. Fügen Sie den Einbettungs-Code hinzu

      3. Installieren und konfigurieren Sie die Platform Web SDK-Erweiterung mit dem von Ihnen erstellten Datenstrom, indem Sie die Konfiguration aus der Dropdown-Liste „Datenstrom“ auswählen. Weitere Informationen zu Datensätzen finden Sie in der Dokumentation zu Erweiterungen.

        install-aep-web-sdk-extension

        configure-aep-web-sdk-extension

      4. Erstellen Sie die erforderlichen Datenelemente. Sie müssen zumindest 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 eine Platform Web SDK Send Event-Aktion hinzu und fügen Sie der Konfiguration dieser Aktion die entsprechenden decisionScopes hinzu

        send-event-action-decisionScopes

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

Beispielanfragen und -antworten

Ein decisionScopes

Anfrage

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
          ]
        }
      }
    }
  ]
}
Eigenschaft
Erforderlich
Beschreibung
Beschränkungen
Beispiel
identityMap
Ja
Weitere Informationen finden Sie Identity Service-Dokumentation.
Eine Identität pro Anfrage.
{ "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }.

Hinweis: Benutzer müssen den ECID nicht in den API-Aufruf einbeziehen. Dieser Parameter wird dem Aufruf bei Bedarf automatisch hinzugefügt.
decisionScopes
Ja
Ein Array von Base64-codierten JSON-Zeichenfolgen, das die Aktivitäts- und Platzierungs-IDs enthält.
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 Entscheidungsumfang, der zu den vorgeschlagenen Angeboten geführt hat.
"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id
Die eindeutige ID der Angebotsaktivität.
"id": "xcore:offer-activity:11cfb1fa93381aca"
placement.id
Die eindeutige ID der Angebotsplatzierung.
"id": "xcore:offer-placement:1175009612b0100c"
items.id
Die ID des vorgeschlagenen Angebots.
"id": "xcore:personalized-offer:124cc332095cfa74"
schema
Das Schema des Inhalts, der mit dem vorgeschlagenen Angebot verknüpft ist.
"schema": "https://ns.adobe.com/experience/offer-management/content-component-html"
data.id
Die ID des vorgeschlagenen Angebots.
"id": "xcore:personalized-offer:124cc332095cfa74"
format
Das Format des Inhalts, der mit dem vorgeschlagenen Angebot verknüpft ist.
"format": "text/html"
language
Eine Reihe von Sprachen, die mit dem Inhalt des vorgeschlagenen Angebots verknüpft sind.
"language": [ "en-US" ]
content
Dem vorgeschlagenen Angebot im Zeichenfolgenformat entsprechender Inhalt
"content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl
Bildinhalt im Zusammenhang mit dem vorgeschlagenen Angebot im Format einer URL.
"deliveryURL": "https://image.jpeg"
characteristics
Merkmale, die mit dem vorgeschlagenen Angebot im Format eines JSON-Objekts verknüpft sind.
"characteristics": { "foo": "bar", "foo1": "bar1" }

Mehrere decisionScopes

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 Identity Service-Dokumentation.
Eine Identität pro Anfrage.
{ "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }.

Hinweis: Benutzer müssen den ECID nicht in den API-Aufruf einbeziehen. Dieser Parameter wird dem Aufruf bei Bedarf automatisch hinzugefügt.
decisionScopes
Ja
Ein Array von Base64-codierten JSON-Zeichenfolgen, das die Aktivitäts- und Platzierungs-IDs enthält.
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 Entscheidungsumfang, der zu den vorgeschlagenen Angeboten geführt hat.
"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
activity.id
Die eindeutige ID der Angebotsaktivität.
"id": "xcore:offer-activity:11cfb1fa93381123"
placement.id
Die eindeutige ID der Angebotsplatzierung.
"xcore:offer-placement:1175009612b01123"
items.id
Die ID des vorgeschlagenen Angebots.
"id": "xcore:personalized-offer:11e36d4a22954123"
schema
Das Schema des Inhalts, der mit dem vorgeschlagenen Angebot verknüpft ist.
"schema": "https://ns.adobe.com/experience/offer-management/content-component-text"
data.id
Die ID des vorgeschlagenen Angebots.
"id": "xcore:personalized-offer:11e36d4a22954123"
format
Das Format des Inhalts, der mit dem vorgeschlagenen Angebot verknüpft ist.
"format": "text/text"
language
Eine Reihe von Sprachen, die mit dem Inhalt des vorgeschlagenen Angebots verknüpft sind.
"language": [ "en-US" ]
content
Dem vorgeschlagenen Angebot im Zeichenfolgenformat entsprechender Inhalt
"content": "<p style="color:red;">20% Off on shipping</p>"
deliveryUrl
Bildinhalt im Zusammenhang mit dem vorgeschlagenen Angebot im Format einer URL.
"deliveryURL": "https://image.jpeg"
characteristics
Merkmale, die mit dem vorgeschlagenen Angebot im Format eines JSON-Objekts verknüpft sind.
"characteristics": { "foo": "bar", "foo1": "bar1" }

Einschränkungen

Einige Angebotsbeschränkungen werden derzeit nicht mit den Workflows für mobile Edge Networks unterstützt, z. B. die Begrenzung. Der Wert des Feldes „Begrenzung“ gibt an, wie oft ein Angebot allen Benutzern angezeigt werden kann. Weitere Informationen finden Sie in der Dokumentation zu Angebotseignungsregeln und Einschränkungen.

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