Beta

Skapa en Customer.io källanslutning och dataflöde i användargränssnittet

OBSERVERA

The Customer.io källan är i betaversion. Läs källöversikt om du vill ha mer information om hur du använder betamärkta källor.

Den här självstudiekursen innehåller steg för att skapa en Customer.io källanslutning och dataflöde med Adobe Experience Platform användargränssnitt.

Komma igång

Den här självstudiekursen kräver en fungerande förståelse av följande komponenter i Experience Platform:

Förutsättningar

Följande avsnitt innehåller information om krav som måste utföras innan du kan skapa en Customer.io källanslutning.

Exempel-JSON för att definiera källschemat för Customer.io

Innan du skapar Customer.io källanslutning, du måste ange ett källschema. Du kan använda JSON nedan.

{
  "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"
    }
  }
}

Skapa ett plattformsschema för Customer.io

Du måste också se till att du skapar ett plattformsschema som kan användas för källan. Se självstudiekursen om skapa ett plattformsschema om du vill ha omfattande anvisningar om hur du skapar ett schema.

Skärmbild av användargränssnittet för plattformen med ett exempelschema för Customer.io

Koppla samman Customer.io konto

Välj Sources från vänster navigering för att komma åt Sources och se en katalog med källor i Experience Platform.

Använd Categories meny för att filtrera källor efter kategori. Du kan också ange ett källnamn i sökfältet för att hitta en viss källa från katalogen.

Gå till Marketing automation för att se Customer.io källkort. Börja genom att välja Add data.

Skärmbild för plattformsgränssnitt för katalog med Customer.io-kortet

Markera data

The Select data visas, där du får ett gränssnitt där du kan välja vilka data du vill hämta till plattformen.

  • Den vänstra delen av gränssnittet är en webbläsare som gör att du kan visa tillgängliga dataströmmar på ditt konto;
  • Med den högra delen av gränssnittet kan du förhandsgranska upp till 100 rader data från en JSON-fil.

Välj Upload files för att överföra en JSON-fil från ditt lokala system. Du kan också dra och släppa den JSON-fil som du vill överföra till Drag and drop files -panelen.

Steget Lägg till data i källarbetsflödet.

När filen har överförts uppdateras förhandsvisningsgränssnittet för att visa en förhandsgranskning av schemat som du har överfört. I förhandsvisningsgränssnittet kan du inspektera innehållet och strukturen i en fil. Du kan också använda Search field för att komma åt specifika objekt inifrån schemat.

När du är klar väljer du Next.

Förhandsgranskningssteget för källarbetsflödet.

Dataflödesdetaljer

The Dataflödesdetaljer visas. Här finns alternativ för att använda en befintlig datauppsättning eller skapa en ny datauppsättning för dataflödet samt en möjlighet att ange ett namn och en beskrivning för dataflödet. Under det här steget kan du även konfigurera inställningar för profilinmatning, feldiagnostik, partiell inmatning och aviseringar.

När du är klar väljer du Next.

Dataflödesdetaljsteget i källarbetsflödet.

Mappning

The Mapping visas med ett gränssnitt för att mappa källfälten från källschemat till rätt mål-XDM-fält i målschemat.

Plattformen ger intelligenta rekommendationer för automatiskt mappade fält baserat på det målschema eller den datamängd du valt. Du kan justera mappningsreglerna manuellt så att de passar dina användningsfall. Beroende på dina behov kan du välja att mappa fält direkt eller använda förinställningsfunktioner för data för att omvandla källdata för att härleda beräknade eller beräknade värden. Mer information om hur du använder mappningsgränssnittet och beräkningsfälten finns i Användargränssnittsguide för dataprep.

Alla mappningar som anges nedan är obligatoriska och bör konfigureras innan du fortsätter till Review stage.

