Connettore di origine di Adobe Analytics per i dati della suite di rapporti

Adobe Experience Platform consente di acquisire dati Adobe Analytics tramite il connettore di origine Analytics. Il connettore trasmette i dati della suite di rapporti in un set di dati Platform in tempo reale, convertendoli in formato XDM.

Funzionamento del connettore di origine di Analytics

Continui a utilizzare l’implementazione di Adobe Analytics esistente, come AppMeasurement o l’estensione tag Adobe Analytics, per raccogliere dati nelle suite di rapporti. Il connettore di origine non modifica la modalità di raccolta o di creazione di rapporti su tali dati. Una volta che i dati raggiungono i server di raccolta dati di Analytics, il connettore ne acquisisce una copia.

Grafico che illustra il percorso di dati provenienti da diverse applicazioni Adobe, incluso Adobe Analytics.

Questa copia è una forma parzialmente elaborata di ogni hit, nota come mid-values. Analytics produce valori medi dopo la pre-elaborazione (ad esempio, le regole di elaborazione) ma prima dell’elaborazione a livello di visita e visitatore. Di conseguenza, non includono il contesto post-elaborazione, ad esempio il numero di visita. L’hit originale continua attraverso la pipeline per essere scritto come di consueto nella suite di rapporti.

Il connettore trasmette questi valori medi in un set di dati in Experience Platform in tempo reale. Dal data lake, i dati sono disponibili per Query Service e altre applicazioni di data discovery e possono arricchire Real-Time Customer Profile.

Per informazioni dettagliate su come Analytics raccoglie ed elabora i dati, inclusa la fase del valore intermedio, vedere Ordine di elaborazione per i dati in Adobe Analytics.

Mappatura dei campi di Adobe Analytics su XDM

Quando crei una connessione di origine nell’interfaccia utente di Experience Platform, i campi di Analytics vengono mappati automaticamente su XDM e acquisiti in un set di dati di Platform. Per istruzioni, consulta l’esercitazione sul connettore di origine di Analytics.

Per informazioni dettagliate sulla mappatura campi tra Analytics e Experience Platform, consulta la guida alla mappatura campi di Adobe Analytics.

IMPORTANT
Le trasformazioni della preparazione dati possono aggiungere latenza al flusso di dati complessivo. La quantità di latenza aggiuntiva varia in base alla complessità della logica di trasformazione.

Identificatori primari nei dati di Analytics

Ogni hit dal connettore di origine di Analytics contiene un identificatore primario che dipende dall’esistenza di un ECID o un AAID. Se è presente un ECID, questo viene designato come identificatore primario. Se è presente un AAID, questo viene designato come primario.

La tabella seguente fornisce ulteriori informazioni sui campi di identità nei dati di Analytics.

Campo identità
Descrizione
AAID
L’AAID è l’identificatore primario del dispositivo in Adobe Analytics ed è garantita la sua esistenza su ogni evento trasmesso tramite l’origine Analytics. AAID viene talvolta indicato come ID legacy di Analytics o come ID cookie s_vi. Nonostante ciò, viene creato un AAID anche se il cookie s_vi non è presente. AAID è rappresentato dalle colonne post_visid_high e post_visid_low nei feed dati di Analytics. In un dato evento, il campo AAID contiene una singola identità che può essere uno dei diversi tipi descritti nell’ordine delle operazioni per gli ID di Analytics. Nota: all’interno di un’intera suite di rapporti, un AAID può contenere diversi tipi tra gli eventi.
ECID
L’ECID (Experience Cloud ID) è un campo separato dell’identificatore del dispositivo, che viene popolato in Adobe Analytics quando Analytics viene implementato utilizzando il servizio ID visitatore. L’ECID viene talvolta indicato anche come MCID (Marketing Cloud ID). Se su un evento esiste un ECID, l’AAID può essere basato su ECID a seconda che il periodo di tolleranza di Analytics sia configurato o meno. ECID è rappresentato da mcvisid nei feed dati di Analytics. Per ulteriori informazioni su ECID, consulta la panoramica ECID. Per informazioni sul funzionamento di ECID con Analytics, consulta il documento su Richieste Analytics ed Experience Cloud ID.
AACUSTOMID
AACUSTOMID è un campo separato dell’identificatore che viene popolato in Adobe Analytics in base all’utilizzo della variabile visitorID nell’implementazione di Analytics. Se AACUSTOMID è presente, AAID è basato su AACUSTOMID perché AACUSTOMID supera tutti gli altri identificatori come definito dall’ordine delle operazioni per gli ID di Analytics.

