DocumentazioneExperience PlatformGuida ai connettori di origini

Connettere Adobe Analytics ad Experience Platform

Ultimo aggiornamento: 21 maggio 2025
  • Argomenti:

Creato per:

  • Sviluppatore

Leggi questa guida per scoprire come utilizzare l’origine di Adobe Analytics per acquisire in Adobe Experience Platform i dati della suite di rapporti di Analytics.

Introduzione

Questo tutorial richiede una buona conoscenza dei seguenti componenti di Experience Platform:

  • Experience Data Model (XDM) System: framework standardizzato tramite il quale Experience Platform organizza i dati sull'esperienza del cliente.
  • Profilo cliente in tempo reale: fornisce un profilo consumatore unificato in tempo reale basato su dati aggregati provenienti da più origini.
  • Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

Terminologia chiave

È importante comprendere i seguenti termini chiave utilizzati nel presente documento:

  • Attributo standard: gli attributi standard sono qualsiasi attributo predefinito da Adobe. Contengono lo stesso significato per tutti i clienti e sono disponibili nei gruppi di campi Dati di origine e Schema di Analytics.
  • Attributo personalizzato: gli attributi personalizzati sono qualsiasi attributo nella gerarchia delle variabili personalizzate in Analytics. Gli attributi personalizzati vengono utilizzati all’interno di un’implementazione di Adobe Analytics per acquisire informazioni specifiche in una suite di rapporti e possono differire nel loro utilizzo da una suite di rapporti all’altra. Gli attributi personalizzati includono eVar, prop ed elenchi. Per ulteriori informazioni sulle eVar, consulta la documentazione di Analytics sulle variabili di conversione.
  • Qualsiasi attributo nei gruppi di campi personalizzati: gli attributi che provengono dai gruppi di campi creati dai clienti sono tutti definiti dall'utente e non sono considerati né attributi standard né personalizzati.

Navigare nel catalogo delle origini

NOTE
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.
  • Flusso di dati che invia dati live al data lake e a Real-Time Customer Profile. Questo flusso di dati viene eseguito in modo continuo.

Nell'interfaccia utente di Experience Platform, seleziona Origini dal menu di navigazione a sinistra per accedere all'area di lavoro Origini. Nella categoria Applicazioni Adobe, seleziona la scheda Adobe Analytics, quindi seleziona Aggiungi dati.

Catalogo delle origini con la scheda di origine di Adobe Analytics selezionata.

Selezionare i dati

IMPORTANT
  • Le suite di rapporti elencate sullo schermo possono provenire da varie aree geografiche. L’utente è responsabile della comprensione delle limitazioni e degli obblighi relativi ai suoi dati e di come utilizza tali dati in Adobe Experience Platform in aree geografiche diverse. Assicurati che ciò sia consentito dalla tua azienda.
  • I dati provenienti da più suite di rapporti possono essere abilitati per Real-Time Customer Profile solo se non sono presenti conflitti di dati, ad esempio due proprietà personalizzate (eVar, elenchi e proprietà) con un significato diverso.

Una suite di rapporti è un contenitore di dati che costituisce la base del reporting di Analytics. Un’organizzazione può avere molte suite di rapporti, ciascuna contenente set di dati diversi.

Puoi acquisire suite di rapporti da qualsiasi area geografica (Stati Uniti, Regno Unito o Singapore) purché siano mappate sulla stessa organizzazione dell’istanza sandbox di Experience Platform in cui viene creata la connessione di origine. Una suite di rapporti può essere acquisita utilizzando un solo flusso di dati attivo. Se una suite di rapporti è grigia e non può essere selezionata, significa che è già stata acquisita nella sandbox in uso o in una sandbox diversa.

È possibile effettuare più connessioni in-bound per portare più suite di rapporti nella stessa sandbox. Se le suite di rapporti hanno schemi diversi per le variabili (ad esempio eVar o eventi), è necessario mapparle su campi specifici nei gruppi di campi personalizzati ed evitare conflitti di dati utilizzando Preparazione dati. Le suite di rapporti possono essere aggiunte solo a una singola sandbox.

