DocumentazioneMarketo EngageGuida di Marketo

Funzioni callback

Ultimo aggiornamento: 22 luglio 2024
  • Argomenti:
  • Chat dinamica

Puoi utilizzare le funzioni di callback dei widget di Dynamic Chat per inviare eventi di conversazione a qualsiasi piattaforma di terze parti.

Guida introduttiva

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

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

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

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:

Metadati
Attributi
Nome conversazione
payload.name
ID conversazione
payload.id
Tipo di conversazione (flusso di conversazione)
payload.type
Tipo di interfaccia utente (popup/chatbot/inline)
payload.uiType
ID sessione
payload.sid

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

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

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:

Metadati
Attributi
Nome conversazione
payload.name
ID conversazione
payload.id
Tipo di conversazione (flusso di conversazione)
payload.type
Tipo di interfaccia utente (popup/chatbot/inline)
payload.uiType
ID sessione
payload.sid

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

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:

Metadati
Attributi
Nome conversazione
payload.name
ID conversazione
payload.id
Tipo di conversazione (flusso di conversazione)
payload.type
Tipo di interfaccia utente (popup/chatbot/inline)
payload.uiType
ID sessione
payload.sid
Nome agente
payload.agentName
ID agente
payload.agentID
Informazioni riunione
payload.meetingInfo

Eventi chat in diretta

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

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

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

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

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:

Metadati
Attributi
Nome conversazione
payload.name
ID conversazione
payload.id
Tipo di conversazione (flusso di conversazione)
payload.type
Tipo di interfaccia utente (popup/chatbot/inline)
payload.uiType
ID sessione
payload.sid
Nome agente
payload.agentName
ID agente
payload.agentID

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,
    });
    });
});
recommendation-more-help
94ec3174-1d6c-4f51-822d-5424bedeecac