Plan de site et ingestion de données

Exigences de type d'événement

Les sitemaps Marketing Cloud Personalization utilisent le champ d'action en tant qu'étiquette descriptive (par exemple, Afficher le produit, Ajouter au panier d'achat, etc.) pour faciliter l'identification des événements sur une page. Le kit de développement Web Data 360 utilise interaction.name à cette fin et nécessite également un champ eventType pour déterminer comment l'événement est mappé avec le schéma d'événement de connecteur de site Web.

Lors de l'utilisation de constantes de nom d'interaction standard (par exemple ViewCatalogObject, AddToCart ou Purchase), le kit de développement dérive automatiquement le type d'événement correct.

Cependant, les actions personnalisées (par exemple Lire l'article ou Article partagé) sont correctement ingérées uniquement lorsqu'elles correspondent à un type d'événement valide dans le schéma d'événement Web et respectent les conventions de nommage requises. Pour cette raison, nous recommandons de fournir un interaction.eventType explicite qui correspond à l'objet du schéma d'événement. Alternativement, vous pouvez utiliser une valeur interaction.name qui est également un jeton eventType valide et vous assurer qu'elle correspond à l'objet schema.

• Commencer par une lettre
• Contient uniquement des caractères alphanumériques et des traits de soulignement (sans espace)
• Ne pas se terminer par ou avoir des traits de soulignement consécutifs
• Contient au maximum 80 caractères
• Correspondance d'un objet défini dans le schéma d'événement du connecteur de votre site 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
  }
});

Cartes de site et attributs personnalisés

L'utilisation d'attributs personnalisés dans le kit de développement Web Data 360 nécessite de les imbriquer dans un objet attributes.

Dans le kit de développement Web Marketing Cloud Personalization, vous pouvez placer des attributs personnalisés d'élément de catalogue personnalisé au niveau supérieur d'un objet. Dans le kit de développement Web Data 360, vous pouvez conserver tous les champs standard, tels que type et id, au niveau supérieur catalogObject. Cependant, tous les attributs personnalisés de niveau supérieur de catalogObject sont abandonnés lors de la transformation en charge utile 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'

Modifications des réponses de campagne

Le kit de développement Web Marketing Cloud Personalization fournit des méthodes spécifiques pour accéder par programmation aux décisions de campagne côté serveur. Dans le kit de développement Web Data 360, ces méthodes n'existent pas. À la place, nous recommandons d'utiliser le Gestionnaire de personnalisation Web et les transformateurs de plan de site pour restituer les réponses de personnalisation.

Le Gestionnaire de personnalisation Web (WPM) est un outil visuel qui permet de gérer des contenus personnalisés dans des sites Web non-Salesforce. Vous pouvez utiliser cet outil pour créer et actualiser des expériences personnalisées affichées quand et où vous le souhaitez, en utilisant les données d'interaction des clients du kit de développement Web. Les transformateurs de plan de site permettent de restituer des réponses personnalisées (par exemple, un carrousel de recommandations de produits ou une bannière Hero personnalisée) en utilisant des modèles basés sur le guidon définis dans votre plan de site.

L'approche du transformateur WPM et sitemap est préférée, car elle :

• Renvoie du contenu, en injectant HTML/CSS en utilisant des transformateurs de sitemap en suivant la norme d'encapsulation Shadow Document object model (DOM).
• Suit les impressions et les clics en joignant des moniteurs de suivi « stat » au contenu restitué.
• Masque les éléments de page pendant le chargement des décisions, ce qui protège contre le scintillement de page.

Pour les situations dans lesquelles la récupération manuelle des décisions de personnalisation est requise, le kit de développement Web Data 360 fournit SalesforceInteractions.Personalization.fetch() en tant qu'API programmatique.

Lorsque vous choisissez la récupération manuelle en utilisant l'approche de récupération, vous êtes responsable de :

• Restitution de contenus personnalisés vous-même
• Suivi manuel des événements d'engagement de vues ou de clics pour des décisions récupérées
• Implémentation d’une défense anti-scintillement (si nécessaire)

Le tableau ci-dessous montre les différences générales entre les méthodes de getCampaignResponses et de Personalization.fetch.

Exigences de la zone de contenu du plan de site

Les zones de contenu sont des zones prédéfinies de votre site Web qui peuvent recevoir un contenu personnalisé. Pour que Salesforce Personalization fonctionne correctement, les zones de contenu doivent avoir un nom et une valeur de sélecteur définis.

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