Seleziona la suite di rapporti, quindi utilizza l'interfaccia Dati aggiunta origine di Analytics per spostarti nell'elenco e identificare la suite di rapporti di Analytics che desideri acquisire in Experience Platform. Seleziona Avanti per procedere.

È selezionata una suite di rapporti di analisi per lacquisizione ed è evidenziato il pulsante Successivo

<!- Le suite di rapporti di Analytics possono essere configurate per una sandbox alla volta. Per importare la stessa suite di rapporti in una sandbox diversa, è necessario eliminare il flusso del set di dati e crearne di nuovo un’istanza tramite la configurazione per una sandbox diversa.—>

Mappatura

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

Prima di poter mappare i dati di Analytics sullo schema XDM di destinazione, è necessario determinare se si utilizza uno schema predefinito o personalizzato.

Schema predefinito

Uno schema predefinito crea un nuovo schema per tuo conto. Questo schema appena creato contiene il gruppo di campi Adobe Analytics ExperienceEvent Template. Per utilizzare uno schema predefinito, selezionare Schema predefinito.

Passaggio di selezione dello schema del flusso di lavoro di origine di Analytics, con Schema predefinito selezionato.

Schema personalizzato

Con uno schema personalizzato, puoi scegliere qualsiasi schema disponibile per i dati di Analytics, purché tale schema abbia il gruppo di campi Adobe Analytics ExperienceEvent Template. Per utilizzare uno schema personalizzato, selezionare Schema personalizzato.

Passaggio di selezione dello schema del flusso di lavoro di origine di Analytics, con Schema personalizzato selezionato.

Utilizza l'interfaccia Mapping per mappare i campi sorgente ai campi schema di destinazione appropriati. Puoi mappare le variabili personalizzate ai nuovi gruppi di campi dello schema e applicare i calcoli come supportato dalla preparazione dati. Seleziona uno schema di destinazione per avviare il processo di mappatura.

TIP
Nel menu di selezione dello schema vengono visualizzati solo gli schemi con il gruppo di campi Adobe Analytics ExperienceEvent Template. Gli altri schemi vengono omessi. Se non sono disponibili schemi appropriati per i dati della suite di rapporti, devi creare un nuovo schema. Per i passaggi dettagliati sulla creazione di schemi, consulta la guida su creazione e modifica di schemi nell'interfaccia utente.

Pannello di selezione dello schema di destinazione dellinterfaccia di mappatura.

Puoi fare riferimento al pannello Mapping campi standard per le metriche delle Mappature standard applicate. Mappature standard con conflitti di nome descrittore e Custom mappings.

Mappa campi standard
Descrizione
Mappature standard applicate
Il pannello Mappature standard applicate visualizza il numero totale di attributi mappati. Le mappature standard si riferiscono alle mappature tra tutti gli attributi nei dati Analytics di origine e gli attributi corrispondenti nel gruppo di campi Analytics. Questi sono premappati e non possono essere modificati.
Mappature standard con conflitti di nome descrittore
Il pannello Mappature standard con conflitti di nome descrittore fa riferimento al numero di attributi mappati che contengono conflitti di nome. Questi conflitti vengono visualizzati quando si riutilizza uno schema che dispone già di un set popolato di descrittori di campo di una suite di rapporti diversa. Puoi procedere con il flusso di dati di Analytics anche con conflitti di nomi.
Mappature personalizzate
Il pannello Mappature personalizzate visualizza il numero di attributi personalizzati mappati, inclusi eVar, prop ed elenchi. Le mappature personalizzate si riferiscono alla mappatura tra gli attributi personalizzati nei dati Analytics di origine e gli attributi nei gruppi di campi personalizzati inclusi nello schema selezionato.

Mappature standard

Experience Platform rileva automaticamente la mappatura per eventuali conflitti di nomi. Se non ci sono conflitti con le tue mappature, seleziona Successivo per continuare.

Lintestazione delle mappature standard non visualizza alcun conflitto di nomi

