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.
• Disabilitare una sorgente.
• Cancellare una sorgente.

Creare una nuova sorgente

In piattaforma selezionare Impostazioni > Clienti > Sorgenti > Crea per creare una nuova sorgente.

Selezionare quindi il Provider di interesse.

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 principalmente utilizzati sono:

• API
• Javascript
• Plan
• Send

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 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 cliccando su Rigenera Token.

Creare la sorgente API

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

Le informazioni da inserire sono:

• Nome e Descrizione.
• Nodi in cui la sorgente può leggere e/o scrivere.
• Proprietà del provider > the list of IP addresses 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.

attenzione

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

Creare la sorgente JavaScript

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

Le informazioni da inserire sono:

• Nome e Descrizione.
• Nodi in cui la sorgente può leggere e/o scrivere.
• Proprietà 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 Plan

Questa sorgente consente di sincronizzare la maggior parte degli eventi del customer con il modulo Segmenti (Plan) 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.
• Nodi, in cui la sorgente può leggere e/o scrivere.
• Opzioni del provider:
  • Scegliere il tenant appropriato della lista Tenant.
• Proprietà del provider:
  • In Classificazioni, inserire i nomi della chiave evento di acquisto appropriata e le coppie di valori che si desidera esportare sul modulo Segmenti (Plan). È 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 (Plan), 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.

attenzione

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 Plan 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 Plan per nodo.
• Uno userdb può essere sincronizzato con un solo nodo con sorgente Plan.
• È possibile creare una sorgente Plan su un nodo solo se esiste una sorgente Send configurata sullo stesso nodo e sono entrambe sincronizzati sullo stesso nodo.

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

• Nome e Descrizione.
• Nodo in cui la sorgente può leggere e/o scrivere.
• Opzioni del provider, inserire qui:
  • il Group PK, ovvero l'identificativo della piattaforma Send da sincronizzare;
  • l'ID User DB, ovvero l'identificativo del database Send. e cliccare su Applica.

Nella sezione Mappa le proprietà con i campi di Send:

• 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 cliccare su +Aggiungi, nel pannello di sincronizzazione delle sottoscrizioni:

• Inserire 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 +Aggiungi.

informazione

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.

È possibile modificare:

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

Cliccare su Salva per salvare le modifiche.

Selezionando il comando Ritorna alla lista, si annulla il processo di modifica della sorgente in corso.
Selezionando il comando Elimina la sorgente sarà eliminata dopo la conferma.
Selezionando Rigenera Token sarà rigenerato un nuovo token.

Disabilitare una sorgente

Per disabilitare una sorgente:

• Accedere alla pagina Impostazioni > Clienti > Sorgenti.
• Individuare la sorgente di interesse e cliccare sull'icona dei tre puntini.
• Cliccare su Disabilita.

Cancellare una sorgente

Per eliminare una sorgente:

• Accedere alla pagina Impostazioni > Clienti > Sorgenti.
• Selezionare la sorgente da rimuovere.
• Cliccare su Elimina. Viene visualizzato un messaggio di notifica.
• Cliccare su Conferma per procedere con l'eliminazione.

avviso critico

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