personalization

L'oggetto personalization configura le decisioni di personalizzazione (offerte o proposte) richieste e il modo in cui vengono gestite nella richiesta e nella risposta. È particolarmente utile nelle implementazioni di Adobe Target o Adobe Journey Optimizer, in quanto è la forza motrice che consente di personalizzare il contenuto visualizzato per utente.

alloy("sendEvent", {
  personalization: {
    decisionScopes: ["hero-banner"],
    surfaces: ["web://example.com"],
    schemas: ["https://ns.adobe.com/personalization/dom-action"],
    sendDisplayEvent: true,
    sendDisplayNotifications: true,
    includePendingDisplayNotifications: true,
    defaultPersonalizationEnabled: false
  },
  renderDecisions: true,
  xdm: adobeDataLayer.getState(reference)
});

L'oggetto personalization contiene le proprietà seguenti:

personalization.decisionScopes

La proprietà decisionScopes è un array di stringhe che indica al Web SDK di recuperare e restituire le decisioni di personalizzazione. Ogni elemento dell’array identifica una posizione, un contesto o un posizionamento logico in cui desideri contenuti personalizzati.

Questa proprietà è utile quando desideri recuperare in modo esplicito contenuti personalizzati per aree o componenti specifici di una pagina. È particolarmente utile nelle applicazioni a pagina singola che potrebbero richiedere set diversi di offerte quando l’utente cambia la navigazione o la visualizzazione. Puoi inoltre utilizzare questa proprietà per ottimizzare le prestazioni recuperando solo le offerte per gli elementi dell’interfaccia utente rilevanti per l’utente.

personalization: {
  decisionScopes: ["hero-banner", "cart-offer"]
}

In Adobe Target, ogni ambito decisionale è associato a una mbox o a un’attività. In Adobe Journey Optimizer, ogni ambito decisionale è associato a posizionamenti o campagne di contenuti web basati su decisioni. In Offer Decisioning, gli ambiti decisionali corrispondono a quali offerte o proposte deve ricevere il visitatore.

personalization.surfaces

La proprietà surfaces è una matrice di stringhe URI di superficie che definiscono manualmente il canale, il dispositivo o il contesto da cui è richiesta la personalizzazione. Consentono di distinguere tra diverse esperienze digitali, come domini, app o piattaforme di dispositivi all’interno dell’ecosistema cross-channel. Per impostazione predefinita, la libreria deduce la superficie predefinita dalla pagina corrente. È possibile utilizzare questa proprietà per sostituire la superficie derivata automaticamente per la pagina corrente.

Questa proprietà è utile quando desideri utilizzare la personalizzazione tra canali e deve distinguere il funzionamento della personalizzazione tra canali separati. Consente di creare offerte distinte per siti diversi nella stessa organizzazione Adobe Experience Platform.

personalization: {
  surfaces: ["web://example.com", "web://support.example.com/contact"]
}

Questa proprietà è utilizzata in modo fondamentale con Adobe Journey Optimizer, in quanto corrisponde alle superfici impostate nelle campagne Journey Optimizer e nella gestione delle superfici.

personalization.schemas

La proprietà schemas è un array di stringhe URI di schema che filtrano i tipi di contenuto di personalizzazione richiesti da Edge Network. L’impostazione di questa proprietà limita la risposta ricevuta da Adobe all’inclusione di offerte che corrispondono alle definizioni dei tipi di contenuto specificate. Se omesso, la libreria richiede offerte di tutti gli schemi disponibili per gli ambiti o le superfici corrispondenti.

Questa proprietà consente di ottimizzare la dimensione della risposta e assicura che il sito web o l’applicazione ricevano solo i tipi di offerta che possono essere gestiti. È utile anche con applicazioni a pagina singola che eseguono il rendering del contenuto personalizzato in un modo specifico, ad esempio utilizzando solo azioni DOM o solo oggetti JSON.

personalization: {
  schemas: [
    "https://ns.adobe.com/personalization/dom-action",
    "https://ns.adobe.com/personalization/html-content-item"
  ]
}

Sono supportati i seguenti URI di schema:

personalization.sendDisplayEvent

La proprietà sendDisplayEvent è un valore booleano che determina se un evento di notifica della visualizzazione viene inviato automaticamente all'Edge Network subito dopo il rendering del contenuto personalizzato sulla pagina. Se omesso, il valore predefinito è true. Imposta questa variabile su false se non vuoi indicare che è stato eseguito il rendering del contenuto personalizzato per il tracciamento delle impression.

Il caso d'uso più comune per l'impostazione di questa variabile su false si verifica quando si prevede di inviare un altro comando in un'altra posizione nell'implementazione che contrassegna un evento di visualizzazione. Alcune implementazioni hanno sia eventi impression che eventi Analytics; questa proprietà ti offre il controllo completo su quali sendEvent comandi incrementano le impression.

personalization: {
  sendDisplayEvent: true
}

personalization.includePendingDisplayNotifications

La proprietà includePendingDisplayNotifications è un valore booleano che controlla se le notifiche di visualizzazione in sospeso sono raggruppate nella chiamata sendEvent corrente. Le notifiche di visualizzazione in sospeso rappresentano impression per contenuti personalizzati di cui è stato eseguito il rendering, ma che non sono ancora stati segnalati ad Edge Network come evento di visualizzazione. Questa proprietà è utile quando si utilizzano applicazioni a pagina singola, in quanto il rendering del contenuto personalizzato e le chiamate sendEvent potrebbero essere asincrone l'una rispetto all'altra.

Il valore predefinito per questa proprietà è false. Impostare questa proprietà su true se si desidera eseguire il batch e il flushing di tutte le notifiche di visualizzazione in sospeso in modo che le relative impression vengano registrate con precisione. In genere, per l’implementazione sincrona, come i siti web tradizionali, non è necessario impostare questa proprietà.

personalization: {
  includePendingDisplayNotifications: true
}

personalization.defaultPersonalizationEnabled

La proprietà defaultPersonalizationEnabled è un valore booleano che consente di controllare in modo esplicito il modo in cui il Web SDK richiede l'ambito di personalizzazione predefinito a livello di pagina (__view__) e la superficie per questo comando sendEvent. Per impostazione predefinita, al primo comando sendEvent dopo il caricamento di una pagina, Web SDK richiede offerte per l'ambito di personalizzazione predefinito a livello di pagina e le superfici associate. I comandi sendEvent successivi non richiedono la personalizzazione predefinita. È possibile utilizzare questa proprietà per ignorare tale comportamento. È utile nelle implementazioni di applicazioni a pagina singola, dove potresti voler richiedere nuovamente la personalizzazione predefinita mentre l’utente naviga nel tuo sito. È inoltre possibile utilizzare questa proprietà quando si desidera solo inviare un evento di visualizzazione senza duplicare il recupero delle offerte.

personalization: {
  defaultPersonalizationEnabled: false
}

Questa proprietà utilizza la logica seguente a seconda di come viene impostata:

Componenti Personalization tramite l’estensione tag Web SDK

L'equivalente dell'estensione tag Web SDK di questa proprietà è la sezione Personalization durante la configurazione di un'azione 'Send event'.