Skapa en HTTP API direktuppspelningsanslutning med användargränssnittet
I den här självstudien beskrivs hur du skapar en direktuppspelad källanslutning med arbetsytan Sources.
Komma igång
Den här självstudiekursen kräver en fungerande förståelse av följande komponenter i Adobe Experience Platform:
-
Experience Data Model (XDM) System: Det standardiserade ramverk som Experience Platform organiserar kundupplevelsedata med.
- Grundläggande om schemakomposition: Lär dig mer om grundstenarna i XDM-scheman, inklusive nyckelprinciper och bästa metoder för schemakomposition.
- Schemaredigeraren, självstudiekurs: Lär dig hur du skapar anpassade scheman med hjälp av gränssnittet för Schemaredigeraren.
-
Real-Time Customer Profile: Tillhandahåller en enhetlig konsumentprofil i realtid baserad på aggregerade data från flera källor.
Skapa en direktuppspelningsanslutning
I plattformsgränssnittet väljer du Sources i den vänstra navigeringen för att komma åt arbetsytan i Sources. På skärmen Catalog visas en mängd olika källor som du kan skapa ett konto med.
Du kan välja lämplig kategori i katalogen till vänster på skärmen. Du kan också hitta den källa du vill arbeta med med med sökalternativet.
Under kategorin Streaming väljer du HTTP API och sedan Add data.
Sidan Connect HTTP API account visas. På den här sidan kan du antingen använda nya autentiseringsuppgifter eller befintliga.
Befintligt konto
Om du vill använda ett befintligt konto väljer du det HTTP API-konto som du vill skapa ett nytt dataflöde med och väljer sedan Next för att fortsätta.
Nytt konto
Om du skapar ett nytt konto väljer du New account. Ange ett kontonamn och en valfri beskrivning på indataformuläret som visas. Du får också möjlighet att ange följande konfigurationsegenskaper:
- Authentication: Den här egenskapen avgör om direktuppspelningsanslutningen kräver autentisering eller inte. Autentisering säkerställer att data samlas in från betrodda källor. Om du har att göra med personligt identifierbar information (PII) ska den här egenskapen aktiveras. Som standard är den här egenskapen inaktiverad.
- XDM compatible: Den här egenskapen anger om den här direktuppspelningsanslutningen kommer att skicka händelser som är kompatibla med XDM-scheman. Som standard är den här egenskapen inaktiverad.
När du är klar väljer du Connect to source och sedan Next för att fortsätta.
Markera data
När du har skapat HTTP API-anslutningen visas steget Select data, som ger dig ett gränssnitt för att överföra och förhandsgranska dina data.
Välj Upload files om du vill överföra dina data. Du kan också dra och släppa data i Drag and drop files-delen av gränssnittet.
När dina data har överförts kan du använda den högra sidan av gränssnittet för att förhandsgranska din filhierarki. Välj Next om du vill fortsätta.
Mappa datafält till ett XDM-schema
Steg Mapping visas med ett gränssnitt för att mappa källdata till en plattformsdatauppsättning.
Källan HTTP API stöder inmatning av JSON-filer. JSON-filer behöver inte konfigureras manuellt om de är markerade som XDM-kompatibla. Om inte, måste du konfigurera mappningen explicit.
Välj en datauppsättning för inkommande data som ska importeras till. Du kan antingen använda en befintlig datauppsättning eller skapa en ny.
Skapa en ny datauppsättning
Om du vill skapa en ny datauppsättning väljer du New dataset. På formuläret som visas anger du namn, valfri beskrivning och målschema för datauppsättningen. Om du väljer ett Profile-aktiverat schema kan du välja om datauppsättningen också ska vara Profile-aktiverad.
Använd en befintlig datamängd
Om du vill använda en befintlig datauppsättning väljer du Existing dataset. Markera den datauppsättning som du vill använda i formuläret som visas. När du har valt en datauppsättning kan du välja om datauppsättningen ska vara Profile-aktiverad.
Mappa standardfält
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änssnittshandboken för dataförinställningar.
Välj Add new mapping om du vill lägga till ett nytt källfält.
Ett nytt källfält och målfältskoppling visas. Om du vill lägga till ett nytt källfält väljer du pilikonen bredvid inmatningsfältet Select source field.
På panelen Select attributes kan du utforska din filhierarki och välja ett specifikt källfält att mappa till ett mål-XDM-fält. När du har valt det källfält som du vill mappa väljer du Select för att fortsätta.
När du har markerat ett källfält kan du nu identifiera rätt mål-XDM-fält att mappa till. Välj schemaikonen under målfältsavsnittet.
Fönstret Map source field to target field visas, och du får ett gränssnitt för att utforska schemat för måldatauppsättningen. Välj det målfält som matchar källfältet och välj sedan Select för att fortsätta.
När alla källfält har mappats till rätt mål-XDM-fält väljer du Next
Dataflödesdetaljer
Dataflow detail-steget visas. På den här sidan kan du ange information för det skapade dataflödet genom att ange ett namn och en valfri beskrivning.
Välj Next när du har angett information för dataflödet.
Granska
Steget Review visas så att du kan granska informationen om dataflödet innan det skapas. Informationen är grupperad i följande kategorier:
- Connection: Visar kontonamnet, källplattformen och källnamnet.
- Assign dataset and map fields: Visar måldatauppsättningen och det schema som datauppsättningen följer.
När du har bekräftat att informationen är korrekt väljer du Finish.
Hämta URL för direktuppspelningsslutpunkt
När anslutningen har skapats visas informationssidan för källor. På den här sidan visas information om din nya anslutning, inklusive tidigare körda dataflöden, ID och URL för direktuppspelningsslutpunkt.
Nästa steg
Genom att följa den här självstudiekursen har du skapat en HTTP-direktuppspelningsanslutning, vilket gör att du kan använda direktuppspelningsslutpunkten för att få tillgång till olika Data Ingestion API:er. Instruktioner om hur du skapar en direktuppspelningsanslutning i API:t finns i skapa en självstudiekurs för direktuppspelningsanslutning.
Om du vill lära dig hur du direktuppspelar data på en plattform kan du läsa självstudiekursen om att strömma tidsseriedata eller självstudiekursen om direktuppspelade postdata.