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.

Scheda Stream di dati nell’interfaccia utente Raccolta dati

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.

Opzioni per modificare o eliminare uno stream di dati esistente

Creare un flusso di dati create

Per creare uno stream di dati, inizia selezionando Nuovo stream di dati.

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 Web SDK, è necessario selezionare anche uno schema Experience Data Model (XDM) 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.

Espandi la sezione Geolocalizzazione e ricerca di rete 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
Ricerca geolocalizzazione

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.

Ricerca in rete

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.

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
Mantieni intestazioni agente utente e suggerimenti client
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
Utilizzare la ricerca del dispositivo per raccogliere le informazioni seguenti

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
  • 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
  • Informazioni sul browser:

    • Fornitore browser: compila xdm.environment.browserDetails.vendor
    • Nome browser: compila xdm.environment.browserDetails.name
    • Versione browser: compila xdm.environment.browserDetails.version
  • 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

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.

Non raccogliere informazioni sul dispositivo
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 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.

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

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

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.
ID cookie di prime parti
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.
Sincronizzazione ID di terze parti
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.
ID contenitore sincronizzazione ID di terze parti
ID numerico del contenitore da utilizzare per la sincronizzazione dell’ID di terze parti.
Override ID contenitore
In questa sezione puoi definire altri ID contenitore di sincronizzazione ID di terze parti da utilizzare per sostituire quello predefinito.
Tipo di accesso

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

Pagina dei dettagli dello stream di dati.

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.

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.

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.

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’opzione abilitata che si attiva automaticamente quando il servizio viene selezionato. Per disabilitare il servizio selezionato per lo stream di dati, seleziona di nuovo l’opzione abilitata.

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
ID suite di rapporti
(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 Amministrazione > Suite di rapporti. Se sono specificate più suite di rapporti, i dati vengono copiati in ogni suite.
Spazio dei nomi ID visitatore
(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.
Override della suite di rapporti
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.

Adobe delle impostazioni dello stream di dati di Audience Manager.

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

Impostazioni di Adobe Experience Platform aep

IMPORTANT
Quando abiliti uno stream di dati per Platform, prendi nota della sandbox Platform attualmente in uso, 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
Set di dati di evento
(Obbligatorio) Seleziona il set di dati di Platform a cui verranno trasmessi in streaming i dati dell’evento cliente. Lo schema deve utilizzare la classe XDM ExperienceEvent. Per aggiungere altri set di dati, seleziona Aggiungi set di dati di evento.
Set di dati di profilo
Seleziona il set di dati di Platform a cui verranno inviati i dati attributo del cliente. Lo schema deve utilizzare la classe Profilo XDM individuale.
Offer Decisioning
Abilita l’Offer decisioning per le implementazioni dell’SDK web. Per ulteriori dettagli sull'implementazione, consulta la guida su utilizzo di Offer Decisioning con Web SDK.

Per ulteriori informazioni sulle funzionalità di Offer Decisioning, consulta la documentazione di Adobe Journey Optimizer.
Segmentazione Edge
Abilita la segmentazione Edge per questo flusso di dati. Quando Web SDK o Edge Network Server API invia dati tramite uno stream 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 o Offer Decisioning.
Destinazioni di personalizzazione
Quando viene abilitata dopo aver attivato la casella di controllo della segmentazione Edge, questa opzione consente allo stream di dati di connettersi alle destinazioni di personalizzazione, ad esempio la Personalizzazione personalizzata.

Per i passaggi specifici sulla configurazione delle destinazioni di personalizzazione, consulta la documentazione delle destinazioni.
Adobe Journey Optimizer
Abilita Adobe Journey Optimizer per questo flusso di dati.

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.

Impostazioni dello stream di dati di Adobe Target.

Impostazione
Descrizione
Token di proprietà
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 Configurazione >Proprietà.
ID ambiente di destinazione
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.
ID spazio dei nomi destinazione di terze parti
Lo spazio dei nomi dell’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.
Override del token di proprietà
In questa sezione puoi definire token di proprietà aggiuntivi da utilizzare per sostituire quello predefinito.

Impostazioni dell’Inoltro eventi

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
Proprietà Launch
(Obbligatorio) La proprietà di inoltro degli eventi a cui desideri inviare i dati.
Ambiente Launch
(Obbligatorio) L’ambiente all’interno della proprietà selezionata a cui desideri inviare i dati.
NOTE
Puoi selezionare Immetti manualmente gli ID per digitare i nomi delle proprietà e degli ambienti anziché 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.

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.

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

In alternativa, è possibile selezionare Copia stream di dati dalla vista dei dettagli di un determinato stream 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. Quando è tutto pronto, seleziona Copia.

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

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.

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