Creare e configurare gli stream di dati
Questo documento descrive i passaggi per la configurazione di uno stream di dati nell’interfaccia utente.
Accedere all’area di lavoro dello stream di dati
Puoi creare e gestire stream di dati nell’interfaccia utente Raccolta dati o in quella di Experience Platform selezionando Stream di dati nel menu di navigazione a sinistra.
La scheda Stream di dati riporta un elenco di stream di dati esistenti, incluso il nome intuitivo, l’ID e la data dell’ultima modifica. Per visualizzarne i dettagli e configurare i servizi, selezionare il nome di uno stream di dati.
Per visualizzare altre opzioni per un particolare flusso di dati, selezionare l'icona Altro (…). Per aggiornare la configurazione di base per lo stream di dati, selezionare Modifica. Per rimuovere lo stream di dati, selezionare Elimina.
Creare un flusso di dati create
Per creare uno stream di dati, inizia selezionando Nuovo stream di dati.
Viene visualizzata l’area di lavoro relativa alla creazione dello stream di dati, partendo dal passaggio di configurazione. Da qui, è necessario fornire un nome e una descrizione facoltativa per lo stream di dati.
Se si configura un datastream da utilizzare in Experience Platform e si utilizza anche Web SDK, è necessario selezionare anche uno schema Experience Data Model (XDM) basato su eventi per rappresentare i dati che si intende acquisire.
Configurare la geolocalizzazione e la ricerca di rete geolocation-network-lookup
Le impostazioni di geolocalizzazione e ricerca di rete consentono di definire il livello di granularità dei dati a livello di rete e geografico che si desidera raccogliere.
Espandi la sezione Geolocalizzazione e ricerca di rete per configurare le impostazioni descritte di seguito.
Abilita le ricerche di geolocalizzazione per le opzioni selezionate in base all’indirizzo IP del visitatore. Le opzioni disponibili includono:
- Paese: compila
xdm.placeContext.geo.countryCode
- Codice postale: compila
xdm.placeContext.geo.postalCode
- Stato/Provincia: compila
xdm.placeContext.geo.stateProvince
- DMA: compila
xdm.placeContext.geo.dmaID
- Città: popola
xdm.placeContext.geo.city
- Latitudine: compila
xdm.placeContext.geo._schema.latitude
- Longitudine: compila
xdm.placeContext.geo._schema.longitude
La selezione di Città, Latitudine o Longitudine fornisce coordinate fino a due punti decimali, indipendentemente dalle altre opzioni selezionate. Questa è considerata granularità a livello di città.
Se non si seleziona alcuna opzione, le ricerche di geolocalizzazione vengono disattivate. La geolocalizzazione si verifica prima di IP Obfuscation, il che significa che non è interessata dall'impostazione IP Obfuscation.
Abilita le ricerche di rete per le opzioni selezionate in base all'indirizzo IP del visitatore. Le opzioni disponibili includono:
- Gestore di telefonia mobile: compila
xdm.environment.carrier
- Dominio: popola
xdm.environment.domain
- ISP: compila
xdm.environment.ISP
- Tipo di connessione: compila
xdm.environment.connectionType
Se si abilita uno dei campi sopra indicati per la raccolta dati, assicurarsi di impostare correttamente la proprietà dell'array context
durante la configurazione dell'SDK Web.
I campi di ricerca di geolocalizzazione utilizzano la stringa di array context
"placeContext"
, mentre i campi di ricerca di rete utilizzano la stringa di array context
"environment"
.
Inoltre, accertati che nello schema esista ogni campo XDM desiderato. In caso contrario, puoi aggiungere allo schema il gruppo di campi Environment Details
fornito dall'Adobe.
Configurare la ricerca del dispositivo geolocation-device-lookup
Le impostazioni di Ricerca dispositivi consentono di selezionare le informazioni specifiche del dispositivo che si desidera raccogliere.
Espandi la sezione Ricerca dispositivi per configurare le impostazioni descritte di seguito.
xdm.environment.browserDetails.userAgent
Seleziona questa opzione se desideri raccogliere una o più delle seguenti informazioni specifiche per il dispositivo:
-
Informazioni dispositivo:
- Produttore dispositivo: compila
xdm.device.manufacturer
- Modello dispositivo: compila
xdm.device.modelNumber
- Nome marketing: compila
xdm.device.model
- Produttore dispositivo: compila
-
Informazioni hardware:
- Tipo di hardware: compila
xdm.device.type
- Altezza visualizzazione: compila
xdm.device.screenHeight
- Larghezza visualizzazione: compila
xdm.device.screenWidth
- Profondità colore visualizzazione: compila
xdm.device.colorDepth
- Tipo di hardware: compila
-
Informazioni sul browser:
- Fornitore browser: compila
xdm.environment.browserDetails.vendor
- Nome browser: compila
xdm.environment.browserDetails.name
- Versione browser: compila
xdm.environment.browserDetails.version
- Fornitore browser: compila
-
Informazioni sul sistema operativo:
- Fornitore sistema operativo: compila
xdm.environment.operatingSystemVendor
- Nome sistema operativo: compila
xdm.environment.operatingSystem
- Versione sistema operativo: compila
xdm.environment.operatingSystemVersion
- Fornitore sistema operativo: compila
Non è possibile raccogliere le informazioni di ricerca del dispositivo insieme all’agente utente e agli hint client. La scelta di raccogliere le informazioni sul dispositivo disattiva la raccolta degli hint dell’agente utente e del client e viceversa.
Se si abilita uno dei campi sopra indicati per la raccolta dati, assicurarsi di impostare correttamente la proprietà dell'array context
durante la configurazione dell'SDK Web.
Le informazioni sul dispositivo e sull'hardware utilizzano la stringa di array context
"device"
, mentre le informazioni sul browser e sul sistema operativo utilizzano la stringa di array context
"environment"
.
Inoltre, accertati che nello schema esista ogni campo XDM desiderato. In caso contrario, puoi aggiungere allo schema il gruppo di campi Environment Details
fornito dall'Adobe.
Configurare le opzioni avanzate @advanced-options
Per visualizzare le opzioni di configurazione avanzate, selezionare Opzioni avanzate. Qui puoi configurare impostazioni aggiuntive per lo stream di dati, ad esempio offuscamento dell’IP, cookie dell’ID di prima parte e altro ancora.
Indica il tipo di offuscamento dell’indirizzo IP da applicare allo stream di dati. Qualsiasi elaborazione basata sull’IP del cliente è influenzata dall’impostazione di offuscamento dell’IP. Ciò include tutti i servizi di Experience Cloud che ricevono dati dallo stream di dati.
Opzioni disponibili:
-
Nessuno: disabilita l’offuscamento dell’indirizzo IP. L’indirizzo IP completo dell’utente viene inviato tramite lo stream di dati.
-
Parziale: per gli indirizzi IPv4, offusca l’ultimo ottetto dell’indirizzo IP dell’utente. Per gli indirizzi IPv6, offusca gli ultimi 80 bit dell’indirizzo.
Esempi:
- IPv4:
1.2.3.4
->1.2.3.0
- IPv6:
2001:0db8:1345:fd27:0000:ff00:0042:8329
->2001:0db8:1345:0000:0000:0000:0000:0000
- IPv4:
-
Completo: offusca l’intero indirizzo IP.
Esempi:
- IPv4:
1.2.3.4
->0.0.0.0
- IPv6:
2001:0db8:1345:fd27:0000:ff00:0042:8329
->0:0:0:0:0:0:0:0
- IPv4:
Impatto dell’offuscamento dell’IP su altri prodotti Adobe:
- Adobe Target: l'offuscamento dell'IP a livello di flusso di dati IP viene applicato prima dell'offuscamento dell'IP eseguito in Adobe Target, a tutti gli indirizzi IP presenti nella richiesta. Ad esempio, se l'opzione IP obfuscation a livello di flusso di dati è impostata su Full e l'opzione Adobe Target IP obfuscation è impostata su Last octet obfuscation, Adobe Target riceve un IP completamente offuscato. Se l'opzione IP obfuscation a livello di flusso di dati è impostata su Partial e l'opzione Adobe Target IP obfuscation è impostata su Full, Adobe Target riceve un IP parzialmente offuscato e applica l'offuscamento completo su di esso. L’offuscamento dell’IP di Adobe Target viene gestito indipendentemente dallo stream di dati. Per ulteriori dettagli, consulta la documentazione di Adobe Target sull’offuscamento dell’indirizzo IP e la geolocalizzazione.
- Audience Manager: l'impostazione IP obfuscation a livello di flusso di dati viene applicata prima dell'IP obfuscation eseguito in Audience Manager a tutti gli indirizzi IP presenti nella richiesta. Qualsiasi ricerca di geolocalizzazione eseguita da Audience Manager è influenzata dall’opzione di offuscamento dell’indirizzo IP a livello di stream di dati. Una ricerca di geolocalizzazione in Audience Manager, basata su un IP completamente offuscato, determina una regione sconosciuta e tutti i segmenti basati sui dati di geolocalizzazione risultanti non vengono realizzati. Per ulteriori informazioni, consulta la documentazione di Audience Manager sull’offuscamento dell’indirizzo IP.
- Adobe Analytics: se l'impostazione di offuscamento dell'IP a livello di flusso di dati è impostata su Full, Adobe Analytics considera l'indirizzo IP vuoto. Questo influisce su qualsiasi elaborazione di Analytics che dipende dall’indirizzo IP, come le ricerche di geolocalizzazione e il filtro IP. Affinché Analytics riceva gli indirizzi IP non offuscati o parzialmente offuscati, imposta l'impostazione di offuscamento dell'IP su Parziale o Nessuno. Gli indirizzi IP parzialmente offuscati e non offuscati possono essere ulteriormente offuscati all’interno di Analytics. Consulta la documentazione di Adobe Analytics per informazioni dettagliate su come abilitare l'offuscamento dell'IP in Analytics. Se l'indirizzo IP è completamente offuscato e l'hit della pagina non ha né un ECID né un VisitorID, Analytics rilascia l'hit anziché generare un ID di fallback, che è parzialmente basato sull'indirizzo IP.
Quando si abilita questa impostazione, è necessario fornire il nome del cookie che deve memorizzare l'ID.
Definisce il tipo di autenticazione accettato dalla rete Edge per lo stream di dati.
- Autenticazione mista: quando è selezionata questa opzione, la rete Edge accetta sia richieste autenticate che non autenticate. Seleziona questa opzione quando intendi utilizzare Web SDK o l’SDK Mobile, insieme all’API del server.
- Solo autenticate: quando è selezionata questa opzione, la rete Edge accetta solo richieste autenticate. Seleziona questa opzione quando intendi utilizzare solo l’API del server e desideri impedire l’elaborazione di richieste non autenticate da parte della rete Edge.
Da qui, se stai configurando uno stream di dati per Experience Platform, segui il tutorial sulla Preparazione dei dati per la raccolta dati per mappare i dati su uno schema di eventi di Platform prima di tornare a questa guida. Diversamente, seleziona Salva e passa alla sezione successiva.
Visualizzare i dettagli dello stream di dati view-details
Dopo aver configurato un nuovo stream di dati o averne selezionato uno esistente da visualizzare, viene visualizzata la pagina Dettagli dello stream di dati. Qui puoi trovare ulteriori informazioni sullo stream di dati, incluso il relativo ID.
Dalla schermata Dettagli dello stream di dati, puoi aggiungere servizi per attivare le funzionalità dei prodotti Adobe Experience Cloud a cui hai accesso. Puoi modificare anche la configurazione di base dello stream di dati, aggiornare le relative regole di mappatura, copiare lo stream di dati oppure eliminarlo completamente.
Aggiungere servizi a uno stream di dati add-services
Nella pagina dei dettagli di uno stream di dati, seleziona Aggiungi servizio per iniziare ad aggiungere i servizi disponibili per lo stream di dati.
Nella schermata successiva, utilizza il menu a discesa per selezionare un servizio da configurare per tale stream di dati. In questo elenco vengono visualizzati solo i servizi a cui si ha accesso.
Seleziona il servizio desiderato, compila le opzioni di configurazione visualizzate e quindi seleziona Salva per aggiungere il servizio allo stream di dati. Tutti i servizi aggiunti vengono visualizzati nella vista Dettagli dello stream di dati.
Le sottosezioni seguenti descrivono le opzioni di configurazione per ciascun servizio.
Impostazioni di Adobe Analytics analytics
Questo servizio controlla se e il modo in cui i dati vengono inviati ad Adobe Analytics. Vedi Invio di dati ad Adobe Analytics.
visitorID
in Analytics.Impostazioni di Adobe Audience Manager audience-manager
Questo servizio controlla se e il modo in cui i dati vengono inviati ad Adobe Audience Manager. Per inviare dati ad Audience Manager, è sufficiente abilitare questa sezione. Le altre impostazioni sono facoltative, ma consigliate.
Impostazioni di Adobe Experience Platform aep
Il servizio controlla se e in che modo i dati vengono inviati ad Adobe Experience Platform.
Per ulteriori informazioni sulle funzionalità di Offer Decisioning, consulta la documentazione di Adobe Journey Optimizer.
Puoi utilizzare questa opzione in combinazione con Destinazioni Personalization per casi di utilizzo di personalizzazione della stessa pagina e della pagina successiva tramite destinazioni Edge o Offer Decisioning.
Per i passaggi specifici sulla configurazione delle destinazioni di personalizzazione, consulta la documentazione delle destinazioni.
L’abilitazione di questa opzione consente allo stream di dati di restituire il contenuto personalizzato da campagne in entrata basate su web e su app in Adobe Journey Optimizer. Questa opzione richiede l’attivazione della segmentazione Edge. Se Segmentazione Edge è deselezionata, questa opzione è disattivata.
Impostazioni di Adobe Target target
Questo servizio controlla se e in che modo i dati vengono inviati ad Adobe Target.
Il token di proprietà si trova nell’interfaccia utente di Adobe Target in Configurazione >Proprietà.
Si consiglia di impostare questo parametro in modo diverso per ogni ambiente di destinazione
dev
, stage
e prod
, per semplificare le operazioni. Tuttavia, nel caso in cui gli ambienti di Adobe Target fossero già stati definiti, è possibile utilizzarli.mbox3rdPartyId
che desideri utilizzare per questo stream di dati. Se si utilizza un'integrazione Customer Attributes con Adobe Target o si utilizza thirdPartyId
per aggiornare o creare profili tramite API dei profili Adobe Target, è necessario fornire un valore dello spazio dei nomi desiderato. È necessario utilizzare questo spazio dei nomi nella sezione IdentityMap
dello schema XDM per inviare customerID
o thirdPartyId
utilizzati nei caricamenti di file degli attributi del cliente o nelle chiamate API per l'aggiornamento del profilo. Per ulteriori informazioni, consulta la guida sull’implementazione mbox3rdPartyId
con Web SDK.Impostazioni dell’Inoltro eventi
Questo servizio controlla se e in che modo i dati vengono inviati all’inoltro eventi.
Copiare uno stream di dati copy
Puoi creare una copia di uno stream di dati esistente e modificarne i dettagli in base alle esigenze.
Nella pagina principale nell’area di lavoro Stream di dati, seleziona i puntini di sospensione (…) per lo stream di dati in questione, quindi seleziona Copia.
In alternativa, è possibile selezionare Copia stream di dati dalla vista dei dettagli di un determinato stream di dati.
Viene visualizzata una finestra di dialogo di conferma in cui viene richiesto di fornire un nome univoco per il nuovo stream di dati da creare, insieme ai dettagli sulle opzioni di configurazione che verranno copiate. Quando è tutto pronto, seleziona Copia.
La pagina principale dell’area di lavoro Stream di dati viene nuovamente visualizzata con il nuovo stream di dati elencato.
Passaggi successivi
Questa guida illustra come gestire gli stream di dati nell’interfaccia utente Raccolta dati. Per ulteriori informazioni su come installare e configurare Web SDK dopo la configurazione di uno stream di dati, consulta la guida end-to-end sulla raccolta dati.