Sorgenti

Affinché un'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 > Clienti > 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 menu laterale Impostazioni > Clienti > Sorgenti > 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
• Javascript Website
• Contactplan
• Contactsend
• Java 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 > Clienti > Sorgenti, cliccando sulla sorgente puntuale desiderata. In questa pagina è possibile creare un nuovo token selezionando Rigenera.

Creare la sorgente Contacthub API

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

Le informazioni da inserire sono:

• Nome e Descrizione.
• Nodo in cui la sorgente può leggere e/o scrivere.
• Opzioni del provider > the list of IP addressess ranges to read and write a given source, dove inserire uno o più range di IP autorizzati così che si possa leggere e/o scrivere dati.

La documentazione API è disponibile qui.

warning

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

Creare la sorgente JavaScript Website

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

Le informazioni da inserire sono:

• Nome e Descrizione.
• Nodo in cui la sorgente può leggere e/o scrivere.
• Opzioni del provider, dove specificare gli url che possono scrivere nella sorgente.

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

Il JavaScript per la documentazione di un sito è disponibile nel capitolo Data Model.

Creare la 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. Per maggiori informazioni consulta il capitolo del Data Model.

Le informazioni da inserire sono:

• Nome e Descrizione.
• Nodo, in cui la sorgente può leggere e/o scrivere.
• Opzioni del provider:
  • Scegliere il tenant appropriato della lista Seleziona un tenant.
  • In Classificazioni, inserire 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.
• In Mappa le proprietà estese degli eventi con i campi di Plan, procedere così:

  • Selezionare una categoria di eventi del modulo Segmenti (Contactplan), ad esempio Acquisti, e associare le proprietà estese elencate, ai campi Segmenti appropriati.

    Questa opzione consente di poter utilizzare le proprietà estese dei clienti per scopi di segmentazione.

warning

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.

Creare la sorgente Contactsend

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 compilare i seguenti campi:

• Nome e Descrizione.
• Nodo in cui la sorgente può leggere e/o scrivere.
• Opzioni del provider, inserire qui:
  • il grouppk, ovvero l'identificativo della piattaforma Send da sincronizzare;
  • lo userdb, ovvero l'identificativo del database Send.

Inoltre, cliccando Mostra i campi da associare:

• Compare un elenco di campi del profilo del cliente, ognuno con un proprio menu 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:

• Selezionare l’ID del sistema di sottoscrizione dell’area Clienti.

• Selezionare il sistema di sottoscrizione Send.

• Inserire il Codice Webform per il sistema di sottoscrizioni di Send.

• Se si desidera aggiungere un’altra sottoscrizione, cliccare su + posizionato a destra del Codice Webform.

  

informazioni

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.

Modificare una sorgente

Per modificare una sorgente, accedere alla pagina Impostazioni > Clienti > 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.

Cliccare su Aggiorna per salvare le modifiche.

Selezionando il comando Torna alla lista, si annulla il processo di modifica della sorgente in corso.

Selezionando il comando Rimuovi la sorgente sarà eliminata dopo la conferma.

Cancellare una sorgente

Per eliminare una sorgente, procedere come segue:

1. Individuare e fare clic sulla sorgente da rimuovere.
2. Fare clic su Rimuovi.
   • Viene visualizzato un messaggio di notifica.
3. Fare clic su Conferma per eliminare la sorgente.
   • La sorgente viene eliminata.

In alternativa, dopo aver selezionato la sorgente, posizionarsi nel tab Configurazione, cliccare su Rimuovi e confermare l'azione.

pericolo

L'attività di rimozione è irreversibile e non può essere annullata dopo la conferma.