Trattamento delle identità da parte dell’origine Analytics

L’origine di Analytics trasmette queste identità ad Experience Platform in formato XDM come:

  • endUserIDs._experience.aaid.id
  • endUserIDs._experience.mcid.id
  • endUserIDs._experience.aacustomid.id

Questi campi non sono contrassegnati come identità. Le stesse identità (se presenti nell’evento) vengono invece copiate in identityMap di XDM come coppie chiave-valore:

  • { "key": "AAID", "value": [ { "id": "<identity>", "primary": <true or false> } ] }
  • { "key": "ECID", "value": [ { "id": "<identity>", "primary": <true or false> } ] }
  • { "key": "AACUSTOMID", "value": [ { "id": "<identity>", "primary": false } ] }

Quando l’identità o le identità vengono copiate in identityMap, anche endUserIDs._experience.mcid.namespace.code viene impostato sullo stesso evento:

  • Se AAID è presente, endUserIDs._experience.aaid.namespace.code è impostato su “AAID”.
  • Se ECID è presente, endUserIDs._experience.mcid.namespace.code è impostato su “ECID”.
  • Se AACUSTOMID è presente, endUserIDs._experience.aacustomid.namespace.code è impostato su “AACUSTOMID”.

Nella mappa di identità, se ECID è presente, viene contrassegnato come identità primaria dell’evento. In questo caso, AAID può essere basato su ECID a causa del periodo di tolleranza del servizio ID visitatore. In caso contrario, AAID è contrassegnato come identità primaria dell’evento. AACUSTOMID non viene mai contrassegnato come ID primario dell’evento. Tuttavia, se AACUSTOMID è presente, AAID è basato su AACUSTOMID a causa dell’ordine delle operazioni di Experience Cloud.

Migrare la gestione della privacy privacy

Utilizza Adobe Experience Platform Privacy Service per elaborare le richieste di privacy per il set di dati di origine Adobe Analytics. Innanzitutto, controlla le etichette della suite di rapporti. Quindi, configura manualmente le identità dello schema e le etichette di utilizzo dei dati. Infine, cambia l’origine privacy per il flusso di dati.

Scopri come gestire le richieste di accesso a dati personali nella panoramica di Privacy Service.

IMPORTANT
Adobe Analytics offusca gli identificatori durante l'elaborazione delle richieste di eliminazione della privacy e conserva i dati hit rimanenti. Experience Platform elimina invece le righe corrispondenti, il che può modificare le metriche di reporting. La ricreazione delle etichette non mantiene il comportamento di eliminazione di Analytics.

Etichette per suite di rapporti di revisione review-analytics-privacy-rules

Prima di eseguire la migrazione, controlla le etichette e gli spazi dei nomi delle identità per la suite di rapporti che fornisce il set di dati. È necessaria l’autorizzazione di amministratore Governance dei dati in Adobe Analytics.

  1. In Adobe Analytics, passa a Amministratore > Tutti gli amministratori > Configurazione e raccolta dati > Governance dati.
  2. Seleziona la suite di rapporti.
  3. Esamina le etichette delle variabili per identità, riservatezza, accesso ed eliminazione, insieme agli spazi dei nomi di identità configurati.

Nella griglia delle etichette per la privacy di Adobe Analytics sono elencate le variabili della suite di rapporti con le impostazioni di identità, riservatezza, accesso, eliminazione e spazio dei nomi.

Scopri le etichette nella panoramica sull’etichettatura della privacy. Segui le istruzioni per assegnare o modificare le etichette di privacy della suite di rapporti. Rivedi le definizioni di etichette privacy dati per le variabili.

Ricrea configurazione privacy configure-platform-privacy

Configura manualmente identità ed etichette nello schema per il set di dati di origine di Analytics. Experience Platform non copia automaticamente le etichette da Adobe Analytics.

Configura le identità dello schema separatamente dalle etichette di utilizzo dei dati. Utilizza la tabella per mappare le etichette di Analytics alle impostazioni di Experience Platform.

Etichetta Adobe Analytics
Configurazione Experience Platform
ID-DEVICE
Contrassegna il campo schema corrispondente come identità.
ID-PERSON
Contrassegna il campo schema corrispondente come identità.
I1
Applica l’etichetta di utilizzo dati I1.
I2
Applica l’etichetta di utilizzo dati I2.
S1
Applica l’etichetta di utilizzo dati S1.
S2
Applica l’etichetta di utilizzo dati S2.
ACC-ALL, ACC-PERSON
Experience Platform non supporta queste etichette. Le richieste di accesso restituiscono tutti i dati negli hit corrispondenti. Non è possibile selezionare i campi da restituire.
DEL-DEVICE, DEL-PERSON
Non ricreare queste etichette. Experience Platform elimina le righe corrispondenti invece di offuscare gli identificatori.

