Lär dig hur du konfigurerar en sandlådemiljö i Experience Platform med exempeldata. Med en postman-samling kan du skapa fältgrupper, scheman, datauppsättningar och sedan importera exempeldata till Experience Platform.
Experience Platform-användare måste ofta gå igenom en serie steg som omfattar att identifiera fältgrupper, skapa scheman, förbereda data, skapa datauppsättningar och sedan importera data innan de kan utforska några av de funktioner som erbjuds av Experience Platform. I den här självstudiekursen hittar du ett enkelt sätt att automatisera några av stegen och hämta data i Platform så snart som möjligt.
Den här självstudiekursen fokuserar på ett fiktivt varumärke som kallas Luma. Luma driver tegelhus i flera länder och har en onlinenärvaro med en webbplats och mobilappar. De investerar i Adobe Experience Platform för att kombinera kundlojalitet, CRM, webb och offlineköp i kundprofiler i realtid och aktivera profilerna för att ta marknadsföringen till nästa nivå. Vi har genererat exempeldata för Luma, och i nästa avsnitt kan du utforska hur du importerar data till Experience Platform.
Du kan använda Användargränssnittet för Postman-programmet eller använda kommandoraden Collection Runner for Postman (Newman)
techmarketingdemos
" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
. Du kan också få den genom att skapa en autentiserad API-begäran.Kontrollera att du har hämtat Postman och har tillgång till Experience Platform API:er. I den här självstudiekursen kommer vi att använda en sandlådemiljö. Den utgör en isolerad miljö där du kan testa funktioner utan att blanda resurser och data med produktionsmiljön. Kom så sätter vi igång.
Användardata i platform-utils-main.zip filen är fiktiv och ska endast användas som exempel.
Ladda ned platform-utils-main.zip som innehåller alla filer som behövs för kursen.
Flytta platform-utils-main.zip
till önskad plats på datorn och packa upp den.
Notera platsen för den uppzippade filen, eftersom vi kan behöva den senare när vi konfigurerar FILE_PATH
variabel för postmansmiljö
Om du vill hämta filsökvägen på din Mac går du till platform-utils-main
mapp, högerklicka på mappen och välj Visa info alternativ.
Om du vill ha en filsökväg i dina fönster öppnar du platsen för den önskade mappen genom att klicka på dem och högerklickar sedan till höger om sökvägen i adressfältet. Kopiera adress för att hämta filsökvägen.
Starta Postman och skapa en ny arbetsyta. Kopiera where
metadatavärde från
Om du vill skapa en ny arbetsyta använder du Arbetsytor nedrullningsbar meny till vänster om Postman. Du kan välja en befintlig arbetsyta eller skapa en ny arbetsyta för projektet.
Ange Namn och valfria Sammanfattning för arbetsytan och klicka Skapa arbetsyta. Postman växlar till den nya arbetsytan när man skapar den.
Nu ska vi göra några ytterligare inställningar för att köra våra postmankollektioner på den här arbetsytan. Klicka på skiftnyckelsikonen i Postmans huvud och välj Inställningar för att öppna inställningarna spärrade. Du kan också använda kortkommandot (CMD/CTRL + ,) för att öppna modala bilder.
Under General
-fliken, vi uppdaterar timeout för begäran i ms till 5000 ms
och aktivera allow reading file outside this directory
Om filer läses in från en arbetskatalog kommer de att köras smidigt på olika enheter om samma filer lagras på andra enheter. Om du vill köra filer från en annan arbetskatalog måste en inställning aktiveras för att ange samma metod. Om FILE_PATH
är inte samma som postmannens arbetskatalogsökväg. Det här alternativet bör aktiveras.
Stäng inställningspanelen.
Välj miljöalternativet och klicka på importalternativet.
Vi importerar den hämtade JSON-miljöfilen, DataInExperiencePlatform.postman_environment
och klicka Importera
I Postman väljer du miljö i den övre högra listrutan och klickar på ögonikonen för att visa miljövariablerna.
Kontrollera att följande miljövariabler är ifyllda. Om du vill veta hur du hämtar miljövariabelns värde kan du titta i Autentisera till Experience Platform API:er självstudiekurs för steg-för-steg-instruktioner.
CLIENT_SECRET
API_KEY
TECHNICAL_ACCOUNT_ID
META_SCOPE
IMS
IMS_ORG
PRIVATE_KEY
SANDBOX_NAME
CONTAINER_ID
TENANT_ID
platform_end_point
FILE_PATH
PRIVATE_KEY
Uppdatera FILE_PATH
variabeln till den lokala mappsökvägen där du har packat upp platform-utils-main.zip
-fil. Du kan redigera variabler antingen genom att öppna en miljö från miljöer till vänster, eller genom att öppna den snabba miljölooken (ögonknappen) längst upp till höger i Postman och klicka på Redigera.
Nu måste vi fylla i värdena för följande miljövariabler. För att göra det måste vi överföra samlingsfilerna till arbetsytan.
JWT_TOKEN
ACCESS_TOKEN
Markera samlingar och välj sedan importalternativet
Importera följande samlingsfiler till postman
Authentication.postman_collection.json
Luma-Loyalty-Data.postman_collection.json
Luma-CRM-Data.postman_collection.json
Luma-Product-Catalog.postman_collection.json
Luma-Offline-Purchase-Events.postman_collection.json
Öppna Authentication
samling, välj IMS: JWT Generate + Auth via User Token
begär POST och klickar på SEND
för att autentisera och hämta åtkomsttoken.
Granska miljövariablerna och lägg märke till att JWT_TOKEN
och ACCESS_TOKEN
är nu ifyllda.
I luma-data
mapp, öppna alla json
filer i en textredigerare och ersätta alla förekomster av _techmarketingdemos
med ditt eget klient-ID, föregånget av ett understreck.
Öppna Luma-Loyalty-Data
samling och klicka Kör på översiktsfliken för att starta en Collection Runner.
I samlingskörningsfönstret ska du se till att välja miljö i listrutan, ange en fördröjning på 4 000 ms, kontrollera alternativet Spara svar och se till att körningsordningen är korrekt. Klicka på Kör Luma-lojalitetsdata knapp
Luma-Loyalty-data samlingskörning skulle skapa ett schema som innehåller kundlojalitetsdata. Schemat baseras på klassen XDM Individual Profile som omfattar anpassade fältgrupper och datatyper. Samlingen skapar också en datauppsättning med hjälp av schemat och överför exempelkundlojalitetsdata till Adobe Experience Platform.
Om någon samlingsbegäran misslyckas under postmansamlingen avbryter du körningen och kör samlingsförfrågningarna en i taget.
Om allt går bra, finns alla förfrågningar i Luma-Loyalty-Data
-samlingen ska passera.
Nu ska vi logga in på Adobe Experience Platform UI och navigera till datauppsättningar.
Öppna Luma Loyalty Dataset
datauppsättning, och under aktivitetsfönstret för datauppsättningen, kan du visa en lyckad batchkörning som importerade 1 000 poster. Du kan också klicka på alternativet för förhandsgranskning av datauppsättning för att verifiera de poster som har importerats.
Upprepa steg 21-23 för att köra nedanstående samlingar:
Luma-CRM-Data.postman_collection.json
: samlingskörningen skulle skapa ett schema som innehåller CRM-data för kunder. Schemat är baserat på klassen XDM Individual Profile som omfattar fältgrupper med demografisk information, personlig kontaktinformation och Luma Identity Profile. Samlingen skapar också en datauppsättning med hjälp av schemat och överför exempelkundens CRM-data till Adobe Experience Platform.Luma-Product-Catalog.postman_collection.json
: samlingskörningen skulle skapa ett schema som innehåller produktkataloginformation. Schemat baseras på en anpassad klass som består av produktkatalogmixning, Commerce-information och Consumer Experience Event-mixin. Samlingen skapar också en datauppsättning med hjälp av schemat och överför produktdata till Adobe Experience Platform.Luma-Offline-Purchase-Events.postman_collection.json
: samlingskörning skulle skapa ett schema som innehåller offlineköpshändelsedata för kunder. Schemat baseras på klassen XDM ExperienceEvent och omfattar fältgrupper för att samla kundlojalitetsinformation och deras offlineköp. Samlingen skapar också en datauppsättning med hjälp av schemat och överför offlineinköpshändelsedata till Adobe Experience Platform.Innan du följer stegen måste du se till att du har tillgång till Experience Platform API:er. I den här självstudiekursen kommer vi att använda en sandlådemiljö eftersom den utgör en isolerad miljö där du kan testa funktioner utan att blanda resurser och data med produktionsmiljön.
Kontrollera att du har Node.js >= v10 för att köra Newman. Installera Node.js via pakethanteraren.
Kör kommandot node -v
för att se till att noden är installerad.
Det enklaste sättet att installera Newman är att använda NPM. Om du har installerat Node.js är det troligtvis även du har installerat NPM.
Följ stegen här för att installera nybörjare för ditt system
Kör kommandot newman -v
för att säkerställa att nybörjaren är installerad.
Ladda ned platform-utils-main.zip som innehåller alla filer som behövs för kursen.
Flytta platform-utils-main.zip
till önskad plats på datorn och packa upp den.
Notera platsen för den uppzippade filen, eftersom vi kan behöva den senare när vi konfigurerar FILE_PATH
variabel för postmansmiljö
Öppna platform-utils-main
i ett terminalfönster.
Kör Luma-Loyalty-Data.postman_collection.json
för att skapa fältgrupper, schema, datauppsättning och för att importera exempellojalitetsdata till Adobe Experience Platform
newman run Luma-Loyalty-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json —insecure --delay-request 4000
Om allt går bra, finns alla förfrågningar i Luma-Loyalty-Data
-samlingen ska passera.
Nu ska vi logga in på Adobe Experience Platform UI och navigera till datauppsättningar.
Öppna Luma Loyalty Dataset
datauppsättning, och under aktivitetsfönstret för datauppsättningen, kan du visa en lyckad batchkörning som importerade 1 000 poster. Du kan också klicka på alternativet för förhandsgranskning av datauppsättning för att verifiera de poster som har importerats.
Upprepa steg 10-13 för att köra under samlingar:
Luma-CRM-Data.postman_collection.json
för att skapa fältgrupper, schema, datauppsättning och för att importera CRM-exempeldata till Adobe Experience Platform
newman run Luma-CRM-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
Luma-Product-Catalog.postman_collection.json
för att skapa fältgrupper, schema, datauppsättning och för att importera exempelproduktdata till Adobe Experience Platform
newman run Luma-Product-Catalog.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
Luma-Offline-Purchase-Events.postman_collection.json
för att skapa fältgrupper, schema, datauppsättning och för att importera exempelproduktdata till Adobe Experience Platform
newman run Luma-Offline-Purchase-Events.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
Om du återställer en icke-produktionssandlåda tas alla resurser som är associerade med den sandlådan (scheman, datauppsättningar o.s.v.) bort, samtidigt som sandlådans namn och associerade behörigheter behålls. Den här"rena" sandlådan är fortfarande tillgänglig under samma namn för användare som har åtkomst till den.
Följ stegen här för att återställa en sandlådemiljö.