Creare e configurare gli stream di dati

Questo documento descrive i passaggi per la configurazione di uno stream di dati nell’interfaccia utente.

Accedi all'area di lavoro Datastreams

È possibile creare e gestire gli stream di dati nell'interfaccia utente di Data Collection o nell'interfaccia utente di Experience Platform selezionando Datastreams nell'area di navigazione a sinistra.

Scheda Stream di dati nell’interfaccia utente Raccolta dati

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.

Opzioni per modificare o eliminare uno stream di dati esistente

Creare un flusso di dati create

Per creare uno stream di dati, iniziare selezionando New Datastream.

Seleziona 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 il Web SDK, è necessario selezionare anche uno schema XDM (Experience Data Model) basato su eventi per rappresentare i dati che si intende acquisire.

Configurazione di base per uno stream di dati

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.

Schermata di configurazione dello stream di dati con le impostazioni di geolocalizzazione e ricerca di rete evidenziate.

Impostazione
Descrizione
Geo Lookup

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.

Network Lookup

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 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

Le impostazioni di Device Lookup consentono di selezionare le informazioni specifiche del dispositivo da raccogliere.

Espandere la sezione Device Lookup per configurare le impostazioni descritte di seguito.

Schermata di configurazione dello stream di dati con le impostazioni di ricerca del dispositivo evidenziate.

IMPORTANT
Le impostazioni mostrate nella tabella seguente si escludono a vicenda. Non è possibile selezionare contemporaneamente le informazioni dell'agente utente e i dati di ricerca dispositivo.
Impostazione
Descrizione
Keep user agent and client hints headers
Seleziona questa opzione per raccogliere solo le informazioni memorizzate nella stringa dell’agente utente. Questa impostazione è selezionata per impostazione predefinita. Popola xdm.environment.browserDetails.userAgent
Use device lookup to collect the following information

Seleziona 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
  • 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
  • Browser informazioni:

    • Fornitore browser: compila xdm.environment.browserDetails.vendor
    • Nome browser: compila xdm.environment.browserDetails.name
    • Versione browser: compila xdm.environment.browserDetails.version
  • Operating system informazioni:

    • Fornitore sistema operativo: compila xdm.environment.operatingSystemVendor
    • Nome sistema operativo: compila xdm.environment.operatingSystem
    • Versione sistema operativo: compila xdm.environment.operatingSystemVersion

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.

Do not collect any device information
Selezionare questa opzione se non si desidera raccogliere informazioni sulla ricerca del dispositivo. Non vengono raccolti dati relativi a dispositivi, hardware, browser, sistema operativo, agenti utente o suggerimenti client.

Se si abilita uno dei campi sopra indicati 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 visualizzare le 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.

Opzioni di configurazione avanzate

IMPORTANT
L’utente è responsabile di aver ottenuto tutte le autorizzazioni, i consensi, le autorizzazioni e le autorizzazioni necessari in base alle leggi e alle normative applicabili per raccogliere, elaborare e trasmettere dati personali, incluse informazioni precise sulla geolocalizzazione.
La selezione dell’offuscamento dell’indirizzo IP non influisce sul livello di informazioni di geolocalizzazione derivate dall’indirizzo IP e inviate alle soluzioni Adobe configurate. Le ricerche per geolocalizzazione devono essere limitate o disabilitate separatamente.
Impostazione
Descrizione
IP Obfuscation

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
  • 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

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 stream di dati è impostato su Partial o Full, in Advertising DSP le funzionalità e i rapporti geografici (inclusi la misurazione e il retargeting) sono disabilitati, ad eccezione degli annunci TV connessi.
First Party ID Cookie
Quando è abilitata, questa impostazione comunica alla rete Edge di fare riferimento a un cookie specificato durante la ricerca di un ID dispositivo di prime parti, anziché cercare questo valore nella mappa di identità.