Målfält Beskrivning
object_type Objekttypen refererar till Customer.io händelser dokumentation för de typer som stöds.
id Objektets identifierare.
email E-postadressen som är associerad med objektet.
event_id Händelsens unika identifierare.
cio_id The Customer.io identifierare för händelsen.
metric Händelsetypen. Mer information finns i Customer.io händelser dokumentation för de typer som stöds.
timestamp Tidsstämpeln när händelsen inträffade.
VIKTIGT

Mappa inte cio_id vid körning Customer.io webbkrok i test mode eftersom inga associerade fält skickas från Customer.io.

När källdata har mappats väljer du Next.

Mappningssteget för källarbetsflödet.

Granska

The Review visas så att du kan granska det nya dataflödet innan det skapas. Informationen är grupperad i följande kategorier:

  • Connection: Visar källtypen, den relevanta sökvägen till den valda källfilen och mängden kolumner i källfilen.
  • Assign dataset & map fields: Visar vilken datauppsättning källdata hämtas till, inklusive det schema som datauppsättningen följer.

När du har granskat dataflödet väljer du Finish så att dataflödet kan skapas.

Granskningssteget för källarbetsflödet.

Hämta din URL för direktuppspelningsslutpunkt

När du har skapat ett dataflöde för direktuppspelning kan du nu hämta URL:en för din slutpunkt för direktuppspelning. Den här slutpunkten används för att prenumerera på din webkrok, vilket gör att strömningskällan kan kommunicera med Experience Platform.

För att kunna skapa den URL som används för att konfigurera webbhoten på Customer.io du måste hämta följande:

  • Dataflow ID
  • Streaming endpoint

Så här hämtar du Dataflow ID och Streaming endpoint, går till Dataflow activity sidan med dataflödet som du just skapade och kopierar informationen från nederkanten av Properties -panelen.

Slutpunkten för direktuppspelning i dataflödesaktivitet.

När du har hämtat ditt slutpunkts- och dataflödes-ID för direktuppspelning skapar du en URL baserat på följande mönster: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}. En webbkrok-URL kan till exempel se ut så här: https://dcs.adobedc.net/collection/febc116d22ba0ea2868e9c93b199375302afb8a589617700991bb8f3f0341ad7?x-adobe-flow-id=439b3fc4-3042-4a3a-b5e0-a494898d3fb0

Konfigurera webkrok för rapportering i Customer.io

När webkrok-URL:en har skapats kan du nu konfigurera din rapporteringswebkrok med Customer.io användargränssnitt. Anvisningar om hur du konfigurerar webbhooks för rapportering finns i Customer.io stödlinje om hur du konfigurerar webbhooks.

I Customer.io användargränssnitt, ange webkroks-URL i WEBHOOK ENDPOINT fält.

Användargränssnittet Customer.io med slutpunktsfältet för webkrok

TIPS

Du kan prenumerera på en mängd olika händelser för din rapportwebkrok. Varje händelsemeddelande hämtas till Platform när en Customer.io villkor för utlösare av åtgärdshändelser uppfylls. Mer information om de olika händelserna finns i Customer.io dokumentation för händelser.

Nästa steg

Genom att följa den här självstudiekursen har du konfigurerat ett dataflöde för direktuppspelning för att Customer.io data till Experience Platform. Om du vill övervaka de data som importeras läser du i guiden på övervaka strömmande dataflöden med hjälp av plattformsgränssnitt.

Ytterligare resurser

I avsnitten nedan finns ytterligare resurser som du kan använda när du använder Customer.io källa.

Guardrails

Information om skyddsräcken finns i Customer.io sida för timeout och fel.

Validering

För att verifiera att du har konfigurerat källan och Customer.io meddelanden importeras, följ stegen nedan:

  • Du kan kontrollera Customer.io Activity Logs för att identifiera de händelser som spelas in av Customer.io.

Customer.io UI, skärmbild med aktivitetsloggar

  • Välj View Dataflows bredvid Customer.io kortmenyn i källkatalogen. Nästa, välj Preview dataset för att verifiera data som har importerats för händelser som du har valt i Customer.io.

Skärmbild av användargränssnittet för plattformen med inkapslade händelser

På denna sida