personalization

Das personalization-Objekt konfiguriert, welche Personalisierungsentscheidungen (Angebote oder Vorschläge) angefordert werden und wie sie in der Anfrage und Antwort verarbeitet werden. Dies ist besonders bei Adobe Target- oder Adobe Journey Optimizer-Implementierungen nützlich, da es die treibende Kraft ist, mit der Sie die angezeigten Inhalte pro Benutzerin bzw. Benutzer anpassen können.

alloy("sendEvent", {
  personalization: {
    decisionScopes: ["hero-banner"],
    surfaces: ["web://example.com"],
    schemas: ["https://ns.adobe.com/personalization/dom-action"],
    sendDisplayEvent: true,
    sendDisplayNotifications: true,
    includePendingDisplayNotifications: true,
    defaultPersonalizationEnabled: false
  },
  renderDecisions: true,
  xdm: adobeDataLayer.getState(reference)
});

Das personalization-Objekt enthält die folgenden Eigenschaften:

personalization.decisionScopes

Die decisionScopes-Eigenschaft ist ein Array von Zeichenfolgen, das die Web-SDK anweist, Personalisierungsentscheidungen abzurufen und zurückzugeben. Jedes Element im Array identifiziert einen Speicherort, einen Kontext oder eine logische Platzierung, an dem personalisierte Inhalte gewünscht werden.

Diese Eigenschaft ist nützlich, wenn Sie explizit personalisierte Inhalte für bestimmte Bereiche oder Komponenten einer Seite abrufen möchten. Dies ist besonders nützlich bei Single Page Applications, für die möglicherweise andere Angebote erforderlich sind, wenn sich die Navigation oder Ansicht der Benutzenden ändert. Sie können diese Eigenschaft auch verwenden, um die Leistung zu optimieren, indem Sie nur Angebote für die Benutzeroberflächenelemente abrufen, die für den Benutzer relevant sind.

personalization: {
  decisionScopes: ["hero-banner", "cart-offer"]
}

In Adobe Target wird jeder Entscheidungsumfang einer Mbox oder Aktivität zugeordnet. In Adobe Journey Optimizer ist jeder Entscheidungsumfang entscheidungsbasierten Web-Content-Platzierungen oder -Kampagnen zugeordnet. In Offer Decisioning werden die Entscheidungsumfänge den Angeboten oder Vorschlägen zugeordnet, die der Besucher erhalten soll.

personalization.surfaces

Die surfaces-Eigenschaft ist ein Array von Oberflächen-URI-Zeichenfolgen, die den Kanal, das Gerät oder den Kontext, für den die Personalisierung angefordert wird, manuell definieren. Sie ermöglichen es Ihnen, zwischen verschiedenen digitalen Erlebnissen wie Domains, Apps oder Geräteplattformen in Ihrem kanalübergreifenden Ökosystem zu unterscheiden. Standardmäßig leitet die Bibliothek die Standardoberfläche von der aktuellen Seite ab. Mit dieser Eigenschaft können Sie die automatisch abgeleitete Oberfläche für die aktuelle Seite überschreiben.

Diese Eigenschaft ist nützlich, wenn Sie die kanalübergreifende Personalisierung verwenden möchten, und Sie müssen unterscheiden, wie die Personalisierung zwischen verschiedenen Kanälen funktioniert. Damit können Sie unter derselben Adobe Experience Platform-Organisation separate Angebote für verschiedene Sites erstellen.

personalization: {
  surfaces: ["web://example.com", "web://support.example.com/contact"]
}

Diese Eigenschaft wird in Adobe Journey Optimizer grundsätzlich verwendet, da sie mit in Journey Optimizer-Kampagnen eingerichteten Oberflächen und mit der Oberflächenverwaltung übereinstimmt.

personalization.schemas

Die schemas-Eigenschaft ist ein Array von Schema-URI-Zeichenfolgen, die die von Edge Network angeforderten Arten von Personalisierungsinhalten filtern. Wenn Sie diese Eigenschaft festlegen, wird die Antwort, die Sie von Adobe erhalten, darauf beschränkt, nur Angebote einzuschließen, die den von Ihnen angegebenen Inhaltstypdefinitionen entsprechen. Wenn diese Option weggelassen wird, fordert die Bibliothek Angebote aller verfügbaren Schemata für die entsprechenden Bereiche oder Oberflächen an.

