Funzioni callback callback-functions
Puoi utilizzare le funzioni di callback dei widget di Dynamic Chat per inviare eventi di conversazione a qualsiasi piattaforma di terze parti.
Guida introduttiva getting-started
Questo evento indica che il widget del Dynamic Chat è pronto per l'uso e viene attivato quando tutti gli script relativi al Dynamic Chat vengono caricati nella pagina Web.
window.addEventListener('adobedx.conversations.ready', () => {
// code here will execute when chatbot scripts are loaded in a webpage
});
Eventi di conversazione conversation-events
Questi eventi sono correlati a una conversazione con targeting su una pagina specifica per un visitatore specifico.
Conversazione attivata
Viene risolta una conversazione (ad esempio, un dialogo) destinata a un visitatore del sito web e viene mostrato il chatbot.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_TRIGGERED, (event) => {
// code here will execute when the chatbot is loaded for a visitor
});
});
Conversazione coinvolta conversation-engaged
Il visitatore ingaggiato (ad esempio, ha fornito la sua prima risposta) con il chatbot.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_ENGAGED, (event) => {
// code here will execute when a visitor engages with the chatbot
});
});
Conversazione completata conversation-completed
Il visitatore ha raggiunto la fine della conversazione.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_COMPLETED, (event) => {
// code here will execute when a conversation is completed
});
});
Conversazione chiusa
Il visitatore ha chiuso la conversazione prima di raggiungere la fine.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_CLOSED, (event) => {
// code here will execute when a conversation is closed
});
});
Il parametro event
è un oggetto con metadati relativi alla conversazione. È possibile accedere a questi metadati accedendo a event.data
.
Di seguito sono riportati alcuni valori di metadati chiave a cui è possibile accedere:
Eventi di input visitatore
Questi eventi vengono attivati quando un visitatore che partecipa a una conversazione fornisce le sue informazioni di contatto (ad esempio, numero di telefono o indirizzo e-mail). Di seguito sono riportati gli eventi che rientrano in questa categoria.
Numero di telefono phone-number
Questo evento viene attivato quando un visitatore fornisce il proprio numero di telefono durante la conversazione.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_INPUT_PHONE, (event) => {
// code here will execute when a visitor provides their phone number
});
});
ID e-mail email-id
Questo evento viene attivato quando un visitatore fornisce il proprio indirizzo e-mail durante la conversazione.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_INPUT_EMAIL, (event) => {
// code here will execute when a visitor provides their email address
});
});
Il parametro event
è un oggetto con metadati relativi alla conversazione. È possibile accedere a questi metadati accedendo a event.data
.
Di seguito sono riportati alcuni valori di metadati chiave a cui è possibile accedere:
Meeting Booking Events meeting-booking-events
Questi eventi vengono attivati quando un visitatore registra una riunione con il tuo rappresentante commerciale.
Di seguito sono riportati gli eventi che rientrano in questa categoria.
Riunione prenotata meeting-booked
Questo evento viene attivato quando un visitatore registra una riunione nel calendario di un agente.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_MEETING_BOOKED, (event) => {
// code here will execute when a meeting is booked
});
});
Il parametro event
è un oggetto con metadati relativi alla conversazione. È possibile accedere a questi metadati accedendo a event.data
.
Di seguito sono riportati alcuni valori di metadati chiave a cui è possibile accedere:
Eventi chat in diretta live-chat-events
Questi eventi vengono attivati quando un visitatore si connette con un agente live durante il suo coinvolgimento con il chatbot.
Di seguito sono riportati gli eventi che rientrano in questa categoria.
Richiesta chat in diretta live-chat-requested
Questo evento viene attivato quando un visitatore seleziona l’opzione per chattare con un agente live e un agente disponibile viene risolto.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_LIVE_CHAT_REQUESTED, (event) => {
// code here will execute when a visitor requests a live chat
});
});
Chat in tempo reale avviata live-chat-initiated
Questo evento viene attivato quando un visitatore seleziona l’opzione per chattare con un agente live e un agente accetta la chat.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_LIVE_CHAT_INITIATED, (event) => {
// code here will execute after a live agent accepts the chat
});
});
Chat in tempo reale terminata live-chat-ended
Questo evento viene attivato al termine di una conversazione tra un visitatore e l’agente live.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_LIVE_CHAT_ENDED, (event) => {
// code here will execute when a live chat is ended
});
});
Timeout chat in tempo reale live-chat-timeout
Questo evento viene attivato quando una conversazione live chat scade perché il visitatore non risponde più o perché il visitatore non risponde più.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_LIVE_CHAT_REQUEST_TIMEOUT, (event) => {
// code here will execute when a visitor abandons a live chat
});
});
Il parametro event
è un oggetto con metadati relativi alla conversazione. È possibile accedere a questi metadati accedendo a event.data
.
Di seguito sono riportati alcuni valori di metadati chiave a cui è possibile accedere:
Se desideri inviare uno di questi eventi a una piattaforma di analisi come Adobe Analytics o Google Analytics, devi aggiungere la rispettiva chiamata di tracciamento all'interno di questi eventi di Dynamic Chat. Avrebbe un aspetto simile all’esempio di seguito.
window.addEventListener('adobedx.conversations.ready', () => {
const {addListener, Enum} = window.AdobeDX;
addListener(Enum.Events.CONVERSATION_TRIGGERED, (event) => {
// Enter Adobe Analytics or Google Analytics function here
ga('send', 'event', {
eventCategory: Dynamic Chat Conversations',
eventAction: 'Conversation Triggered',
eventLabel: event.data.payload.id,
});
});
});