Procesar propuestas de acciones DOM automáticamente

Utilice este patrón cuando la respuesta de personalización incluya elementos de propuesta con el esquema:

https://ns.adobe.com/personalization/dom-action

Estos elementos suelen incluir un selector y un tipo de acción (por ejemplo, setHtml) que Web SDK puede aplicar automáticamente cuando renderDecisions está habilitado.

​1. Administrar el parpadeo (opcional)

Si necesita evitar el parpadeo mientras se aplica contenido personalizado, utilice el método de administración de parpadeo recomendado para su implementación. Consulte Administrar parpadeo para ver las opciones disponibles.

​2. Solicitar y procesar decisiones anotadas para procesamiento automático

Establezca renderDecisions en true al llamar al comando sendEvent. El valor predeterminado de la propiedad renderDecisions es false cuando se omite.

alloy("sendEvent", {
  renderDecisions: true,
  xdm: {
    web: {
      webPageDetails: {
        name: "home"
      }
    }
  }
});

Opcionalmente, si necesita solicitar ubicaciones específicas, incluya personalization.decisionScopes:

alloy("sendEvent", {
  renderDecisions: true,
  personalization: {
    decisionScopes: ["hero-banner", "recommendations"]
  },
  xdm: { }
});

Vea el objeto personalization en el comando sendEvent para obtener más información.

​3. Mostrar eventos

Si establece renderDecisions en true y establece personalization.sendDisplayEvent en true o lo omite, Web SDK enviará eventos de visualización inmediatamente después de que se represente la personalización.

alloy("sendEvent", {
  renderDecisions: true,
  personalization: {
    // sendDisplayEvent defaults to true when omitted
  },
  xdm: { }
});

Consulte Administrar eventos de visualización para ver opciones alternativas que satisfagan las necesidades de su implementación, como al usar Eventos de página superior e inferior.

​4. Cambios y nueva renderización de la vista SPA

Para aplicaciones de una sola página, incluya viewName en eventos de cambio de vista.

alloy("sendEvent", {
  renderDecisions: true,
  xdm: {
    web: {
      webPageDetails: {
        viewName: "cart"
      }
    }
  }
});

Si la SPA vuelve a procesar la IU para la misma vista sin una nueva recuperación de decisión, puede volver a aplicar las propuestas devueltas anteriormente:

let lastPropositions = [];

alloy("sendEvent", {
  renderDecisions: true,
  xdm: {
    web: { webPageDetails: { viewName: "cart" } }
  }
}).then(({ propositions = [] }) => {
  lastPropositions = propositions;
});

// Later, after a UI re-render:
alloy("applyPropositions", {
  propositions: lastPropositions
});

Consulte applyPropositions para obtener más información.