Quando si abilita questa impostazione, è necessario fornire il nome del cookie che deve memorizzare l'ID.
Third Party ID Sync
Le sincronizzazioni ID possono essere raggruppate in contenitori per consentire di eseguire diverse sincronizzazioni ID in momenti diversi. Quando è abilitata, questa impostazione consente di specificare quale contenitore di sincronizzazioni ID viene eseguito per tale stream di dati.
Third Party ID Sync Container ID
ID numerico del contenitore da utilizzare per la sincronizzazione dell’ID di terze parti.
Container ID Overrides
In questa sezione puoi definire altri ID contenitore di sincronizzazione ID di terze parti da utilizzare per sostituire quello predefinito.
Access Type

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.
Media Analytics
Abilita l'elaborazione dei dati di tracciamento streaming per l'integrazione Edge Network tramite SDK Experience Platform o API Media Edge. Scopri di più su Media Analytics nella documentazione.

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.

Pagina dei dettagli dello stream di dati.

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.

Seleziona Aggiungi servizio per continuare.

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 un servizio dallelenco.

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.

Servizi aggiunti a uno stream di dati

Le sottosezioni seguenti descrivono le opzioni di configurazione per ciascun servizio.

NOTE
Ogni configurazione del servizio contiene un interruttore Enabled che viene attivato automaticamente quando il servizio viene selezionato. Per disabilitare il servizio selezionato per questo flusso di dati, selezionare di nuovo l'interruttore Enabled.

Impostazioni di Adobe Advertising advertising

Questo servizio è necessario per l’integrazione di Adobe Advertising con Customer Journey Analytics.

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.

Impostazioni dello stream di dati di Adobe Analytics.

Impostazione
Descrizione
Report Suite ID
(Obbligatorio) L’ID della suite di rapporti di Analytics a cui desideri inviare i dati. Questo ID si trova nell'interfaccia utente di Adobe Analytics in Admin > ReportSuites. Se sono specificate più suite di rapporti, i dati vengono copiati in ogni suite.
Visitor ID namespace
(Facoltativo) Lo spazio dei nomi che desideri utilizzare per l'Adobe Analytics visitorID. Quando si invia un evento con un valore specificato per questo spazio dei nomi, verrà utilizzato automaticamente come visitorID in Analytics.
Report Suite Overrides
In questa sezione puoi aggiungere altri ID della suite di rapporti da utilizzare in sostituzione di quello predefinito.

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 dello stream di dati di Adobe Audience Manager.

Impostazione
Descrizione
Cookie Destinations Enabled
Consente all’SDK di condividere informazioni sui segmenti tramite le destinazioni dei cookie da Audience Manager.
URL Destinations Enabled
Consente all’SDK di condividere informazioni sui segmenti tramite le destinazioni URL da Audience Manager.

Impostazioni di Adobe Experience Platform aep

IMPORTANT
Quando abiliti un flusso di dati per Experience Platform, prendi nota della sandbox di Experience Platform che stai utilizzando, come mostrato nella barra multifunzione superiore dell’interfaccia utente.
Sandbox selezionata
In Adobe Experience Platform le sandbox sono partizioni virtuali che consentono di isolare i dati e le implementazioni da parte di altri all’interno dell’organizzazione. Una volta creato uno stream di dati, la relativa sandbox non può essere modificata. Per ulteriori dettagli sul ruolo delle sandbox in Experience Platform, consulta la documentazione sulle sandbox.

Il servizio controlla se e in che modo i dati vengono inviati ad Adobe Experience Platform.

Impostazioni dello stream di dati di Adobe Experience Platform.

Impostazione
Descrizione
Event Dataset
(Obbligatorio) Seleziona il set di dati di Experience Platform a cui verranno trasmessi i dati dell'evento cliente. Lo schema deve utilizzare la classe XDM ExperienceEvent. Per aggiungere altri set di dati, selezionare Add Event Dataset.
Profile Dataset
Seleziona il set di dati di Experience Platform che verrà utilizzato per inviare gli attributi del cliente per consenso, token push e area attività utente. Lo schema deve utilizzare la classe Profilo XDM individuale.
Offer Decisioning
Abilita Offer Decisioning per le implementazioni di Web SDK. Per ulteriori dettagli sull'implementazione, consulta la guida sull'utilizzo di Offer Decisioning con Web SDK.

