Procesar propuestas manualmente
Utilice este patrón cuando necesite un control total sobre cómo se aplican los elementos de la propuesta. Por ejemplo, está creando una interfaz de usuario compleja a partir del contenido JSON o desea aplicar reglas empresariales personalizadas antes del procesamiento.
1. Solicitar propuestas
alloy("sendEvent", {
personalization: {
decisionScopes: ["salutation", "discount"]
},
xdm: { }
}).then(({ propositions = [] }) => {
// Render in the next step
});
Vea el objeto personalization en el comando sendEvent para obtener más información.
2. Procesar elementos de propuesta (ejemplo)
Al procesar propuestas manualmente, pueden adoptar muchos formularios o formas diferentes. El siguiente es un ejemplo mínimo que busca una propuesta por ámbito y, a continuación, aplica el primer elemento de contenido de HTML que encuentra.
function findPropositionByScope(propositions, scope) {
return propositions.find((p) => p.scope === scope);
}
function renderHtmlInto(selector, html) {
const el = document.querySelector(selector);
if (!el) return;
el.innerHTML = html;
}
alloy("sendEvent", {
personalization: { decisionScopes: ["discount"] },
xdm: { }
}).then(({ propositions = [] }) => {
const discount = findPropositionByScope(propositions, "discount");
if (!discount) return { propositions, rendered: [] };
const htmlItem = discount.items?.find(
(i) => i.schema === "https://ns.adobe.com/personalization/html-content-item"
);
if (!htmlItem) return { propositions, rendered: [] };
renderHtmlInto("#daily-special", htmlItem.data.content);
return { propositions, rendered: [discount] };
});
3. Registre eventos de visualización para lo que ha procesado
Para las propuestas procesadas manualmente, los eventos de visualización se registran a través de sendEvent llamadas que hacen referencia a las propuestas procesadas.
function toDisplayPayload(propositions) {
return propositions.map((p) => ({
id: p.id,
scope: p.scope,
scopeDetails: p.scopeDetails
}));
}
// Example: record display for the propositions you actually rendered.
alloy("sendEvent", {
xdm: {
_experience: {
decisioning: {
propositions: toDisplayPayload(renderedPropositions),
propositionEventType: { display: 1 }
}
}
}
});
Consulte Administrar eventos de visualización para obtener más información.
4. Nueva renderización
Cuando los cambios en la IU requieran un nuevo procesamiento, ejecute de nuevo la lógica de procesamiento manual con los datos de la propuesta que ha almacenado en caché (o recupere si es necesario). Si necesita registrar una pantalla para escenarios de nuevo procesamiento, consulte Administrar eventos de visualización.