Skapa en Pendo källanslutningsdataflöde och i användargränssnittet

Den här självstudiekursen innehåller steg för att skapa en Pendo källanslutning och dataflöde 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 Pendo källanslutning.

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

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

{
  "accountId": "58f79ee324d3f",
  "timestamp": 1673372516,
  "visitorId": "test@test.com",
  "uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
  "properties": {
    "guideProperties": {
  "name": "Guide Conversion Test"
  }
}
}

Mer information finns i Pendo guide på webhooks.

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

Du måste också se till att du först 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.

Koppla samman Pendo 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 Analytics för att se Pendo källkort. Börja genom att välja Add data.

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.

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.

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.

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.

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.

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

Granska review

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

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

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å Pendo du måste hämta följande:

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.

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/0c61859cc71939a0caf01123f91b2fc52589018800ad46b6c76c2dff3595ee95

Konfigurera webkrok i Pendo set-up-webhook

Logga sedan in på ditt konto på Pendo och skapa en webkrok. För steg om hur du skapar en webkrok med Pendo användargränssnittet, se Pendo guide om att skapa webkrok.

Navigera till inställningssidan för Pendo webkrok och ange din webkroks-URL i URL fält.

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 Pendo 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 Pendo källa.

Validering validation

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

Fel och felsökning errors-and-troubleshooting

När du kontrollerar ett dataflöde kan följande felmeddelande visas: The message can't be validated ... uniqueID:expected minLength:1, actual 0].

Du måste verifiera att uniqueID mappningen har konfigurerats. Mer information finns i Mmpping -avsnitt.

Mer information finns på Pendo Help Center.