Il Customer.io sorgente in versione beta. Leggi le panoramica sulle origini per ulteriori informazioni sull’utilizzo di fonti etichettate beta.
Questo tutorial descrive i passaggi necessari per creare Customer.io connessione sorgente e flusso di dati tramite l’interfaccia utente di Adobe Experience Platform.
Questo tutorial richiede una buona conoscenza dei seguenti componenti di Experience Platform:
La sezione seguente fornisce informazioni sui prerequisiti da completare prima di poter creare un Customer.io connessione sorgente.
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"
}
}
}
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.
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.
Il Seleziona dati viene visualizzata un’interfaccia che consente di selezionare i dati da inserire in Platform.
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.
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.
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.
Campo di destinazione | Descrizione |
---|---|
object_type |
Il tipo di oggetto, fare riferimento al Customer.io Eventi documentazione per i tipi supportati. |
id |
Identificatore dell'oggetto. |
email |
Indirizzo e-mail associato all’oggetto. |
event_id |
L’identificatore univoco dell’evento. |
cio_id |
Il Customer.io identificatore dell’evento. |
metric |
Il tipo di evento. Per ulteriori informazioni, consulta Customer.io Eventi documentazione per i tipi supportati. |
timestamp |
La marca temporale in cui si è verificato l’evento. |
Non mappare cio_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.
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:
Dopo aver rivisto il flusso di dati, seleziona Fine e lascia un po’ di tempo per creare il flusso di dati.
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:
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
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.
Puoi abbonarti a diversi eventi per il tuo webhook di reporting. I messaggi di ogni evento verranno acquisiti in Platform quando Customer.io sono soddisfatti i criteri di attivazione dell’evento dell’azione. Per ulteriori informazioni sui diversi eventi, consulta Customer.io documentazione sugli eventi.
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.
Le sezioni seguenti forniscono ulteriori risorse a cui puoi fare riferimento quando utilizzi il Customer.io sorgente.
Per informazioni sui guardrail, fare riferimento al Customer.io pagina timeout ed errori.
Per verificare di aver impostato correttamente l’origine e Customer.io I messaggi vengono acquisiti, effettua le seguenti operazioni: