[Beta]{class="badge informative"}
Acquisire i dati dei pagamenti dall'account Stripe per Experience Platform utilizzando l'interfaccia utente
Leggi l'esercitazione seguente per scoprire come acquisire i dati dei pagamenti dall'account Stripe a Adobe Experience Platform utilizzando l'interfaccia utente.
Introduzione
Questo tutorial richiede una buona conoscenza dei seguenti componenti di Experience Platform:
-
Experience Data Model (XDM) Sistema: framework standardizzato tramite il quale Experience Platform organizza i dati sull'esperienza del cliente.
- Nozioni di base sulla composizione dello schema: scopri i blocchi predefiniti di base degli schemi XDM, inclusi i principi chiave e le best practice nella composizione dello schema.
- Esercitazione sull'editor di schemi: scopri come creare schemi personalizzati utilizzando l'interfaccia utente dell'editor di schemi.
-
Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
Autenticazione
Leggi la Stripe panoramica per informazioni su come recuperare le credenziali di autenticazione.
Connetti il tuo account Stripe connect
Nell'interfaccia utente di Platform, seleziona Origini dal menu di navigazione a sinistra per accedere all'area di lavoro Origini. Puoi selezionare la categoria appropriata dal catalogo sul lato sinistro dello schermo. In alternativa, è possibile trovare l’origine specifica che si desidera utilizzare utilizzando l’opzione di ricerca.
Nella categoria Pagamenti, selezionare Stripe, quindi Configura.
Viene visualizzata la pagina Connetti account di Stripe. In questa pagina è possibile utilizzare credenziali nuove o esistenti.
Per creare un nuovo account, selezionare Nuovo account e fornire un nome, una descrizione facoltativa e le credenziali.
Al termine, selezionare Connetti all'origine e quindi attendere un po' di tempo per stabilire la nuova connessione.
| table 0-row-2 1-row-2 | |
|---|---|
| Credenziali | Descrizione |
| Token di accesso | Il token di accesso Stripe. Per informazioni su come recuperare il token di accesso, leggere la Stripe guida all'autenticazione. |
Per utilizzare un account esistente, selezionare Account esistente, quindi selezionare l'account che si desidera utilizzare dal catalogo degli account esistente.
Seleziona Avanti per procedere.
Selezionare i dati select-data
Ora che hai accesso al tuo account, devi identificare il percorso appropriato per i dati Stripe che desideri acquisire. Selezionare Percorso risorsa, quindi selezionare l'endpoint da cui si desidera acquisire i dati. I Stripe endpoint disponibili sono:
- Spese
- Abbonamenti
- Rimborsi
- Transazioni saldo
- Clienti
- Prezzi
Dopo aver selezionato l'endpoint, l'interfaccia si aggiorna in una schermata di anteprima, visualizzando la struttura dati dell'endpoint Stripe selezionato. Seleziona Avanti per procedere.
Fornisci i dettagli del set di dati e del flusso di dati provide-dataset-and-dataflow-details
Quindi, devi fornire informazioni sul set di dati e sul flusso di dati.
Dettagli del set di dati dataset-details
Un set di dati è un costrutto di archiviazione e gestione per una raccolta di dati, in genere una tabella, che contiene uno schema (colonne) e dei campi (righe). I dati acquisiti correttamente in Experience Platform vengono memorizzati nel data lake come set di dati. Durante questo passaggio, puoi creare un nuovo set di dati o utilizzare un set di dati esistente.
Per utilizzare un nuovo set di dati, selezionare Nuovo set di dati, quindi specificare un nome e una descrizione facoltativa per il set di dati. Devi anche selezionare uno schema Experience Data Model (XDM) a cui aderisce il set di dati.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Dettagli nuovo set di dati | Descrizione |
| Nome set di dati di output | Nome del nuovo set di dati. |
| Descrizione | (Facoltativo) Breve spiegazione del nuovo set di dati. |
| Schema | Elenco a discesa degli schemi esistenti nell’organizzazione. Puoi anche creare uno schema personalizzato prima del processo di configurazione sorgente. Per ulteriori informazioni, consulta la guida su creazione di uno schema XDM nell'interfaccia utente. |
Se disponi già di un set di dati, seleziona Set di dati esistente e quindi utilizza l'opzione Ricerca avanzata per visualizzare una finestra di tutti i set di dati dell'organizzazione, inclusi i rispettivi dettagli, ad esempio se sono abilitati o meno per l'acquisizione in Real-Time Customer Profile.
Se il set di dati è abilitato per Real-Time Customer Profile, durante questo passaggio puoi attivare/disattivare il set di dati profilo per abilitare i dati per l'acquisizione del profilo. È inoltre possibile utilizzare questo passaggio per abilitare Diagnostica errori e Acquisizione parziale.
- Diagnostica errori: selezionare Diagnostica errori per indicare all'origine di produrre diagnostica errori a cui fare successivamente riferimento durante il monitoraggio dell'attività del set di dati e dello stato del flusso di dati.
- Acquisizione parziale: l'acquisizione parziale in batch consente di acquisire dati contenenti errori, fino a una determinata soglia configurabile. Questa funzione consente di acquisire correttamente in Experience Platform tutti i dati accurati, mentre tutti i dati errati vengono raggruppati separatamente con informazioni sul motivo della validità.
Dettagli del flusso di dati dataflow-details
Una volta configurato il set di dati, devi quindi fornire dettagli sul flusso di dati, tra cui un nome, una descrizione facoltativa e le configurazioni degli avvisi.
Experience Platform può generare avvisi basati su eventi a cui gli utenti possono abbonarsi. Tutte queste opzioni richiedono un flusso di dati in esecuzione per attivarle. Per ulteriori informazioni, leggere la panoramica degli avvisi
- Inizio esecuzione flusso di dati origini: selezionare questo avviso per ricevere una notifica all'inizio dell'esecuzione del flusso di dati.
- Esecuzione del flusso di dati origini completata: selezionare questo avviso per ricevere una notifica se il flusso di dati termina senza errori.
- Errore di esecuzione del flusso di dati di origini: selezionare questo avviso per ricevere una notifica se l'esecuzione del flusso di dati termina con errori.
Al termine, selezionare Avanti per continuare.
Mappare i campi su uno schema XDM mapping
Viene visualizzato il passaggio Mapping. Utilizza l’interfaccia di mappatura per mappare i dati di origine sui campi dello schema appropriati prima di acquisire tali dati in Experience Platform. Per una guida dettagliata sull'utilizzo dell'interfaccia di mappatura, leggere la Guida dell'interfaccia utente della preparazione dati per ulteriori informazioni.
Configurare la pianificazione dell’acquisizione scheduling
Quindi, utilizza l’interfaccia di pianificazione per creare una pianificazione di acquisizione per il flusso di dati.
Seleziona il menu a discesa della frequenza per configurare la frequenza di acquisizione del flusso di dati.
Puoi anche selezionare l’icona del calendario e utilizzare un calendario a comparsa per configurare l’ora di inizio dell’acquisizione.
Configura la frequenza per indicare la frequenza con cui deve essere eseguito il flusso di dati. Puoi impostare la frequenza su:
- Una volta: imposta la frequenza su
onceper creare un'acquisizione unica. Le configurazioni di intervallo e backfill non sono disponibili quando crei un flusso di dati di acquisizione una tantum. Per impostazione predefinita, la frequenza di pianificazione è impostata su una volta. - Minuti: imposta la frequenza su
minuteper pianificare il flusso di dati in modo da acquisire i dati al minuto. - Ora: imposta la frequenza su
hourper pianificare il flusso di dati per acquisire i dati su base oraria. - Giorno: imposta la frequenza su
dayper pianificare il flusso di dati in modo da acquisire i dati su base giornaliera. - Settimana: imposta la frequenza su
weekper pianificare il flusso di dati in modo da acquisire i dati su base settimanale.
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:
- Una volta: n/d
- Minuto: 15
- Ora: 1
- Giorno: 1
- Settimana: 1
Dopo aver configurato la pianificazione dell'acquisizione del flusso di dati, seleziona Avanti.
Verifica il flusso di dati
Il passaggio finale nel processo di creazione del flusso di dati consiste nell’esaminare il flusso di dati prima di eseguirlo. Utilizza il passaggio Rivedi per rivedere i dettagli del nuovo flusso di dati prima che venga eseguito. 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 i campi: mostra in quale set di dati vengono acquisiti i dati di origine, incluso lo schema a cui il set di dati aderisce.
- Pianificazione: mostra il periodo, la frequenza e l'intervallo attivi 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 i dati dei pagamenti dall'origine Stripe all'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.
Eliminare il flusso di dati
È possibile eliminare i flussi di dati non più necessari o creati in modo errato utilizzando la funzione Elimina disponibile nell'area di lavoro Flussi di dati. Per ulteriori informazioni su come eliminare i flussi di dati, consulta l'esercitazione su eliminazione dei flussi di dati nell'interfaccia utente.