TIP
In caso di conflitti di nomi tra la suite di rapporti di origine e lo schema selezionato, puoi comunque continuare con il flusso di dati di Analytics, riconoscendo che i descrittori dei campi non verranno modificati. In alternativa, puoi scegliere di creare un nuovo schema con un set vuoto di descrittori.

Mappature personalizzate

È possibile utilizzare le funzioni di preparazione dati per aggiungere nuove mappature personalizzate o campi calcolati per gli attributi personalizzati. Per aggiungere mappature personalizzate, selezionare Personalizzato.

Scheda di mappatura personalizzata nel flusso di lavoro di origine di Analytics.

  • Filtra campi: utilizza l'input di testo Filtra campi per filtrare specifici campi di mappatura nei mapping.
  • Aggiungi nuova mappatura: per aggiungere una nuova mappatura del campo di origine e del campo di destinazione, selezionare Aggiungi nuova mappatura.
  • Aggiungi campo calcolato: se necessario, seleziona Aggiungi campo calcolato per creare un nuovo campo calcolato per i mapping.
  • Mappatura importazione: puoi ridurre il tempo di configurazione manuale del processo di acquisizione dei dati e limitare gli errori utilizzando la funzionalità di mappatura importazione della preparazione dati. Selezionare Importa mapping per importare i mapping da un flusso esistente o da un file esportato. Per ulteriori informazioni, leggere la guida all'importazione e all'esportazione dei mapping.
  • Scarica modello: puoi anche scaricare una copia CSV delle mappature e configurare le mappature nel dispositivo locale. Seleziona Scarica modello per scaricare una copia CSV delle tue mappature. È necessario assicurarsi di utilizzare solo i campi forniti nel file di origine e nello schema di destinazione.

Per ulteriori informazioni sulla preparazione dati, consulta la seguente documentazione.

  • Panoramica sulla preparazione dati
  • Funzioni di mappatura della preparazione dati
  • Aggiungere campi calcolati

Filtraggio in base a profilo cliente in tempo reale

Dopo aver completato le mappature per i dati della suite di rapporti di Analytics, puoi applicare regole e condizioni di filtro per includere o escludere selettivamente i dati dall’acquisizione nel Profilo cliente in tempo reale. Il supporto per il filtro è disponibile solo per i dati di Analytics e i dati vengono filtrati solo prima dell'immissione di Profile. Tutti i dati vengono acquisiti nel data lake.

recommendation-more-help

Ulteriori informazioni sulla preparazione dei dati e sul filtraggio dei dati di Analytics per Real-Time Customer Profile

  • Puoi utilizzare la funzionalità di filtro per i dati che vanno nel profilo, ma non per i dati che vanno nel data lake.
  • Puoi utilizzare il filtro per i dati live, ma non puoi filtrare i dati di retrocompilazione.
    • L’origine di Analytics non esegue il backfill dei dati nel profilo.
  • Se utilizzi le configurazioni di Preparazione dati durante la configurazione iniziale di un flusso Analytics, queste modifiche vengono applicate anche alla retrocompilazione automatica di 13 mesi.
    • Tuttavia, questo non avviene per il filtro, perché il filtro è riservato solo ai dati live.
  • La preparazione dati viene applicata ai percorsi di acquisizione in streaming e in batch. Se modifichi una configurazione di Preparazione dati esistente, tali modifiche vengono quindi applicate ai nuovi dati in arrivo attraverso i percorsi di acquisizione in streaming e in batch.
    • Tuttavia, eventuali configurazioni della preparazione dati non si applicano ai dati che sono già stati acquisiti in Experience Platform, indipendentemente dal fatto che si tratti di dati in streaming o batch.
  • Gli attributi standard di Analytics vengono sempre mappati automaticamente. Pertanto, non è possibile applicare trasformazioni agli attributi standard.
    • Tuttavia, puoi filtrare gli attributi standard purché non siano richiesti in Identity Service o Profile.
  • Non è possibile utilizzare il filtro a livello di colonna per filtrare i campi obbligatori e i campi di identità.
  • Anche se è possibile filtrare le identità secondarie, in particolare AAID e AACustomID, non è possibile filtrare ECID.
  • Quando si verifica un errore di trasformazione, la colonna corrispondente restituisce NULL.

