Rendering automatico delle proposte di azioni DOM

Utilizza questo modello quando la risposta di personalizzazione include elementi di proposta con lo schema:

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

Questi elementi includono in genere un selettore e un tipo di azione (ad esempio, setHtml) che il Web SDK può applicare automaticamente quando renderDecisions è abilitato.

​1. Gestire la visualizzazione momentanea di altri contenuti (facoltativo)

Per evitare sfarfallii durante l’applicazione di contenuti personalizzati, utilizza l’approccio di gestione consigliato per la visualizzazione momentanea di altri contenuti per l’implementazione. Consulta Gestire la visualizzazione momentanea di altri contenuti per informazioni sulle opzioni disponibili.

​2. Richiedere e rendere note le decisioni per il rendering automatico

Impostare renderDecisions su true quando si chiama il comando sendEvent. Se omessa, la proprietà renderDecisions viene impostata automaticamente su false.

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

Facoltativamente, se devi richiedere posizionamenti specifici, includi personalization.decisionScopes:

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

Per ulteriori informazioni, vedere l'oggetto personalization nel comando sendEvent.

​3. Eventi di visualizzazione

Se si imposta renderDecisions su true e si imposta personalization.sendDisplayEvent su true o lo si omette, Web SDK invia gli eventi di visualizzazione subito dopo il rendering della personalizzazione.

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

Consulta Gestisci eventi di visualizzazione per le opzioni alternative che soddisfano le esigenze dell'implementazione, ad esempio quando utilizzi eventi di pagina superiore e inferiore.

​4. Modifiche alla vista dell’applicazione a pagina singola e nuovo rendering

Per le applicazioni a pagina singola, includere viewName sugli eventi di modifica della visualizzazione.

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

Se l’applicazione a pagina singola esegue nuovamente il rendering dell’interfaccia utente per la stessa visualizzazione senza un nuovo recupero delle decisioni, puoi riapplicare le proposte restituite in precedenza:

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
});

Per ulteriori informazioni, vedere applyPropositions.