Beta

Skapa en Chatlio källanslutning i användargränssnittet

NOTE
The Chatlio 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 Chatlio källanslutning med Adobe Experience Platform användargränssnitt.

Komma igång getting-started

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

Förutsättningar prerequisites

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

Exempel-JSON för att definiera källschemat för Chatlio prerequisites-json-schema

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

{
  "visitor": {
    "email": "test@example.com",
    "UUID": "2d3f4260-2235-903b-0a82-a23d326cc257"
  },
   "message": "Hi",
  "channelId": "C04J7M7LCMQ",
  "slackChannelName": "aep",
  "slackChannelId": "C04JVR71WKS"
}

Skapa ett plattformsschema för Chatlio create-platform-schema

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

Plattformsgränssnittet visar ett exempelschema för Chatlio

Koppla samman Chatlio konto connect-account

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 Chatlio källkort. Börja genom att välja Add data.

Plattformens gränssnittskatalog med Chatlio-kortet

Markera data select-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 dataflow-detail

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 mapping

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.

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

Målfält
Beskrivning
UUID
The Chatlio identifierare för händelsen.

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

Mappningssteget för källarbetsflödet.

Granska review

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 get-streaming-endpoint-url

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å Chatlio 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/d56b47ee3985104beaf724efcd78a3e1a863d720471a482bebac0acc1ab95983

Konfigurera webkrok i Chatlio set-up-webhook

När webkrok-URL:en har skapats kan du nu konfigurera din webkrok med Chatlio användargränssnitt.

Logga in på Chatlio konto och följ guiden för installation för att skapa en widget.

När en widget har skapats navigerar du till inställningssidan för widgeten för att lägga till din webkros-URL i den widgeten.

Webbkrokinställningssidan på Chatlio.

Nästa steg är att välja Behavior och lägga till din webkrok-URL i Webhook when a new conversation starts fält och andra webbhothändelsefält som du vill prenumerera på.

Chatlio-gränssnittet visar webbkrokens slutpunktsfält.

TIP
Du kan prenumerera på olika evenemang för Chatlio webbkrok. Mer information om de olika händelserna finns i Chatlio dokumentation för händelser.

Nästa steg next-steps

Genom att följa den här självstudiekursen har du konfigurerat ett dataflöde för direktuppspelning för att Chatlio 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 additional-resources

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

Validering validation

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

  • Du kan kontrollera Chatlio Reports > Chat History för att identifiera de händelser som spelas in av Chatlio.

Chatlio UI, skärmbild som visar chatthistorik

  • Välj View Dataflows bredvid Chatlio kortmenyn i källkatalogen. Nästa, välj Preview dataset för att verifiera de data som har importerats för de webbböcker som du har konfigurerat i Chatlio.

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

Ytterligare information om Chatlio, går till Chatlio dokumentation och Vanliga frågor.

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