Filtro a livello di riga

IMPORTANT
Utilizza il filtro a livello di riga per applicare condizioni e stabilire quali dati includere nell’acquisizione per il profilo. Utilizza il filtro a livello di colonna per selezionare le colonne di dati da escludere per l'acquisizione del profilo.

Puoi filtrare i dati per l’acquisizione del profilo a livello di riga e di colonna. Utilizza il filtro a livello di riga per definire criteri quali stringa contiene, è uguale a, inizia o termina con. È inoltre possibile utilizzare il filtro a livello di riga per unire le condizioni utilizzando AND e OR e negare le condizioni utilizzando NOT.

Per filtrare i dati di Analytics a livello di riga, seleziona Filtro riga e utilizza la barra a sinistra per spostarti nella gerarchia dello schema e identificare l'attributo dello schema che desideri selezionare.

Interfaccia filtro righe per i dati di Analytics.

Dopo aver identificato l’attributo da configurare, selezionalo e trascinalo dalla barra a sinistra al pannello di filtro.

Attributo Manufacturer selezionato per il filtro.

Per configurare condizioni diverse, selezionare è uguale a, quindi selezionare una condizione dalla finestra a discesa visualizzata.

L’elenco delle condizioni configurabili include:

  • è uguale a
  • è diverso da
  • inizia con
  • termina con
  • non termina con
  • contiene
  • non contiene
  • esiste
  • non esiste

Elenco a discesa delle condizioni con un elenco di operatori delle condizioni.

Immettere quindi i valori che si desidera includere in base all'attributo selezionato. Nell'esempio seguente, Apple e Google sono selezionati per l'acquisizione come parte dell'attributo Manufacturer.

Pannello di filtro contenente gli attributi e i valori selezionati.

Per specificare ulteriormente le condizioni di filtro, aggiungi un altro attributo dallo schema, quindi aggiungi i valori basati su tale attributo. Nell'esempio seguente viene aggiunto l'attributo Model e i modelli come iPhone 16 e Google Pixel 9 vengono filtrati per l'acquisizione.

Attributi e valori aggiuntivi inclusi nel contenitore.

Per aggiungere un nuovo contenitore, selezionare i puntini di sospensione (...) in alto a destra nell'interfaccia di filtro, quindi selezionare Aggiungi contenitore.

Menu a discesa Aggiungi contenitore selezionato.

Dopo aver aggiunto un nuovo contenitore, seleziona Includi, quindi seleziona Escludi dal menu a discesa. Aggiungere gli attributi e i valori che si desidera escludere e quindi al termine selezionare Avanti.

Attributi e valori filtrati per lesclusione.

Filtraggio a livello di colonna

Seleziona Filtro colonna dall'intestazione per applicare il filtro a livello di colonna.

La pagina si aggiorna in una struttura di schema interattiva, che mostra gli attributi dello schema a livello di colonna. Da qui, puoi selezionare le colonne di dati da escludere dall’acquisizione del profilo. In alternativa, è possibile espandere una colonna e selezionare attributi specifici per l'esclusione.

Per impostazione predefinita, tutte le analisi passano a Profilo e questo processo consente di escludere i rami di dati XDM dall’acquisizione del profilo.

Interfaccia filtro colonne con struttura dello schema.

Filtra identità secondarie

Utilizza un filtro a colonne per escludere le identità secondarie dall’acquisizione del profilo. Per filtrare le identità secondarie, selezionare Filtro colonna, quindi selezionare _identità.

Il filtro si applica solo quando un’identità è contrassegnata come secondaria. Se sono selezionate identità ma arriva un evento con una delle identità contrassegnate come primarie, queste non vengono filtrate.

Identità secondarie nellalbero dello schema per il filtro delle colonne.

