Affinchè una applicazione possa leggere e/o scrivere dati in un nodo è necessario definire la Sorgente. Questo infatti fornisce i permessi di accesso all’applicazione attraverso l’uso di un token di autorizzazione, nel momento in cui l’applicazione cerca di interagire con i dati contenuti in uno o più nodi.

Nella pagina Impostazioni > Sorgenti è possibile:

• Visualizzare le sorgenti abilitate e disabilitate.
• Creare e configurare sorgenti.
• Modificare sorgenti.
• Cancellare una sorgente.

Creare una nuova sorgente

In piattaforma selezionare nel menù laterale Impostazioni > Sorgente > Crea una nuova source.

I Provider sono i meccanismi che vengono usati per interagire con i dati. La capacità di lettura e/o scrittura di un’applicazione è determinata dal tipo di Provider associato alla sorgente. Quelli attualmente disponibili sono:

• Contacthub API
• Contacthub Javascript Website
• Contacthub Contactplan plug-in
• Contacthub Contactsend plug-in
• Contacthub Magento plug-in
• Contacthub Android SDK
• Contacthub iOS Objective-C SDK
• Contacthub Node.js SDK
• Contacthub Java SDK
• Contacthub .NET SDK
• Contacthub PHP SDK

Ogni provider ha un proprio livello di sicurezza:

• Trusted: accesso di lettura/scrittura.
• Untrusted: solo accesso di scrittura.

Solitamente i provider sono considerati di fiducia quando hanno un elevato livello di sicurezza nelle autorizzazioni conferite dai token. In fase di creazione di una nuova sorgente, ciascun provider disponibile è mostrato con il livello di sicurezza associato e riconosciuto.

Dopo aver selezionato il provider desiderato, nella sezione nodi Attivi, scegliere i nodi che si desidera far accedere all’applicazione.

Il provider potrebbe avere anche proprietà aggiuntive. Per esempio, il provider javascript richiede l’url di tutti i domini che sono autorizzati a scrivere sul nodo/i mentre il provider Contacthub API permette di definire l’indirizzo IP in grado di leggere e scrivere i dati del nodo.

Salvando la nuova sorgente, si ottiene il token di autorizzazione. Il token è sempre reperibile anche nella singola scheda sorgente, Impostazioni > Sorgenti – cliccando sulla sorgente puntuale desiderata. In questa pagina è possibile creare un nuovo token selezionando Rigenera.

Configurare una sorgente

Configurare la sorgente Contacthub API

 

Per utilizzare direttamente il token con una chiamata API, creare una sorgente impostata per Contacthub API.

Tra le informazioni da inserire:

• Opzioni del provider > the list of URLs allowed to write a given source: inserire uno o più range di IP autorizzati così che si possa leggere e/o scrivere dati.

La documentazione API è disponibile qui.

Nota:
Ogni chiamata API può avere contenuti (customer o eventi) per un peso massimo di 64kb.

 

Configurare una sorgente con un JavaScript Website

 

Per aggiungere JavaScript a un sito e tracciare tutte le azioni di un cliente, bisogna creare una sorgente Javascript website.

Quando si crea una sorgente JavaScript, è fornito un token da utilizzare durante l’integrazione JavaScript.

Il JavaScript per la documentazione di un sito è disponibile qui.

 

Configurare una sorgente Contactplan

 

Questa sorgente consente di sincronizzare la maggior parte degli eventi del customer con il modulo Segmenti (Contactplan) e associare le proprietà estese al campo appropriato. Qui maggiori informazioni sul Data Model.

Per configurare la sorgente, fare come segue:

1. Inserisci le informazioni Nome e Descrizione.
2. Sotto Nodi attivi, seleziona i nodi che la sorgente può leggere e/o scrivere.
3. Sotto Opzioni del provider:
   • Scegli il tenant appropriato della lista Seleziona un tenant.
   • Sotto Classificazioni, inserisci i nomi della chiave evento di acquisto appropriata e le coppie di valori che si desidera esportare sul modulo Segmenti (Contactplan). È possibile esportare un massimo di 15 classificazioni (fino a 10 in formato stringa e 5 in formato data). Qui ulteriori informazioni sulle classificazioni.
