[Beta]{class="badge informative"}

Crea una connessione di origine Customer.io e un flusso di dati nell'interfaccia utente

NOTE
L'origine Customer.io è in versione beta. Per ulteriori informazioni sull'utilizzo di origini con etichetta beta, leggere la panoramica delle origini.

Questo tutorial illustra i passaggi per la creazione di una connessione di origine Customer.io e di un 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:

Prerequisiti prerequisites

Nella sezione seguente vengono fornite informazioni sui prerequisiti da completare prima di creare una connessione di origine Customer.io.

JSON di esempio per definire lo schema di origine per Customer.io prerequisites-json-schema

Prima di creare una connessione di origine Customer.io, è 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"
    }
  }
}

Crea uno schema di Platform per Customer.io create-platform-schema

Devi anche assicurarti di creare uno schema Platform da utilizzare per la tua origine. Consulta il tutorial su creazione di uno schema di Platform per i passaggi completi sulla creazione di uno schema.

Schermata dellinterfaccia utente di Platform che mostra un esempio di schema per Customer.io

Connetti il tuo account Customer.io connect-account

Nell'interfaccia utente di Platform, seleziona Origini dal menu di navigazione a sinistra per accedere all'area di lavoro Origini e visualizzare un catalogo delle origini disponibili in Experience Platform.

Utilizza il menu Categorie per filtrare le origini per categoria. In alternativa, immettere un nome di origine nella barra di ricerca per trovare un'origine specifica dal catalogo.

Vai alla categoria Automazione marketing per visualizzare la scheda di origine Customer.io. Per iniziare, selezionare Aggiungi dati.

Schermata dellinterfaccia utente di Platform per il catalogo con scheda Customer.io

Selezionare i dati select-data

Viene visualizzato il passaggio Seleziona dati, che fornisce un'interfaccia per la selezione dei 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 nel pannello Trascina i file.

Passaggio Aggiungi dati del flusso di lavoro origini.

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 l'utilità Cerca campo per accedere a elementi specifici dallo schema.

Al termine, selezionare Avanti.

Passaggio di anteprima del flusso di lavoro origini.

Dettaglio del flusso di dati dataflow-detail

Viene visualizzato il passaggio Dettagli flusso di dati che 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, selezionare Avanti.

Passaggio del flusso di dati dei dettagli del flusso di lavoro delle origini.

Mappatura mapping

Viene visualizzato il passaggio Mappatura 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, consulta la guida dell'interfaccia utente della preparazione dati.

Tutte le mappature elencate di seguito sono obbligatorie e devono essere configurate prima di procedere alla fase Revisione.

Campo di destinazione
Descrizione
object_type
Il tipo di oggetto, fare riferimento alla documentazione Customer.io events per i tipi supportati.
id
Identificatore dell'oggetto.
email
Indirizzo e-mail associato all’oggetto.
event_id
L’identificatore univoco dell’evento.
cio_id
Identificatore Customer.io dell'evento.
metric
Il tipo di evento. Per ulteriori informazioni, consulta la documentazione Customer.io events per i tipi supportati.
timestamp
La marca temporale in cui si è verificato l’evento.
IMPORTANT
Non mappare cio_id durante l'esecuzione del webhook Customer.io in test mode, in quanto non vi saranno campi associati inviati da Customer.io.

Una volta mappati correttamente i dati di origine, seleziona Avanti.

Passaggio di mappatura del flusso di lavoro di origine.

Controlla review

Viene visualizzato il passaggio Rivedi, che consente di rivedere il nuovo flusso di dati prima che venga creato. 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 i campi: mostra in quale set di dati vengono acquisiti i dati di origine, incluso lo schema a cui il set di dati aderisce.

Dopo aver rivisto il flusso di dati, seleziona Fine e attendi che venga creato un po' di tempo.

Passaggio di revisione del flusso di lavoro origini.

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 Experience Platform.

Per creare l'URL utilizzato per configurare il webhook in Customer.io, è necessario recuperare quanto segue:

  • ID flusso di dati
  • Endpoint di streaming

Per recuperare l'ID flusso di dati e l'endpoint di streaming, vai alla pagina Attività flusso di dati del flusso di dati appena creato e copia i dettagli dalla parte inferiore del pannello Proprietà.

Endpoint di streaming nellattività del flusso di dati.

Dopo aver recuperato l'endpoint di streaming e l'ID del flusso di dati, generare 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 seguente: 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, è possibile configurare il webhook di reporting utilizzando l'interfaccia utente Customer.io. Per i passaggi sulla configurazione dei webhook di reporting, leggi la Customer.io guida sulla configurazione dei webhook.

Nell'interfaccia utente di Customer.io, immettere l'URL webhook nel campo WEBHOOK ENDPOINT.

Interfaccia utente Customer.io con il campo dellendpoint webhook

TIP
Puoi abbonarti a diversi eventi per il tuo webhook di reporting. Ogni messaggio di evento verrà acquisito in Platform quando viene soddisfatto il criterio di attivazione di un evento di azione Customer.io. Per ulteriori informazioni sui diversi eventi, consulta la Customer.io documentazione eventi.

Passaggi successivi next-steps

Seguendo questa esercitazione hai configurato correttamente un flusso di dati in streaming per portare i tuoi dati di Customer.io all'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 fare riferimento quando si utilizza l'origine Customer.io.

Guardrail guardrails

Per informazioni sui guardrail, fare riferimento alla Customer.io pagina timeout ed errori.

Convalida validation

Per verificare la corretta configurazione dell'origine e l'acquisizione di Customer.io messaggi, effettua le seguenti operazioni:

  • È possibile controllare la pagina Customer.io Registri attività per identificare gli eventi acquisiti da Customer.io.

Schermata dellinterfaccia utente di Customer.io con i registri attività

  • Nell'interfaccia utente di Platform, selezionare Visualizza flussi di dati accanto al menu della scheda Customer.io nel catalogo delle origini. Selezionare Anteprima set di dati per verificare i dati acquisiti per gli eventi selezionati in Customer.io.

Schermata dellinterfaccia utente di Platform che mostra gli eventi acquisiti

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089