Fornisci i dettagli del flusso di dati

Viene visualizzato il passaggio Dettagli flusso di dati, in cui è necessario fornire un nome e una descrizione facoltativa per il flusso di dati. Al termine, seleziona Avanti.

Interfaccia dettagli flusso di dati. del flusso di lavoro di acquisizione.

Revisione

Viene visualizzato il passaggio Rivedi, che consente di rivedere il nuovo flusso di dati di Analytics prima che venga creato. I dettagli della connessione sono raggruppati per categorie, tra cui:

  • Connessione: visualizza la piattaforma di origine della connessione.
  • Tipo di dati: visualizza la suite di rapporti selezionata e il relativo ID suite di rapporti.

Interfaccia di revisione del flusso di lavoro di acquisizione.

Monitorare il flusso di dati

Una volta completato il flusso di dati, puoi utilizzare l'interfaccia Flussi di dati per monitorare lo stato del flusso di dati di Analytics.

Utilizza l'interfaccia dell'attività set di dati per informazioni sull'avanzamento dei dati inviati da Analytics ad Experience Platform. L’interfaccia visualizza metriche quali il totale dei record del mese precedente, il totale dei record acquisiti negli ultimi sette giorni e le dimensioni dei dati nel mese precedente.

L’origine crea un’istanza di due flussi di set di dati. Un flusso rappresenta i dati di backfill e l’altro è per i dati live. I dati di backfill non sono configurati per l’acquisizione in Real-Time Customer Profile, ma vengono inviati al data lake per casi d’uso analitici e di data science.

Per ulteriori informazioni sulla retrocompilazione, sui dati live e sulle rispettive latenze, consulta la Panoramica sull'origine di Analytics.

Pagina attività set di dati per un set di dati di destinazione specifico per i dati di Adobe Analytics.

NOTE
La pagina dell’attività del set di dati non visualizza informazioni sui batch, poiché il connettore di origine di Analytics è interamente gestito da Adobe. Puoi monitorare il flusso dei dati osservando le metriche relative ai record acquisiti.

Eliminare il flusso di dati

Per eliminare il flusso di dati di Analytics, seleziona Flussi di dati dall'intestazione superiore dell'area di lavoro origini. Utilizzare la pagina Flussi dati per individuare il flusso di dati di Analytics che si desidera eliminare, quindi selezionare i puntini di sospensione (...) accanto ad esso. Quindi, utilizzare il menu a discesa e selezionare Elimina.

  • Se elimini il flusso di dati live Analytics, verrà eliminato anche il relativo set di dati sottostante.
  • L’eliminazione del flusso di dati di backfill di Analytics non elimina il set di dati sottostante, ma interrompe il processo di backfill per la suite di rapporti corrispondente. Se elimini il flusso di dati di retrocompilazione, i dati acquisiti possono comunque essere visualizzati attraverso il set di dati.

Passaggi successivi e risorse aggiuntive

Una volta creata la connessione, il flusso di dati viene creato automaticamente per contenere i dati in arrivo e popolare un set di dati con lo schema selezionato. Inoltre, avviene il recupero dei dati e acquisisce fino a 13 mesi di dati storici. Al termine dell'acquisizione iniziale, i dati di Analytics e verranno utilizzati dai servizi Experience Platform a valle come Real-Time Customer Profile e Segmentation Service. Per ulteriori informazioni, consulta i seguenti documenti:

  • Panoramica di Real-Time Customer Profile
  • Panoramica di Segmentation Service
  • Panoramica di Data Science Workspace
  • Panoramica di Query Service

Il seguente video ha lo scopo di chiarire come acquisire dati utilizzando il connettore Source di Adobe Analytics:

WARNING
L'interfaccia utente Experience Platform mostrata nel video seguente non è aggiornata. Per le schermate e le funzionalità più recenti dell’interfaccia utente, consulta la documentazione precedente.
https://video.tv.adobe.com/v/3430258?quality=12&learn=on&captions=ita
337b99bb-92fb-42ae-b6b7-c7042161d089