Mapa do site e ingestão de dados

Requisitos de tipo de evento

Os mapas do site de Personalização do Marketing Cloud usam o campo de ação como um rótulo descritivo (por exemplo, Exibir produto, Adicionar ao carrinho etc.) para ajudar a identificar o que acontece em uma página. O SDK da Web do Data 360 usa interaction.name para essa finalidade e também requer um campo eventType para determinar como o evento é mapeado para o esquema de evento do conector do site.

Ao usar constantes de nome de interação padrão (por exemplo, ViewCatalogObject, AddToCart ou Purchase), o SDK deriva automaticamente o tipo de evento correto.

No entanto, ações personalizadas (por exemplo, Ler artigo ou Artigo compartilhado) são ingeridas corretamente apenas quando correspondem a um tipo de evento válido no esquema de evento da Web e seguem as convenções de nomenclatura necessárias. Por isso, recomendamos fornecer um interaction.eventType explícito que corresponda ao objeto de esquema de evento. Como alternativa, você pode usar um valor interaction.name que também seja um token eventType válido e garantir que corresponda ao objeto de esquema.

• Começar com uma letra
• Contém apenas caracteres alfanuméricos e sublinhados (sem espaços)
• Não termina com ou tem sublinhados consecutivos
• Contém no máximo 80 caracteres
• Corresponder um objeto definido no esquema de evento do conector do site do 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 do site e atributos personalizados

Usar atributos personalizados no SDK da Web do Data 360 exige aninhá-los em um objeto de atributos.

No SDK da Web de Personalização do Marketing Cloud, você pode colocar atributos personalizados de item de catálogo personalizado no nível superior de um objeto. No SDK da Web do Data 360, você pode manter qualquer campo padrão, como type e id, no nível superior catalogObject. No entanto, todos os atributos personalizados no nível superior de catalogObject são eliminados durante a transformação para a carga útil do 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'

Alterações nas respostas da campanha

O SDK da Web de Personalização do Marketing Cloud forneceu métodos específicos para acessar de modo programático decisões de campanha no lado do servidor. No SDK da Web do Data 360, estes métodos não existem. Em vez disso, recomendamos usar o gerenciador de personalização da Web e transformadores de mapa do site para renderizar respostas de personalização.

O Gerenciador de Personalização da Web (WPM) é uma ferramenta visual para gerenciar conteúdo personalizado em sites que não sejam da Salesforce. Você pode usar essa ferramenta para criar e atualizar experiências personalizadas que aparecem quando e onde desejar, usando dados de interação com o cliente do SDK da Web. Os transformadores de mapa do site oferecem a capacidade de renderizar respostas personalizadas (por exemplo, um carrossel de recomendações de produto ou um banner de herói personalizado) usando modelos baseados em controles definidos no mapa do site.

A abordagem do transformador de mapa do site e WPM é preferida porque:

• Renderiza conteúdo, injetando HTML/CSS usando transformadores de mapa do site seguindo o padrão de encapsulamento de modelo de objeto de documento (DOM) de sombra.
• Rastreia impressões e cliques anexando monitores de rastreamento "stat" ao conteúdo renderizado.
• Oculta elementos de página enquanto as decisões são carregadas, protegendo contra piscar de página.

Para situações em que a recuperação manual de decisões de personalização é necessária, o SDK da Web do Data 360 fornece SalesforceInteractions.Personalization.fetch() como uma API programática.

Ao escolher a recuperação manual usando a abordagem de busca, você é responsável por:

• Renderizar conteúdo personalizado você mesmo
• Rastrear manualmente qualquer evento de engajamento de visualização ou clique para decisões buscadas
• Implementar qualquer proteção de piscar (se necessário)

Esta tabela apresenta as diferenças gerais entre os métodos getCampaignResponses e os Personalization.fetch.

Requisitos de zona de conteúdo do mapa do site

As zonas de conteúdo são áreas predefinidas do seu site que podem receber conteúdo personalizado. Para que a Personalização do Salesforce funcione corretamente, as zonas de conteúdo devem ter um nome e um valor seletor 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' }
  ]
}