[Beta]{class="badge informative"}
Creare un Customer.io connessione sorgente e flusso di dati nell’interfaccia utente
Questo tutorial descrive i passaggi necessari per creare Customer.io connessione sorgente e flusso di dati tramite l’interfaccia utente di Adobe Experience Platform.
Introduzione getting-started
Questo tutorial richiede una buona conoscenza dei seguenti componenti di Experience Platform:
-
Experience Data Model (XDM) Sistema: il quadro standardizzato mediante il quale Experience Platform organizza i dati sull’esperienza del cliente.
- Nozioni di base sulla composizione dello schema: scopri gli elementi di base degli schemi XDM, compresi 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 schema.
-
Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
Prerequisiti prerequisites
La sezione seguente fornisce informazioni sui prerequisiti da completare prima di poter creare un Customer.io connessione sorgente.
JSON di esempio per definire lo schema di origine per Customer.io prerequisites-json-schema
Prima di creare un Customer.io connessione di origine, sarà necessario specificare uno schema di origine. Puoi utilizzare il codice JSON seguente.
{
"event_id": "01E4C4CT6YDC7Y5M7FE1GWWPQJ",
"object_type": "customer",
"metric": "subscribed",
"timestamp": 1613063089,
"data": {
"customer_id": "42",
"email_address": "test@example.com",
"identifiers": {
"id": "42",
"email": "test@example.com",
"cio_id": "d9c106000001"
}
}
}
Creare uno schema di Platform per Customer.io create-platform-schema
Devi anche assicurarti di creare uno schema Platform da utilizzare per la tua origine. Guarda il tutorial su creazione di uno schema di Platform per passaggi completi sulla creazione di uno schema.
Connetti Customer.io account connect-account
Nell’interfaccia utente di Platform, seleziona Sorgenti dalla barra di navigazione a sinistra per accedere al Sorgenti e visualizzare un catalogo delle origini disponibili in Experienci Platform.
Utilizza il Categorie per filtrare le sorgenti per categoria. In alternativa, immettere un nome di origine nella barra di ricerca per trovare un'origine specifica dal catalogo.
Vai a Automazione del marketing categoria per visualizzare Customer.io scheda sorgente. Per iniziare, seleziona Aggiungi dati.
Selezionare i dati select-data
Il Seleziona dati viene visualizzata un’interfaccia che consente di selezionare i dati da inserire in Platform.
- La parte sinistra dell’interfaccia è un browser che ti consente di visualizzare i flussi di dati disponibili all’interno del tuo account;
- La parte destra dell’interfaccia consente di visualizzare in anteprima fino a 100 righe di dati da un file JSON.
Seleziona Carica file per caricare un file JSON dal sistema locale. In alternativa, puoi trascinare e rilasciare il file JSON da caricare nella Trascinare i file pannello.
Una volta caricato il file, l’interfaccia di anteprima si aggiorna e mostra un’anteprima dello schema caricato. L’interfaccia di anteprima consente di esaminare il contenuto e la struttura di un file. È inoltre possibile utilizzare Campo di ricerca per accedere a elementi specifici dallo schema.
Al termine, seleziona Successivo.
Dettaglio del flusso di dati dataflow-detail
Il Dettagli del flusso di dati Questo passaggio ti fornisce le opzioni per utilizzare un set di dati esistente o stabilirne uno nuovo per il flusso di dati, nonché l’opportunità di fornire un nome e una descrizione per il flusso di dati. Durante questo passaggio, puoi anche configurare le impostazioni per l’acquisizione del profilo, la diagnostica degli errori, l’acquisizione parziale e gli avvisi.
Al termine, seleziona Successivo.
Mappatura mapping
Il Mappatura viene visualizzato un passaggio che fornisce un’interfaccia per mappare i campi sorgente dallo schema sorgente ai campi XDM di destinazione appropriati nello schema di destinazione.
Platform fornisce consigli intelligenti per campi mappati automaticamente in base allo schema o al set di dati di destinazione selezionato. Puoi regolare manualmente le regole di mappatura in base ai tuoi casi d’uso. In base alle tue esigenze, puoi scegliere di mappare i campi direttamente o utilizzare le funzioni di preparazione dati per trasformare i dati sorgente in modo da derivare valori calcolati o calcolati. Per i passaggi completi sull’utilizzo dell’interfaccia mapper e dei campi calcolati, vedi la Guida dell’interfaccia utente per la preparazione dati.
Tutte le mappature elencate di seguito sono obbligatorie e devono essere configurate prima di procedere alla Revisione fase.
object_typeidemailevent_idcio_idmetrictimestampcio_id durante l'esecuzione Customer.io webhook in test mode poiché non vi saranno campi associati inviati da Customer.io.Una volta mappati correttamente i dati di origine, seleziona Successivo.
Revisione review
Il Revisione viene visualizzato un passaggio che consente di rivedere il nuovo flusso di dati prima di crearlo. I dettagli sono raggruppati nelle seguenti categorie:
- Connessione: mostra il tipo di origine, il percorso pertinente del file di origine scelto e la quantità 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 aderisce il set di dati.
Dopo aver rivisto il flusso di dati, seleziona Fine e lascia un po’ di tempo per creare il flusso di dati.
Ottieni l’URL dell’endpoint di streaming get-streaming-endpoint
Una volta creato il flusso di dati di streaming, ora puoi recuperare l’URL dell’endpoint di streaming. Questo endpoint verrà utilizzato per abbonarsi al webhook, consentendo alla tua origine di streaming di comunicare con Experienci Platform.
Per creare l’URL utilizzato per configurare il webhook su Customer.io è necessario recuperare quanto segue:
- ID flusso di dati
- Endpoint di streaming
Per recuperare ID flusso di dati e Endpoint di streaming, passare alla Attività flusso di dati pagina del flusso di dati appena creato e copia i dettagli dalla parte inferiore della sezione Proprietà pannello.
Dopo aver recuperato l’endpoint di streaming e l’ID del flusso di dati, crea un URL in base al seguente pattern: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}. Ad esempio, un URL del webhook costruito potrebbe avere l’aspetto di: https://dcs.adobedc.net/collection/febc116d22ba0ea2868e9c93b199375302afb8a589617700991bb8f3f0341ad7?x-adobe-flow-id=439b3fc4-3042-4a3a-b5e0-a494898d3fb0
Configurare il webhook di reporting in Customer.io set-up-webhook
Dopo aver creato l’URL del webhook, ora puoi impostare il webhook di reporting utilizzando Customer.io dell'utente. Per i passaggi sulla configurazione dei webhook di reporting, leggi Customer.io guida sulla configurazione dei webhook.
In Customer.io interfaccia utente, immettere URL webhook nel WEBHOOK ENDPOINT campo.
Passaggi successivi next-steps
Seguendo questa esercitazione hai configurato correttamente un flusso di dati in streaming per portare Customer.io dati di Experience Platform. Per monitorare i dati che vengono acquisiti, consulta la guida su monitoraggio dei flussi di dati in streaming tramite l’interfaccia utente di Platform.
Risorse aggiuntive additional-resources
Le sezioni seguenti forniscono ulteriori risorse a cui puoi fare riferimento quando utilizzi il Customer.io sorgente.
Guardrail guardrails
Per informazioni sui guardrail, fare riferimento al Customer.io pagina timeout ed errori.
Convalida validation
Per verificare di aver impostato correttamente l’origine e Customer.io I messaggi vengono acquisiti, effettua le seguenti operazioni:
- Puoi controllare la Customer.io Registri attività per identificare gli eventi acquisiti da Customer.io.
- Nell’interfaccia utente di Platform, seleziona Visualizza flussi di dati accanto al Customer.io nel catalogo sorgenti. Quindi, seleziona Anteprima set di dati per verificare i dati acquisiti per gli eventi selezionati in Customer.io.