Diese Eigenschaft hilft bei der Optimierung der Antwortgröße und stellt sicher, dass Ihre Website oder Anwendung nur Angebotstypen erhält, die sie verarbeiten kann. Dies ist auch hilfreich, wenn es mit Single Page Applications verwendet wird, die personalisierte Inhalte auf eine bestimmte Weise rendern (z. B. nur mit DOM-Aktionen oder nur JSON-Objekten).

personalization: {
  schemas: [
    "https://ns.adobe.com/personalization/dom-action",
    "https://ns.adobe.com/personalization/html-content-item"
  ]
}

Die folgenden Schema-URIs werden unterstützt:

personalization.sendDisplayEvent

Bei der sendDisplayEvent-Eigenschaft handelt es sich um einen booleschen Wert, der bestimmt, ob ein Anzeigebenachrichtigungsereignis automatisch an die Edge Network gesendet wird, unmittelbar nachdem personalisierte Inhalte auf der Seite gerendert wurden. Wenn ausgelassen, wird der Standardwert true. Legen Sie diese Variable auf false fest, wenn Sie nicht angeben möchten, dass personalisierte Inhalte für das Impression-Tracking gerendert wurden.

Der häufigste Anwendungsfall für das Festlegen dieser Variablen auf false besteht darin, einen anderen Befehl an eine andere Stelle in Ihrer Implementierung zu senden, die ein Anzeigeereignis kennzeichnet. Einige Implementierungen verfügen sowohl über Impression- als auch über Analytics-Ereignisse. Diese Eigenschaft gibt Ihnen die volle Kontrolle darüber, welche sendEvent-Befehle die Impressionen erhöhen.

personalization: {
  sendDisplayEvent: true
}

personalization.includePendingDisplayNotifications

Die includePendingDisplayNotifications-Eigenschaft ist ein boolescher Wert, der steuert, ob ausstehende Anzeigebenachrichtigungen im aktuellen sendEvent enthalten sind. Ausstehende Anzeigebenachrichtigungen sind Impressionen für personalisierte Inhalte, die gerendert, aber noch nicht als Anzeigeereignis an Edge Network gemeldet wurden. Diese Eigenschaft ist bei der Verwendung von Einzelseitenanwendungen hilfreich, da das Rendern von personalisierten Inhalten und sendEvent möglicherweise asynchron erfolgt.

Der Standardwert für diese Eigenschaft ist false. Legen Sie diese Eigenschaft auf true fest, wenn Sie ausstehende Anzeigebenachrichtigungen per Batch löschen möchten, damit ihre Impressionen korrekt aufgezeichnet werden. Synchrone Implementierung, z. B. herkömmliche Websites, muss diese Eigenschaft normalerweise nicht festlegen.

personalization: {
  includePendingDisplayNotifications: true
}

personalization.defaultPersonalizationEnabled

Die defaultPersonalizationEnabled-Eigenschaft ist ein boolescher Wert, der Ihnen explizit die Kontrolle darüber gibt, wie die Web-SDK den standardmäßigen seitenweiten Personalisierungsbereich (__view__) und die Oberfläche für diesen sendEvent anfordert. Standardmäßig fordert Web SDK beim ersten sendEvent nach dem Laden einer Seite Angebote für den standardmäßigen seitenweiten Personalisierungsbereich und die zugehörigen Oberflächen an. Nachfolgende sendEvent-Befehle fordern keine Standardpersonalisierung an. Mit dieser Eigenschaft können Sie dieses Verhalten außer Kraft setzen. Dies ist nützlich bei Implementierungen von Einzelseiten-Apps, bei denen Sie beim Navigieren auf Ihrer Site die standardmäßige Personalisierung erneut anfordern können. Sie können diese Eigenschaft auch verwenden, wenn Sie ein Anzeigeereignis nur senden möchten, ohne den Abruf von Angeboten zu duplizieren.

personalization: {
  defaultPersonalizationEnabled: false
}

Diese Eigenschaft verwendet die folgende Logik, je nachdem, wie sie festgelegt ist:

Personalization-Komponenten, die die Tag-Erweiterung „Web SDK" verwenden

Die Web SDK-Tag-Erweiterung, die dieser Eigenschaft entspricht, ist der Personalization Abschnitt beim Konfigurieren einer Send event-Aktion.