4. Sotto Mappa le proprietà estese degli eventi con i campi di Plan, procedi così:
   Seleziona una categoria di eventi del modulo Segmenti (Contactplan), ad esempio Acquisti, e associa le proprietà estese elencate, ai campi Segmenti appropriati.
   Questa opzione consente di poter utilizzare le proprietà estese del clienti per scopi di segmentazione.

Nota:
Dopo aver configurato i mapping necessari e aver completato la creazione della sorgente, è necessario rendere visibili i relativi campi nell’area Segmenti e, ad esempio, aggiornare i nomi visualizzati, a seconda dei casi. Qui maggiori dettagli.

LIMITAZIONI

È possibile creare una sorgente Contactplan per uno specifico tenant solo nel caso esista una sincronizzazione Send per il database, già utilizzata dal tenant.

Le seguenti limitazioni sono necessarie per garantire l’integrità e la coerenza dei dati in tutta la piattaforma. Le limitazioni si basano sul principio:  “una source : un nodo :  uno userdb”.

• É possibile creare una sola sorgente Contactplan per nodo.
• Uno userdb può essere sincronizzato con un solo nodo con sorgente Contactplan.
• É possibile creare una sorgente Contactplan su un nodo solo se esiste una sorgente Send configurata sullo stesso nodo e sono entrambe sincronizzati sullo stesso nodo.

In caso di modifica della source Contactplan:

Contactplan Source
Da modificare	Requisiti
	Sorgente disabilitata	Nodo esistente vuoto	Nuovo nodo vuoto	userdb vuoto
node	x	x
node and groupPk	x		x
userdbID	x	x
node and userdbID	x		x

 

Configurare una sorgente Send

 

L’area Clienti è nativamente integrata con Send ed è quindi possibile sincronizzare in automatico i dati del cliente e la sottoscrizione alla newsletter, quasi in tempo reale.

Per attivare questa sorgente è necessario inserire nei campi Opzioni del provider:

• Almeno un database Send, lo userdb.
• Un apiKey e un userKey che insieme autorizzano l’utilizzo di Send.

Inoltre, cliccando Mostra i campi da associare:

• appare un elenco di campi del profilo del cliente, ognuno con un proprio menù a tendina secondo il database Send selezionato.
• selezionare i campi Send desiderati per attivare la sincronizzazione dei dati. Bisogna selezionare uno o più campi abbinati.

In aggiunta ai dati del cliente, si possono sincronizzare una o più sottoscrizioni a newsletter.
Per attivare la sincronizzazione, nel pannello di sincronizzazione delle sottoscrizioni:

1. Selezionare l’ID del sistema di sottoscrizione dell’area Clienti.
2. Selezionare il sistema di sottoscrizione Send.
3. Inserire il Codice Webform per il sistema di sottoscrizioni di Send.
4. Se si desidera aggiungere un’altra sottoscrizione, cliccare su + posizionato a destra del Codice Webform.

I campi di sincronizzazione delle sottoscrizioni non sono disponibili per i nodi aggregati.

La sincronizzazione della sottoscrizione è bidirezionale. Questo significa che ogni modifica fatta nell’area Cliente e/o Send è sincronizzata.

In caso di modifica invece:

Contactsend Source
Da modificare	Requisiti
	Sorgente disabilitata	Nodo esistente vuoto	Nuovo nodo vuoto	userdb vuoto
node	x		x
apiKey	x	x
node and apiKey	x		x
userdbID	x	x		x
node and userdbID	x		x	x
subscription	x
map	x

 

Modificare una sorgente

Per modificare una sorgente, accedere alla pagina Impostazioni > Sorgenti ed entrare nella scheda della sorgente da modificare. Una volta visualizzata, accedere al tab Configurazione.

É possibile modificare:

• Il Nome della sorgente.
• La Descrizione.
• I nodi a cui l’applicazione può accedere.
• Le proprietà aggiuntive del provider.

Selezionando il comando Rimuovi, si annulla il processo di modifica della sorgente in corso.

Cancellare una sorgente

Per eliminare una sorgente, procedere come segue:

• Individuare e fare clic sulla sorgente da rimuovere.
• Fare clic su Rimuovi.
  Viene visualizzato un messaggio di avviso.
• Fare clic su Conferma per eliminare la sorgente.
  La sorgente viene eliminata.
  Nota:
  Questa azione non può essere annullata.

 

 

Pagina precedente: Eventi | Pagina seguente: Gerarchie