Acquisire dati Algolia User Profiles in Experience Platform utilizzando l'interfaccia utente
Questa esercitazione ti guida attraverso l'acquisizione di dati dall'account Algolia User Profiles in Adobe Experience Platform tramite l'interfaccia utente.
Introduzione
IMPORTANTEQuesto tutorial presuppone la familiarità con i seguenti componenti di Experience Platform:
-
Experience Data Model (XDM) Sistema: il framework standardizzato utilizzato da Experience Platform per organizzare i dati sull'esperienza del cliente.
- Nozioni di base sulla composizione dello schema: informazioni sulla composizione dello schema, inclusi i principi chiave e le best practice.
- Esercitazione sull'editor di schemi: scopri come creare schemi personalizzati utilizzando l'interfaccia utente dell'editor di schemi.
-
Real-Time Customer Profile: profilo cliente unificato in tempo reale basato su dati aggregati provenienti da più origini.
-
Origini: acquisisci dati da varie origini e utilizza i servizi Experience Platform per strutturare, etichettare e migliorare i dati.
Raccogli le credenziali richieste
Per connettere Algolia a Adobe Experience Platform, fornisci le seguenti credenziali:
| Credenziali | Descrizione |
|---|---|
| ID applicazione | L'identificatore univoco assegnato al tuo account Algolia. |
| Chiave API | Credenziali per l'autenticazione e l'autorizzazione delle richieste API ai servizi di Algolia. |
Per ulteriori informazioni, consultare la Algolia documentazione di autenticazione.
Connetti il tuo account Algolia
Nell'interfaccia utente di Experience Platform, seleziona Origini dal menu di navigazione a sinistra per aprire l'area di lavoro Origini. Utilizza il pannello Categorie o la barra di ricerca per trovare l'origine desiderata.
Per connettere Algolia, scegli la scheda di origine Algolia in Partner dati e identità e seleziona Configura.
SUGGERIMENTO
Autenticazione
Usa un account esistente
Per utilizzare un account esistente, scegliere Account esistente e selezionare l'account Algolia User Profiles che si desidera utilizzare. Quindi seleziona Avanti.
Crea un nuovo account
Per creare un nuovo account, seleziona Nuovo account, quindi immetti un nome, una descrizione facoltativa e le credenziali di Algolia. Selezionare Connetti all'origine e attendere che la connessione venga stabilita.
Aggiungi dati
Dopo la creazione dell'account Algolia User Profiles, viene visualizzato il passaggio Aggiungi dati. Utilizzalo per selezionare e visualizzare in anteprima i dati del profilo utente da acquisire.
- A sinistra, immettere Indici e Affinità facoltativi.
- A destra, visualizza l’anteprima di un massimo di 100 righe di profili utente.
Al termine, seleziona Avanti.
Fornisci i dettagli del flusso di dati
Se utilizzi un set di dati esistente, scegli uno associato a uno schema che include il gruppo di campi Algolia Profile. Verificare che il campo Algolia User Token utilizzi lo spazio dei nomi dell'identità Algolia User Token. Se Algolia User Token non è attualmente creato o assegnato, le istruzioni sono fornite di seguito.
Se crei un nuovo set di dati, seleziona uno schema utilizzando il gruppo di campi Algolia Profile.
Crea spazio dei nomi identità Algolia User Token
È necessario creare lo spazio dei nomi dell'identità Algolia User Token se non esiste già nell'organizzazione.
Utilizza il menu di navigazione a sinistra e seleziona Identità per accedere all'area di lavoro dell'interfaccia utente di Identity Service, quindi seleziona Crea spazio dei nomi identità.
Quindi, fornisci un Nome visualizzato e un Simbolo identità per il tuo spazio dei nomi personalizzato. Durante questo passaggio, devi anche configurare il tipo di spazio dei nomi. Al termine, selezionare Crea.
| Configurazione spazio dei nomi personalizzato | Valore |
|---|---|
| Nome visualizzato | Algolia User Token |
| Simbolo identità | AlgoliaUserToken |
| Seleziona un tipo | Cookie ID |
Una volta aggiunto, lo spazio dei nomi viene visualizzato nell’elenco. Ora puoi applicarlo nello schema.
Applicare lo spazio dei nomi allo schema
Utilizza il menu di navigazione a sinistra e seleziona Schemi per accedere all'area di lavoro dell'interfaccia utente Schemi. Utilizzare l'area di lavoro schemi per creare o aggiornare uno schema con il gruppo di campi Algolia Profile Details. Quindi, passa al campo Token utente e utilizza la barra a destra per selezionare la casella Identità. Utilizzare inoltre la casella di input per definire lo spazio dei nomi dell'identità Algolia User Token. Al termine, selezionare Salva.
Dopo che al campo Token utente è stato assegnato lo spazio dei nomi dell'identità Algolia User Token, l'identità viene visualizzata nel profilo utente per qualsiasi profilo.
Mappare i campi dati su uno schema XDM
Utilizza l’interfaccia di mappatura per mappare i dati di origine sui campi dello schema. Per ulteriori informazioni, consulta la guida alla mappatura.
Pianificazione esecuzioni dell’acquisizione
Quindi, utilizza l’interfaccia di pianificazione per definire la pianificazione dell’acquisizione del flusso di dati.
| Configurazione pianificazione | Descrizione |
|---|---|
| Frequenza |
Configura la frequenza per indicare la frequenza con cui deve essere eseguito il flusso di dati. Puoi impostare la frequenza su:
|
| Intervallo |
Dopo aver selezionato una frequenza, puoi configurare l’impostazione dell’intervallo per stabilire l’intervallo di tempo tra ogni acquisizione. Ad esempio, se imposti la frequenza su giorno e configuri l’intervallo su 15, il flusso di dati verrà eseguito ogni 15 giorni. Impossibile impostare l'intervallo su zero. Il valore dell'intervallo minimo accettato per ciascuna frequenza è il seguente:
|
| Ora di inizio | La marca temporale per l’esecuzione prevista, presentata in fuso orario UTC. |
| Retrocompilazione | La retrocompilazione determina quali dati vengono inizialmente acquisiti. Se la retrocompilazione è abilitata, tutti i file correnti nel percorso specificato verranno acquisiti durante la prima acquisizione pianificata. Se la retrocompilazione è disattivata, verranno acquisiti solo i file caricati tra la prima esecuzione dell’acquisizione e l’ora di inizio. I file caricati prima dell’ora di inizio non verranno acquisiti. |
Verifica il flusso di dati
Utilizza la pagina di revisione per un riepilogo del flusso di dati prima dell’acquisizione. I dettagli sono raggruppati nelle seguenti categorie:
- Connessione - Mostra il tipo di origine, il percorso pertinente del file di origine scelto e il numero di colonne all'interno di tale file di origine.
- Assegna set di dati e mappa campi: mostra in quale set di dati vengono acquisiti i dati di origine, incluso lo schema a cui il set di dati è conforme.
- Pianificazione - Mostra il periodo attivo, la frequenza e l'intervallo della pianificazione di acquisizione.
Dopo aver rivisto il flusso di dati, seleziona Fine e attendi che venga creato un po' di tempo.
Passaggi successivi
Seguendo questa esercitazione, è stato creato un flusso di dati per portare dati intento dall'origine Algolia ad Experience Platform. Per ulteriori risorse, consulta la documentazione descritta di seguito.
Monitorare il flusso di dati
Una volta creato il flusso di dati, puoi monitorare i dati che vengono acquisiti tramite di esso per visualizzare informazioni su tassi di acquisizione, successo ed errori. Per ulteriori informazioni su come monitorare il flusso di dati, visita l'esercitazione su account di monitoraggio e flussi di dati nell'interfaccia utente.
Aggiornare il flusso di dati
Per aggiornare le configurazioni per la pianificazione, la mappatura e le informazioni generali dei flussi di dati, visita il tutorial su aggiornamento dei flussi di dati di origine nell'interfaccia utente.