Per ulteriori informazioni sulle funzionalità di Offer Decisioning, consulta la documentazione di Adobe Journey Optimizer.
Edge Segmentation
Abilita la segmentazione Edge per questo flusso di dati. Quando l'API Web SDK o Edge Network invia dati tramite un flusso di dati con segmentazione Edge abilitata, tutte le appartenenze aggiornate al pubblico per il profilo in questione vengono rimandate nella risposta.

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, Offer Decisioning, Adobe Target o Adobe Journey Optimizer
Personalization Destinations
Abilita Personalization personalizzato per questo flusso di dati. Quando l'API Web SDK o la API Edge Network invia dati tramite un flusso di dati con destinazioni di personalizzazione abilitate, le appartenenze del pubblico e gli attributi di profilo mappati (solo per richieste API Edge Network autenticate) per il profilo in questione vengono rimandati nella risposta.
Adobe Journey Optimizer
Abilita Adobe Journey Optimizer per questo flusso di dati.

L'abilitazione 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 include il Experience Event - Proposition Interactions gruppo di campi. Questo gruppo di campi viene utilizzato per registrare tutte le interazioni dell’utente con le campagne e le esperienze Adobe Journey Optimizer.

Impostazioni di Adobe Target target

Questo servizio controlla se e in che modo i dati vengono inviati ad Adobe Target.

Impostazioni dello stream di dati di Adobe Target.

Impostazione
Descrizione
Property Token
Target consente ai clienti di controllare le autorizzazioni utilizzando le proprietà. Per ulteriori informazioni sulle proprietà, consulta la guida sulla configurazione delle autorizzazioni Enterprise riportata nella documentazione di Target.

Il token di proprietà si trova nell'interfaccia utente di Adobe Target in Setup > Properties.
Target Environment ID
Gli ambienti in Adobe Target consentono di gestire l’implementazione in tutte le fasi di sviluppo. Questa impostazione specifica l’ambiente da utilizzare con questo stream di dati.

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.
Target Third Party ID namespace
Lo spazio dei nomi delle identità 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 mbox3rdPartyIdcon Web SDK.
Property Token Overrides
In questa sezione puoi definire token di proprietà aggiuntivi da utilizzare per sostituire quello predefinito.

Event Forwarding impostazioni

Questo servizio controlla se e in che modo i dati vengono inviati all’inoltro eventi.

Sezione Inoltro eventi della schermata di configurazione dello stream di dati.

Impostazione
Descrizione
Launch Property
(Obbligatorio) La proprietà di inoltro degli eventi a cui desideri inviare i dati.
Launch Environment
(Obbligatorio) L’ambiente all’interno della proprietà selezionata a cui desideri inviare i dati.
NOTE
È possibile selezionare Manually enter IDs per digitare i nomi delle proprietà e degli ambienti invece di utilizzare i menu a discesa.

Copiare uno stream di dati copy

Puoi creare una copia di uno stream di dati esistente e modificarne i dettagli in base alle esigenze.

NOTE
Gli stream di dati possono essere copiati solo all’interno della stessa sandbox. In altre parole, non è possibile copiare uno stream di dati da una sandbox all’altra.

Dalla pagina principale dell'area di lavoro Datastreams, selezionare i puntini di sospensione () per lo stream di dati in questione, quindi selezionare Copy.

Immagine che mostra lopzione Copia selezionata dalla visualizzazione elenco dello stream di dati.

In alternativa, è possibile selezionare Copy Datastream dalla visualizzazione dei dettagli di un determinato flusso di dati.

Opzione Copia selezionata dalla visualizzazione dei dettagli dello 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. Al termine, selezionare Copy.

Finestra di dialogo di conferma per la copia di uno stream di dati.

La pagina principale dell'area di lavoro Datastreams viene nuovamente visualizzata con il nuovo flusso 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.

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac