Informazioni sull'API di Interact

La configurazione di Interact per utilizzare il proprio touchpoint prevede due componenti principali:

La configurazione di Interact nell'ambiente di progettazione.

La configurazione del touchpoint per l'uso con l'ambiente runtime utilizzando l'API di Interact.

Questi due componenti della configurazione, sebbene agiscono in due aree diverse, sono correlati. L'API di Interact deve fare riferimento a diversi elementi di configurazione all'interno dell'ambiente di progettazione. Concordare con la persona che utilizza l'API di Interact le convenzioni di denominazione, lo scopo degli elementi e così via. Questo è un processo iterativo e collaborativo. Come persona che lavora sia con l'API di Interact che con il touchpoint, è possibile che sia necessario creare più eventi e punti di interazione. Man mano che si progetta l'interazione nell'ambiente di progettazione, è possibile che si identifichino altri requisiti per la persona che lavora con l'API.

Esistono diversi elementi della configurazione di Interact utilizzati dall'API di Interact. Tuttavia, solo i seguenti tre elementi sono riportati per nome:

canali interattivi

punti di interazione

eventi

Quando si utilizza l'API di Interact, occorre fare riferimento a questi elementi per nome. I nomi devono corrispondere, tuttavia, non fanno distinzione tra maiuscole e minuscole. I nomi myinteract, myInteract e mYiNtErAcT sono tutti corrispondenti.

Esistono altri elementi della configurazione di Interact che è possibile utilizzare nell'API di Interact per migliorare l'interazione, inclusi segmenti dinamici, date di inizio e fine campagna e diagrammi di flusso interattivi.

Durante l'esecuzione, l'API di Interact richiede informazioni dai diagrammi di flusso interattivi e regole di trattamento, seppure indirettamente. Ad esempio, l'API non richiama mai un diagramma di flusso interattivo. Tuttavia, l'API richiama un evento che richiede un risegmentazione, che esegue tutti i diagrammi di flusso interattivi associati al canale interattivo. Allo stesso modo, quando l'API richiede offerte con il metodo getOffers, avvia una sequenza di eventi che include il riferimento a regole di trattamento.

L'API di Interact fa riferimento ai seguenti elementi di Campaign:

ID destinatari

Livello destinatari

Attributi delle offerte personalizzate

Codice offerta

Descrizione offerta

Data effettiva offerta

Data di scadenza offerta

Nome offerta

Codice trattamento offerta

Poiché questi elementi sono condivisi in tutto l'ambiente di progettazione, occorre definire standard per questi elementi in tutta l'organizzazione. Alcune di queste informazioni devono essere fornite per chiamare correttamente l'API di Interact, ad esempio l'ID destinatari, e alcune vengono richieste con l'API, ad esempio gli attributi dell'offerta.

È anche possibile fare riferimento al punteggio per un'offerta con l'API di Interact. In generale, questo è il punteggio marketing assegnato nella scheda della strategia di interazione. Questo punteggio è rilevante solo per Interact, non per l'intero ambiente Campaign. È possibile modificare o annullare il punteggio marketing dalla scheda della strategia di interazione. Per ulteriori informazioni sull'API di Interact, vedere la Interact Administrator's Guide.

Interact runtime

Nella seguente sezione viene fornita una breve panoramica di quanto accade sul server runtime durante un'interazione.

Quando una sessione runtime viene avviata, ossia quando il visitatore stabilisce un contatto, l'API di Interact attiva una chiamata startSession. Questa chiamata può includere le seguenti operazioni.

1.	Creare una nuova sessione runtime.

Una sessione runtime è un'istanza del server runtime che contiene tutti i dati associati al visitatore. Sono inclusi tutti i dati noti del profilo e i risultati di qualsiasi richiesta inviata al server runtime, quale appartenenza ai segmenti o un elenco di offerte.

2.	Caricare i dati del profilo del visitatore nella sessione runtime.

3.	Eseguire tutti i diagrammi di flusso interattivi associati al canale interattivo e posizionare il visitatore nei segmenti.

Quando il visitatore interagisce con il touchpoint, l'API di Interact può eseguire diverse azioni, incluse l'attivazione di eventi, la richiesta di informazioni di profilo e la modifica del livello destinatari del visitatore. Quando il visitatore raggiunge un punto di interazione nel touchpoint, l'API di Interact può richiedere una o più offerte o attivare un evento. Quando il visitatore lascia il touchpoint, disconnettendosi, riagganciando o a causa del timeout, il server runtime termina la sessione runtime.

Questa è una panoramica di base. Esistono molte funzioni che è possibile abilitare e che consentono di influenzare la proposta di offerte, ad esempio, il modulo di apprendimento. Per ulteriori informazioni su queste funzioni facoltative, vedere la Interact Administrator's Guide.