Mappa del sito e inserimento dati

Requisiti del tipo di evento

Le mappe del sito di Personalizzazione di Marketing Cloud utilizzano il campo azione come etichetta descrittiva (ad esempio, Visualizza prodotto, Aggiungi al carrello e così via) per identificare ciò che accade in una pagina. Data 360 Web SDK utilizza interaction.name per questo scopo e richiede anche un campo eventType per determinare in che modo l'evento viene mappato allo schema degli eventi del connettore del sito Web.

Quando si utilizzano le costanti nome interazione standard (ad esempio ViewCatalogObject, AddToCart o Purchase), l'SDK deriva automaticamente il tipo di evento corretto.

Tuttavia, le azioni personalizzate (ad esempio, Lettura articolo o Articolo condiviso) vengono inserite correttamente solo quando corrispondono a un tipo di evento valido nello schema dell'evento Web e seguono le convenzioni di denominazione richieste. Per questo motivo, si consiglia di fornire un interaction.eventType esplicito che corrisponda all'oggetto schema dell'evento. In alternativa, è possibile utilizzare un valore interaction.name che è anche un token eventType valido e assicurarsi che corrisponda all'oggetto schema.

• Iniziare con una lettera
• Contenere solo caratteri alfanumerici e di sottolineatura (senza spazi)
• Non terminare con o avere caratteri di sottolineatura consecutivi
• Contenere un massimo di 80 caratteri
• Corrispondenza di un oggetto definito nello schema degli eventi del connettore del sito Web Data 360

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
  }
});

Mappe del sito e attributi personalizzati

L'utilizzo degli attributi personalizzati in Data 360 Web SDK richiede la loro nidificazione in un oggetto attributi.

In Marketing Cloud Personalizzazione Web SDK è possibile posizionare gli attributi personalizzati degli elementi catalogo personalizzati al livello superiore di un oggetto. In Data 360 Web SDK è possibile mantenere qualsiasi campo standard, ad esempio type e id, al livello massimo catalogObject. Tuttavia, tutti gli attributi personalizzati al livello massimo di catalogObject vengono eliminati durante la trasformazione nel payload di Data 360.

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'

Modifiche per le risposte alle campagne

Marketing Cloud Personalizzazione Web SDK ha fornito metodi specifici per accedere a livello di programmazione alle decisioni delle campagne lato server. In Data 360 Web SDK, questi metodi non esistono. Si consiglia invece di utilizzare il Gestore personalizzazioni Web e i trasformatori della mappa del sito per visualizzare le risposte alle personalizzazioni.

Il Gestore personalizzazioni Web (WPM) è uno strumento visivo per la gestione di contenuti personalizzati sui siti Web non Salesforce. È possibile utilizzare questo strumento per creare e aggiornare esperienze personalizzate che vengono visualizzate quando e dove si desidera, utilizzando i dati di interazione con i clienti dall'SDK Web. I trasformatori mappa del sito consentono di visualizzare risposte personalizzate (ad esempio, un carosello di consigli sui prodotti o un banner hero personalizzato) utilizzando modelli basati su manubri definiti nella mappa del sito.

L'approccio al trasformatore WPM e mappa del sito è preferito perché:

• Renderizza il contenuto, inserendo HTML/CSS utilizzando trasformatori della mappa del sito che seguono lo standard di incapsulamento del modello di oggetto documento Shadow (DOM).
• Monitora le impressioni e i clic allegando monitor di tracciamento "statistico" al contenuto visualizzato.
• Nasconde gli elementi di pagina durante il caricamento delle decisioni, difendendosi dallo sfarfallio della pagina.

Per le situazioni in cui è necessario recuperare manualmente le decisioni di personalizzazione, Data 360 Web SDK fornisce SalesforceInteractions.Personalization.fetch() come API di programmazione.

Quando si sceglie il recupero manuale utilizzando l'approccio di recupero, si è responsabili di:

• Rendering di contenuti personalizzati
• Monitoraggio manuale di eventuali eventi di coinvolgimento con visualizzazioni o clic per le decisioni recuperate
• Implementazione di eventuali difese antisfarfallio (se necessario)

Questa tabella evidenzia le differenze generali tra il metodo di getCampaignResponses e il metodo di Personalization.fetch.

Requisiti delle zone di contenuto della mappa del sito

Le zone contenuto sono aree predefinite del sito Web che possono ricevere contenuti personalizzati. Perché Personalizzazione Salesforce funzioni correttamente, le zone di contenuto devono avere sia un nome che un valore selettore definiti.

// 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' }
  ]
}