Sitemap und Datenaufnahme

Ereignistypanforderungen

Marketing Cloud Personalization-Sitemaps verwenden das Aktionsfeld als aussagekräftige Bezeichnung (z. B. "Produkt anzeigen", "In den Einkaufswagen" usw.), um zu ermitteln, was auf einer Seite geschieht. Das Data 360-Web-SDK verwendet für diesen Zweck interaction.name und erfordert auch ein Feld eventType, um zu bestimmen, wie das Ereignis dem Ereignisschema des Website-Konnektors zugeordnet wird.

Bei Verwendung von standardmäßigen Interaktionsnamenskonstanten (z. B. ViewCatalogObject, AddToCart oder Purchase) leitet das SDK automatisch den richtigen Ereignistyp ab.

Benutzerdefinierte Aktionen (z. B. "Artikel lesen" oder "Freigegebener Artikel") werden jedoch nur dann richtig aufgenommen, wenn sie mit einem gültigen Ereignistyp im Webereignisschema übereinstimmen und die erforderlichen Benennungskonventionen erfüllen. Daher wird empfohlen, eine explizite interaction.eventType anzugeben, die mit dem Ereignisschemaobjekt übereinstimmt. Alternativ können Sie einen Wert interaction.name verwenden, der auch ein gültiges eventType-Token ist, und sicherstellen, dass er mit dem Schemaobjekt übereinstimmt.

• Beginnen Sie mit einem Buchstaben
• Nur alphanumerische Zeichen und Unterstriche enthalten (keine Leerzeichen)
• Nicht mit aufeinanderfolgenden Unterstrichen enden oder diese aufweisen
• Maximal 80 Zeichen enthalten
• Abgleichen eines im Ereignisschema des Data 360-Website-Konnektors definierten Objekts

Example: Incorrect Custom Event Coding
// Event without eventType doesn’t ingest properly
SalesforceInteractions.sendEvent({
  interaction: {
    name: 'Read Article'  // Invalid eventType token naming convention (contains a space)
  }
});

Example: Correct Custom Event Coding
// Event containing explicit eventType
SalesforceInteractions.sendEvent({
  interaction: {
    name: 'Read Article',
    eventType: 'contentEngagement'  // Must match Data 360 schema object
  }
});

Site-Zuordnungen und benutzerdefinierte Attribute

Für die Verwendung benutzerdefinierter Attribute im Data 360-Web-SDK müssen sie in einem Attributobjekt verschachtelt werden.

Im Marketing Cloud Personalization Web SDK können Sie benutzerdefinierte Attribute für Katalogelemente auf der obersten Ebene eines Objekts platzieren. Im Data 360-Web-SDK können Sie alle Standardfelder wie type und id auf der obersten Ebene des catalogObject beibehalten. Alle benutzerdefinierten Attribute auf der obersten Ebene von catalogObject werden jedoch während der Transformation in die Data 360-Nutzlast verworfen.

Example: Marketing Cloud Custom Attribute Coding
// Marketing Cloud Personalization SDK pattern (loses custom attributes in Data 360 Web SDK)
catalog: {
  Product: {
    _id: 'SKU123',
    color: 'red',   // Top-level custom attribute
    size: 'L',      // Top-level custom attribute
    brand: 'Acme'   // Top-level custom attribute
  }
}

Example: Correct Custom Attribute Coding
// Data 360 SDK pattern (required attributes wrapper for custom fields)
interaction: {
  name: SalesforceInteractions.CatalogObjectInteractionName.ViewCatalogObject,
  catalogObject: {
    type: 'Product',
    id: 'SKU123',
    attributes: {   // <-- wrapper for custom fields
      color: 'red',
      size: 'L',
      brand: 'Acme'

Änderungen für Kampagnenantworten

Das Marketing Cloud Personalization Web SDK bietet spezifische Methoden für den programmgesteuerten Zugriff auf serverseitige Kampagnenentscheidungen. Im Data 360 Web SDK sind diese Methoden nicht vorhanden. Stattdessen sollten Sie den Webpersonalisierungs-Manager und Sitemap-Transformatoren verwenden, um Personalisierungsantworten darzustellen.

Der Webpersonalisierungs-Manager (WPM) ist ein visuelles Tool zum Verwalten personalisierter Inhalte auf Websites außerhalb von Salesforce. Sie können dieses Tool verwenden, um personalisierte Erfahrungen zu erstellen und zu aktualisieren, die wann und wo Sie sie wünschen, indem Sie Kundeninteraktionsdaten aus dem Web-SDK verwenden. Sitemap-Transformatoren bieten die Möglichkeit, personalisierte Antworten (z. B. ein Karussell mit Produktempfehlungen oder ein benutzerdefiniertes Hero-Banner) mithilfe von in Ihrer Sitemap definierten lenkerbasierten Vorlagen darzustellen.

Der WPM- und Sitemap-Transformatoransatz wird bevorzugt, da er automatisch Folgendes vornimmt:

• Stellt Inhalte dar und injiziert HTML/CSS mithilfe von Sitemap-Transformatoren nach dem Shadow document object model (DOM) -Kapselungsstandard.
• Verfolgt Impressionen und Klicks, indem an gerenderte Inhalte Verfolgungsmonitore für Statistiken angehängt werden.
• Blendet Seitenelemente beim Laden von Entscheidungen aus und schützt so vor Seitenflimmern.

In Situationen, in denen ein manueller Abruf von Personalisierungsentscheidungen erforderlich ist, stellt das Data 360-Web-SDK SalesforceInteractions.Personalization.fetch() als programmgesteuerte API bereit.

Bei der Auswahl des manuellen Abrufs mithilfe des Abrufansatzes sind Sie für Folgendes verantwortlich:

• Personalisierte Inhalte selbst darstellen
• Manuelles Verfolgen von Anzeige- oder Klick-Engagementereignissen für abgerufene Entscheidungen
• Implementieren von Flimmerschutz (falls erforderlich)

In dieser Tabelle werden die allgemeinen Unterschiede zwischen der getCampaignResponses- und der Personalization.fetch-Methode aufgeführt.

Anforderungen an Sitemap-Inhaltszonen

Inhaltszonen sind vordefinierte Bereiche Ihrer Website, die personalisierten Inhalt empfangen können. Damit Salesforce Personalization ordnungsgemäß funktioniert, müssen für Inhaltszonen sowohl ein Name als auch ein Auswahlwert definiert sein.

// Example: Defined content zones in sitemap for personalization
{
  name: 'Product Detail Page',
  isMatch: () => /\/product\//.test(window.location.pathname),
  contentZones: [
    { name: 'hero_banner', selector: 'div#hero' },
    { name: 'recommendations', selector: 'div#recs-container' }
  ]
}