Mapa de sitio e ingreso de datos

Requisitos de tipo de evento

Los mapas de sitio de Personalización de Marketing Cloud utilizan el campo de acción como una etiqueta descriptiva (por ejemplo, Ver producto, Agregar al carrito, etc.) para ayudar a identificar lo que sucede en una página. El SDK web de Data 360 utiliza interaction.name para este fin, y también requiere un campo eventType para determinar cómo se asigna el evento al esquema de evento del conector del sitio web.

Al utilizar constantes de nombre de interacción estándar (por ejemplo, ViewCatalogObject, AddToCart o Purchase), el SDK deriva automáticamente el tipo de evento correcto.

Sin embargo, las acciones personalizadas (por ejemplo, Leer artículo o Artículo compartido) ingresan correctamente solo cuando coinciden con un tipo de evento válido en el esquema de eventos web y siguen las convenciones de nomenclatura requeridas. Por este motivo, recomendamos proporcionar un interaction.eventType explícito que coincida con el objeto de esquema de evento. También puede utilizar un valor interaction.name que también sea un token eventType válido y asegurarse de que coincide con el objeto de esquema.

• Comience por una letra
• Contienen solo caracteres alfanuméricos y guiones bajos (sin espacios)
• No terminar con o tener guiones bajos consecutivos
• Contiene un máximo de 80 caracteres
• Hacer coincidir un objeto definido en su esquema de evento de conector de sitio web de 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
  }
});

Mapas de sitio y atributos personalizados

El uso de atributos personalizados en el SDK web de Data 360 requiere anidarlos en un objeto de atributos.

En el SDK web de personalización de Marketing Cloud, puede colocar atributos personalizados de elementos de catálogo personalizados en el nivel superior de un objeto. En el SDK web de Data 360, puede mantener cualquier campo estándar, como type e id, en el nivel superior de catalogObject. Sin embargo, cualquier atributo personalizado en el nivel superior de catalogObject se descarta durante la transformación a la carga de 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'

Cambios para respuestas de campaña

El SDK web de personalización de Marketing Cloud proporcionaba métodos específicos para acceder programáticamente a decisiones de campaña del lado del servidor. En el SDK web de Data 360, estos métodos no existen. En su lugar, recomendamos utilizar el Gestor de personalización web y transformadores de mapa de sitio para representar respuestas de personalización.

El Gestor de personalización web (WPM) es una herramienta visual para gestionar contenido personalizado en sitios web que no son de Salesforce. Puede utilizar esta herramienta para crear y actualizar experiencias personalizadas que aparecen cuando y donde las desee, utilizando datos de interacciones de clientes desde el SDK web. Los transformadores de mapa de sitio proporcionan la capacidad de representar respuestas personalizadas (por ejemplo, un carrusel de recomendaciones de productos o una pancarta de héroe personalizada) utilizando plantillas basadas en el manillar definidas en su mapa de sitio.

Se prefiere el enfoque de WPM y el transformador de mapa de sitio porque:

• Representa contenido, inyectando HTML/CSS utilizando transformadores de mapa de sitio siguiendo el estándar de encapsulación del modelo de objetos de documentos (DOM) Shadow.
• Realiza un seguimiento de impresiones y clics adjuntando monitores de seguimiento “stat” a contenido representado.
• Oculta elementos de página mientras se cargan las decisiones, defendiéndose del parpadeo de la página.

Para situaciones donde se requiere la recuperación manual de decisiones de personalización, el SDK web de Data 360 proporciona SalesforceInteractions.Personalization.fetch() como una API programática.

Al seleccionar la recuperación manual utilizando el enfoque de obtención, usted es responsable de:

• Representación de contenido personalizado usted mismo
• Realizar un seguimiento manual de cualquier evento de implicación de visualización o clic para decisiones recuperadas
• Implementación de cualquier defensa contra parpadeo (si es necesario)

Esta tabla indica las diferencias generales entre los métodos getCampaignResponses y Personalization.fetch.

Requisitos de zona de contenido de mapa de sitio

Las zonas de contenido son áreas predefinidas de su sitio web que pueden recibir contenido personalizado. Para que Personalización de Salesforce funcione correctamente, las zonas de contenido deben tener un nombre y un valor de selector definidos.

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