Creare e configurare gli stream di dati
Questa guida descrive i passaggi per configurare un flusso di dati nell'interfaccia utente.
Accedi all'area di lavoro Datastreams workspace
È possibile creare e gestire gli stream di dati nell'interfaccia utente di Data Collection o nell'interfaccia utente di Adobe Experience Platform selezionando Datastreams nell'area di navigazione a sinistra.
Nella scheda Datastreams viene visualizzato un elenco degli stream di dati esistenti, inclusi il nome descrittivo, 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 Edit. Per rimuovere lo stream di dati, selezionare Delete.
Creare un flusso di dati create
Per creare uno stream di dati, iniziare selezionando New Datastream.
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 il Web SDK, è necessario selezionare anche uno schema XDM (Experience Data Model) 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.
Espandere la sezione Geolocation and network lookup 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
Se si seleziona City, Latitude o Longitude, vengono fornite 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, ovvero 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 di questi campi per la raccolta dati, assicurarsi di impostare correttamente la proprietà dell'array context durante la configurazione del Web SDK.
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 da Adobe.
Configurare la ricerca del dispositivo geolocation-device-lookup
Utilizzare le impostazioni Device Lookup per selezionare le informazioni specifiche del dispositivo che si desidera raccogliere.
Espandere la sezione Device Lookup per configurare le impostazioni descritte di seguito.
xdm.environment.browserDetails.userAgentSeleziona questa opzione se desideri raccogliere una o più delle seguenti informazioni specifiche per il dispositivo:
-
Device informazioni:
- Produttore dispositivo: compila
xdm.device.manufacturer - Modello dispositivo: compila
xdm.device.modelNumber - Nome marketing: compila
xdm.device.model
- Produttore dispositivo: compila
-
Hardware informazioni:
- 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
-
Browser informazioni:
- Fornitore browser: compila
xdm.environment.browserDetails.vendor - Nome browser: compila
xdm.environment.browserDetails.name - Versione browser: compila
xdm.environment.browserDetails.version
- Fornitore browser: compila
-
Operating system informazioni:
- 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 di questi campi per la raccolta dati, assicurarsi di impostare correttamente la proprietà dell'array context durante la configurazione del Web SDK.
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 da Adobe.
Configurare le opzioni avanzate advanced-options
Per accedere alle opzioni di configurazione avanzate, selezionare Advanced Options. 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 Experience Cloud che ricevono dati dallo stream di dati. L’offuscamento dell’IP avviene prima dell’invio degli eventi a qualsiasi servizio a valle, ad esempio Preparazione dati.
Opzioni disponibili:
-
None: disabilita l'offuscamento dell'IP. L’indirizzo IP completo dell’utente viene inviato tramite lo stream di dati.
-
Partial: per gli indirizzi IPv4, offusca l'ultimo ottetto dell'indirizzo IP 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:
-
Full: 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: il livello di flusso di dati IP obfuscation viene applicato prima dell'esecuzione di IP obfuscation 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 di offuscamento dell'IP di Adobe Target è 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 di offuscamento dell'IP di Adobe Target è impostata su Full, Adobe Target riceve un IP parzialmente offuscato e quindi 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 stream di dati viene applicata prima dell'esecuzione di IP obfuscation in Audience Manager, a tutti gli indirizzi IP presenti nella richiesta. Qualsiasi ricerca di geolocalizzazione eseguita da Audience Manager è influenzata dall'opzione IP obfuscation a livello di flusso 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 Partial o None. 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.
- Adobe Advertising: quando l'offuscamento dell'IP a livello di flusso di dati è impostato su Partial o Full, la generazione di rapporti geografici e le funzioni (incluse la misurazione e la remarketing) sono disabilitate in Advertising DSP, ad eccezione degli annunci TV connessi.
Quando abiliti questa impostazione, devi fornire il nome del cookie che deve memorizzare l'ID.
Nota: lo stream di dati fa riferimento all'ID contenitore predefinito di Audience Manager, che è 0. Se disponi di più ID contenitore di sincronizzazione ID di Audience Manager, rivolgiti al tuo consulente Audience Manager per identificare e risolvere correttamente la configurazione di sincronizzazione ID.
Definisce il tipo di autenticazione accettato dalla rete Edge per lo stream di dati.
- Mixed Authentication: quando questa opzione è selezionata, Edge Network accetta sia le richieste autenticate che quelle non autenticate. Selezionare questa opzione quando si intende utilizzare Web SDK o Mobile SDK insieme alla API Edge Network.
- Authenticated Only: quando questa opzione è selezionata, Edge Network accetta solo le richieste autenticate. Seleziona questa opzione se intendi utilizzare solo l’API di Edge Network e vuoi evitare che le richieste non autenticate vengano elaborate da Edge Network.
Da qui, se stai configurando lo stream di dati per Experience Platform, segui l'esercitazione su Preparazione per la raccolta dati per mappare i dati a uno schema di eventi Experience Platform prima di tornare a questa guida. In caso contrario, selezionare Save e continuare con la 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 abilitare 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 un flusso di dati, selezionare Add Service per iniziare ad aggiungere i servizi disponibili per tale flusso 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.
Selezionare il servizio desiderato, compilare le opzioni di configurazione visualizzate, quindi selezionare Save 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 Advertising advertising
Questo servizio è necessario per l'integrazione di Adobe Advertising con Customer Journey Analytics.
Impostazioni di Adobe Analytics analytics
Utilizzare questo servizio per inviare dati a Adobe Analytics.
visitorID in Analytics.Quando il campo viene popolato, lo stream di dati invia il valore
visitorID a Adobe Analytics. Indipendentemente dal fatto che l'ID visitatore sia incluso in identityMap, ECID viene comunque generato e incluso nelle richieste in uscita. Analytics supporta l'inclusione di più ID. Gli ID vengono valutati nell'ordine descritto in questa pagina: Ordine di identificazione Adobe Analytics delle operazioni.Per ulteriori informazioni, vedere Implementare Adobe Analytics con Edge Network nella guida all'implementazione di Analytics.
Impostazioni di Adobe Audience Manager audience-manager
Abilita questo servizio per inviare dati a Adobe Audience Manager. Le altre impostazioni sono facoltative, ma consigliate.
Impostazioni di Adobe Experience Platform aep
Utilizzare questo servizio per inviare dati a Adobe Experience Platform.
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, Gestione decisioni, Adobe Target o Adobe Journey Optimizer.
L'attivazione di questa opzione consente allo stream di dati di restituire contenuto personalizzato da campagne in entrata basate sul Web e sull'app in Adobe Journey Optimizer.
Questa opzione richiede che il set di dati selezionato utilizzi uno schema che includa il Experience Event - Proposition Interactions gruppo di campi. Questo gruppo di campi viene utilizzato per registrare tutte le interazioni utente con campagne ed esperienze Adobe Journey Optimizer.
Impostazioni di Adobe Target target
Utilizzare questo servizio per inviare dati a Adobe Target.
Il token di proprietà si trova nell'interfaccia utente Adobe Target in Setup > Properties.
Si consiglia di impostare questo valore in modo diverso per ciascuno degli ambienti
dev, stage e prod dello stream di dati per evitare errori di configurazione. Tuttavia, se hai già definito Adobe Target ambienti, puoi 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 di Adobe Target, è necessario fornire un valore di 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.Event Forwarding impostazioni event-forwarding
Utilizza questo servizio per inviare dati a 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.
Dalla pagina principale dell'area di lavoro Datastreams, selezionare i puntini di sospensione (…) per lo stream di dati in questione, selezionare Copy.
In alternativa, è possibile selezionare Copy Datastream dalla visualizzazione dei dettagli di un determinato flusso 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. Al termine, selezionare Copy.
La pagina principale dell'area di lavoro Datastreams viene nuovamente visualizzata con il nuovo flusso di dati elencato.
Passaggi successivi next-steps
Questa guida illustra come gestire gli stream di dati nell’interfaccia utente Raccolta dati. Per ulteriori informazioni sull'installazione e la configurazione del Web SDK dopo la configurazione di uno stream di dati, vedere Guida introduttiva all'estensione tag Web SDK .