Applica ulteriori etichette di utilizzo dati, incluse C1 tramite C12, PSPD e RHD, se applicabile. Le etichette aggiuntive non hanno equivalenti diretti di Analytics. Le etichette I1, I2, S1 e S2 hanno significati corrispondenti, ma i prodotti li utilizzano per scopi diversi.

IMPORTANT
La modifica delle identità dello schema o delle etichette dei campi influisce su ogni set di dati che utilizza lo schema. Rivedi i set di dati interessati prima di modificare lo schema.

Prima di cambiare l’origine della privacy, configura le identità e le etichette di utilizzo dei dati.

  1. In Experience Platform, seleziona Schemi, quindi apri lo schema per il set di dati di origine di Analytics.

  2. Utilizza Mappatura campi Adobe Analytics per trovare i campi schema per le variabili Analytics con etichetta.

  3. Contrassegna i campi dello schema mappati da ID-DEVICE o ID-PERSON variabili come identità.

    Segui le istruzioni di configurazione identità dello schema per configurare i campi di identità e gli spazi dei nomi.

  4. Nella scheda Etichette, seleziona i campi che richiedono le etichette di utilizzo dei dati.

  5. Seleziona Applica etichette di accesso e governance dei dati, quindi seleziona le etichette applicabili dalla tabella di mappatura.

  6. Seleziona Salva.

Per istruzioni dettagliate, leggi come applicare etichette a uno schema.

Controlla le impostazioni personalizzate della privacy di Analytics, le regole VISTA e le configurazioni del canale marketing e in base al contenuto. Rivedi anche le trasformazioni della preparazione dati. Configura identità ed etichette per eventuali campi aggiuntivi che li richiedono.

Cambia l’origine della privacy switch-privacy-source

Dopo aver configurato identità ed etichette, cambia l’origine privacy nell’area di lavoro Origini di Experience Platform. La migrazione influisce sul set di dati associato al flusso di dati selezionato, non sull’intera organizzazione.

IMPORTANT
Non è possibile annullare la migrazione dopo l'avvio del processo. Per riavviare la migrazione, eliminare la connessione e crearla nuovamente.
  1. In Origini, selezionare Flussi dati e aprire il menu del flusso di dati di cui si desidera eseguire la migrazione.

    Il menu del flusso di dati include l'azione Migra privacy ad AEP.

  2. Seleziona Migra privacy ad AEP per aprire la finestra di dialogo di conferma.

    Rivedi il promemoria della configurazione nella finestra di dialogo di conferma prima di continuare.

    La finestra di dialogo di migrazione della privacy include una conferma di configurazione e l'azione Avvia migrazione.

  3. Conferma la configurazione della privacy del set di dati selezionando la casella di controllo di conferma.

  4. Seleziona Avvia migrazione.

    In Flussi dati, nella colonna Gestione privacy è visualizzato Migrazione ad AEP con un avviso di transizione.

    Nella colonna Gestione della privacy è visualizzato Migrazione ad AEP e un avviso di transizione.

Precisione della marca temporale dell’hit e ordinamento degli eventi

Il connettore riceve i dati di Analytics come valori medi, che contengono timestamp di hit di secondo livello. Poiché Analytics registra il tempo solo con precisione di secondo livello e non tiene traccia della tempistica dei secondi secondari, l’ordine degli hit raccolti nello stesso secondo non è deterministico. Di conseguenza, l’ordine degli eventi dello stesso secondo acquisiti tramite il connettore può differire dall’ordine mostrato nel reporting di Analytics.

Customer Journey Analytics risolve i timestamp in millisecondi, ma i dati originati da Analytics popolano solo interi secondi. Il solo timestamp non può quindi stabilire l’ordine relativo degli eventi che condividono lo stesso secondo. Ciò è più evidente quando più hit vengono raccolti nello stesso secondo (ad esempio, una visualizzazione di pagina e un hit di Adobe Target (A4T)).

Per ulteriori informazioni sulla precisione delle marche temporali di Analytics, consulta la variabile timestamp di Adobe Analytics e la documentazione Hit depth. Per i campi di marca temporale mappati dal connettore a XDM (hit_time_gmt e post_cust_hit_time_gmt), consulta la guida alla mappatura dei campi di Adobe Analytics.

