Posticipare l'attivazione degli eventi

Importante

A partire dal 20 settembre 2023 non sarà possibile creare nuove risorse di Personalizza esperienze. Il servizio Personalizza esperienze verrà ritirato il 1° ottobre 2026.

L'attivazione posticipata degli eventi consente di creare siti Web o campagne di messaggi di posta elettronica personalizzati, considerando che gli utenti potrebbero non vederli mai. In questi scenari, l'applicazione potrebbe dover chiamare l’API Classifica prima di sapere se il risultato verrà usato o mostrato agli utenti. Se un contenuto non viene mai mostrato agli utenti, non deve essere presupposta alcuna ricompensa per questo da cui imparare (in genere zero). L'attivazione posticipata consente di usare i risultati di una chiamata all’API Classifica in un determinato momento e di decidere se si deve apprendere dall’evento successivamente o altrove nel codice.

Scenari tipici per l'attivazione posticipata

L'attivazione posticipata degli eventi è utile negli scenari di esempio seguenti:

  • Si esegue il pre-rendering di una pagina Web personalizzata per utenti che però potrebbero non vederla mai perché una logica di business potrebbe ignorare la scelta dell'azione di personalizza esperienze.
  • Si personalizza il contenuto in una pagina Web oltre le dimensioni della finestra degli utenti ed è altamente probabile che non venga mai visualizzato.
  • Si personalizzano i messaggi di posta elettronica di marketing ed è necessario evitare il training da quelli che non sono mai stati aperti dagli utenti.
  • È stato personalizzato un canale di contenuti multimediali dinamico e gli utenti potrebbero smettere di guardarlo prima che raggiunga brani o video selezionati da personalizza esperienze.

In generale, questi scenari si verificano quando:

  • Si sta eseguendo il pre-rendering dell'interfaccia utente che gli utenti potrebbero visualizzare o non visualizzare a causa di vincoli di tempo o dell’interfaccia utente.
  • L'applicazione esegue la personalizzazione predittiva in cui si effettuano chiamate all’API Classifica prima di sapere se si userà l'output.

Come posticipare l'attivazione e, successivamente, attivare gli eventi

Per posticipare l'attivazione per un evento, chiamare Classifica con deferActivation = True nel corpo della richiesta.

Non appena si è consapevoli che agli utenti sono stati mostrati i contenuti o i file multimediali personalizzati e si prevede che una ricompensa sia ragionevole, è necessario attivare tale evento. A tale scopo, chiamare l’API Attiva con eventId.

La chiamata all’API Attiva per la chiamata con eventId deve essere ricevuta prima che scada l'intervallo di tempo di attesa della ricompensa.

Comportamento con attivazione posticipata

Personalizza esperienze imparerà dagli eventi e dalle ricompense come indicato di seguito:

  • Se si chiama l’API Classifica con deferActivation = True, non si chiama l'API Activate per tale eventId e quindi si chiama l’API Ricompensa, personalizza esperienze non apprenderà dall'evento.
  • Se si chiama l’API Classifica con deferActivation = True, si chiama l'API Activate per tale eventId e quindi si chiama l’API Ricompensa, personalizza esperienze apprenderà dall'evento con il punteggio di ricompensa specificato.
  • Se si chiama l’API Classifica con deferActivation = True, si chiama l'API Activate per tale eventId, ma si omette la chiamata all’API Ricompensa, personalizza esperienze apprenderà dall'evento con il punteggio di ricompensa predefinito impostato nella configurazione.

Passaggi successivi