Le opzioni per la precisione della marca temporale includono:

  • Accettare differenze di ordinamento minori nello stesso secondo. Per la maggior parte dei rapporti, l’effetto è limitato agli eventi che condividono lo stesso secondo e non influisce sulle metriche aggregate. Questo è l’approccio consigliato, anche per scenari misti di visualizzazione pagina e Adobe Target (A4T).
  • Per i casi d’uso sensibili all’ordine, preferisci il Web SDK. L’invio di dati tramite Adobe Experience Platform Web SDK direttamente in Experience Platform e Customer Journey Analytics consente di mantenere la precisione della marca temporale dei secondi secondari (millisecondi) ed evita la rielaborazione di Analytics. Questo approccio è consigliato quando l’ordine degli eventi è importante.

Latenza e retrocompilazione dei dati

La latenza prevista per i dati di Analytics su Experience Platform è descritta nella tabella seguente. La latenza varia a seconda della configurazione del cliente, dei volumi di dati e delle applicazioni consumer. Ad esempio, se l’implementazione di Analytics è configurata con A4T, la latenza della pipeline aumenta di 5-10 minuti.

Dati di Analytics
Latenza prevista
Nuovi dati per Real-Time Customer Profile (A4T non abilitato)
< 2 minuti
Nuovi dati per Real-Time Customer Profile (A4T è abilitato)
fino a 30 minuti
Nuovi dati nel data lake di
< 2,25 ore
Nuovi dati in Customer Journey Analytics senza unione
< 3,75 ore
Nuovi dati per Customer Journey Analytics con unione
< 7 ore
Backfill di meno di 10 miliardi di eventi
< 4 settimane

Per ulteriori informazioni sulle latenze di Customer Journey Analytics, vedere: Guardrail Customer Journey Analytics.

Il valore predefinito della retrocompilazione di Analytics per le sandbox di produzione è 13 mesi. Per i dati di Analytics nelle sandbox non di produzione, la retrocompilazione è impostata su tre mesi. Il limite di 10 miliardi di eventi menzionato nella tabella precedente è strettamente in relazione alla latenza prevista.

Quando crei un flusso di dati di origine Analytics in una sandbox di produzione, vengono creati due flussi di dati:

  • Un flusso di dati che esegue una retrocompilazione di 13 mesi dei dati storici della suite di rapporti nel data lake. Questo flusso di dati termina quando la retrocompilazione è completa.
  • Un flusso di dati che invia dati live al data lake e al profilo cliente in tempo reale. Questo flusso di dati viene eseguito in modo continuo.

Best practice

Segui queste best practice per evitare di superare i diritti di licenza e di travolgere le metriche di archiviazione totale e ricchezza dei dati:

  • Imposta Experience Event Dataset Retention Time-To-Live (TTL) all’inizio per ottimizzare la gestione del ciclo di vita dei dati e l’efficienza dello storage. Per ulteriori dettagli, consulta la guida su gestione della conservazione dei set di dati di Experience Event nel data lake tramite TTL.
  • Quando crei un flusso di dati di origine Analytics, inizia configurando il connettore per acquisire i dati solo nel data lake. Dopo aver confermato che il flusso di dati funziona, puoi abilitare l’acquisizione del profilo per il set di dati. Questo approccio funziona al meglio quando i filtri di riga e colonna riducono efficacemente il volume di dati. Per ulteriori informazioni, consulta la documentazione sulla connessione di Adobe Analytics ad Experience Platform.

Domande frequenti

I dati di backfill di Analytics vengono conteggiati nel conteggio dei profili con licenza?
No. I dati di backfill di Analytics non vengono acquisiti nel profilo, quindi non vengono conteggiati per i diritti della licenza.
Posso importare più di 13 mesi di dati storici?
Per impostazione predefinita, la retrocompilazione di Analytics per le sandbox di produzione è di 13 mesi e le sandbox non di produzione sono limitate a tre mesi. Per le sandbox di produzione, se hai concesso in licenza lo SKU aggiuntivo che ti autorizza a importare più di 13 mesi di dati di backfill storici, contatta Adobe per richiedere la backfill estesa.
Come posso impedire l’acquisizione di identità secondarie (AAID e AACUSTOMID) nel profilo cliente in tempo reale?
Puoi utilizzare la preparazione dati per filtrare le identità secondarie provenienti da Analytics, come AAID e AACUSTOMID. Se escluse, queste identità non vengono acquisite nel profilo anche se sono disponibili nei dati Analytics in arrivo.
recommendation-more-help
experience-platform-help-sources