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 de marknadsföringsfunktioner som erbjuds av Experience Platform. Den här självstudiekursen automatiserar några av stegen så att du kan hämta data till en plattformssandlåda så snabbt som möjligt.
Den här självstudiekursen fokuserar på ett fiktivt varumärke som kallas Luma. De investerar i Adobe Experience Platform för att kombinera lojalitet, CRM, produktkatalog 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 resten av den här självstudiekursen kommer du att importera dessa data till någon av dina Experience Platform sandlådemiljöer.
Slutresultatet av den här självstudiekursen är en sandlåda som innehåller liknande data som Komma igång med självstudiekursen Adobe Experience Platform for Data Architects and Data Engineers. Den uppdaterades i april 2023 för att stödja Utmaningar inom Journey Optimizer. Den uppdaterades i juni 2023 för att ändra autentiseringsmetoden till OAuth.
techmarketingdemos
" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
.Innan du följer instruktionerna kontrollerar du att du har hämtat Postman program. Kom så börjar vi!
Ladda ned platform-utils-main.zip som innehåller alla filer som behövs för kursen.
Användardata i platform-utils-main.zip filen är fiktiv och ska endast användas för demonstrationssyften.
Flytta platform-utils-main.zip
till önskad plats på datorn och packa upp den.
I luma-data
mapp, öppna alla json
filer i en textredigerare och ersätta alla förekomster av _yourTenantId
med ditt eget klient-ID, föregånget av ett understreck.
Öppna luma-offline-purchases.json
, luma-inventory-events.json
och luma-web-events.json
i en textredigerare och uppdatera alla tidsstämplar så att händelserna inträffar den senaste månaden (t.ex. sök efter "timestamp":"2022-11
och ersätta år och månad)
Observera platsen för den uppzippade mappen, som du behöver den senare när du konfigurerar FILE_PATH
Postman miljövariabel:
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.
Öppna Postman och skapa en arbetsyta från Arbetsytor listrutemeny:
Ange en Namn och valfria Sammanfattning för arbetsytan och klicka Skapa arbetsyta. Postman kommer att växla till den nya arbetsytan när du skapar den.
Justera några inställningar för att köra Postman samlingar på den här arbetsytan. I sidhuvudet på Postman, klicka på kugghjulsikonen och välj Inställningar om du vill öppna inställningarna spärrade. Du kan också använda kortkommandot (CMD/CTRL + ,) för att öppna modala bilder.
Under General
uppdaterar du 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 plats utanför arbetskatalogen måste en inställning aktiveras för att ange samma metod. Om FILE_PATH
är inte detsamma som PostmanI arbetskatalogsökvägen ska det här alternativet aktiveras.
Stäng Inställningar -panelen.
Välj Miljö och sedan Importera:
Importera den hämtade JSON-miljöfilen, DataInExperiencePlatform.postman_environment
I Postman väljer du din 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
—Client ID
i Adobe Developer ConsoleSCOPES
TECHNICAL_ACCOUNT_ID
IMS
IMS_ORG
—Organization ID
i Adobe Developer ConsoleSANDBOX_NAME
TENANT_ID
—se till att leda med ett understreck, till exempel _techmarketingdemos
CONTAINER_ID
platform_end_point
FILE_PATH
—använd den lokala mappsökvägen där du har packat upp platform-utils-main.zip
-fil. Se till att den innehåller mappnamnet, till exempel /Users/dwright/Desktop/platform-utils-main
Spara den uppdaterade miljön
Därefter måste du importera samlingarna till Postman.
Välj Samlingar och välj sedan importalternativet:
Importera följande samlingar:
0-Authentication.postman_collection.json
1-Luma-Loyalty-Data.postman_collection.json
2-Luma-CRM-Data.postman_collection.json
3-Luma-Product-Catalog.postman_collection.json
4-Luma-Offline-Purchase-Events.postman_collection.json
5-Luma-Product-Inventory-Events.postman_collection.json
6-Luma-Test-Profiles.postman_collection.json
7-Luma-Web-Events.postman_collection.json
Därefter måste du autentisera och generera en användartoken. Observera att de tokengenereringsmetoder som används i den här självstudiekursen endast är lämpliga för icke-produktionsbruk. Lokal signering läser in ett JavaScript-bibliotek från en tredjepartsvärd och fjärrsignering skickar den privata nyckeln till en webbtjänst som ägs och drivs av Adobe. Även om Adobe inte lagrar den här privata nyckeln bör produktionsnycklar aldrig delas med någon.
Öppna 0-Authentication
samling, välj OAuth: Request Access Token
begär och klickar på SEND
för att autentisera och hämta åtkomsttoken.
Granska miljövariablerna och lägg märke till att ACCESS_TOKEN
är nu ifyllt.
Nu kan du förbereda och importera data till din plattformssandlåda. De Postman-samlingar du har importerat kommer att göra allt det tunga arbetet!
Öppna 1-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ön i listrutan och uppdatera Fördröjning till 4000ms
, kontrollera Spara svar och se till att körningsordningen är korrekt. Klicka på Kör Luma-lojalitetsdata knapp
1-Luma-Loyalty-data skapar ett schema för kundlojalitetsdata. Schemat baseras på klassen XDM Individual Profile, standardfältgruppen samt en anpassad fältgrupp och datatyp. Samlingen skapar en datauppsättning med hjälp av schemat och överför exempelkundlojalitetsdata till Adobe Experience Platform.
Om en samlingsbegäran misslyckas under Postman-samlingens körningsprogram stoppar du körningen och kör samlingsbegäran 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 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. Du kan behöva vänta flera minuter för att bekräfta att 1000 Nya profilfragment skapades.
Upprepa steg 1-3 för att köra de andra samlingarna:
2-Luma-CRM-Data.postman_collection.json
skapar ett schema och en ifylld datauppsättning för kundens CRM-data. Schemat är baserat på klassen XDM Individual Profile som omfattar Demografisk information, personlig kontaktinformation, inställningsinformation och en anpassad identitetsfältgrupp.3-Luma-Product-Catalog.postman_collection.json
skapar ett schema och en ifylld datauppsättning för produktkataloginformation. Schemat är baserat på en anpassad produktkatalogklass och använder en anpassad produktkatalogfältgrupp.4-Luma-Offline-Purchase-Events.postman_collection.json
skapar ett schema och en ifylld datamängd för kunders offlineköpshändelsedata. Schemat är baserat på XDM ExperienceEvent-klassen och består av en anpassad identitet och fältgrupper för Commerce Details.5-Luma-Product-Inventory-Events.postman_collection.json
skapar ett schema och en ifylld datauppsättning för händelser som rör produkter som kommer in och ut ur lagret. Schemat baseras på en anpassad affärshändelseklass och en anpassad fältgrupp.6-Luma-Test-Profiles.postman_collection.json
skapar ett schema och en ifylld datauppsättning med testprofiler som ska användas i Adobe Journey Optimizer7-Luma-Web-Events.postman_collection.json
skapar ett schema och en ifylld datauppsättning med enkla historiska webbdata.Exempeldata har utformats så att kundprofiler i realtid som kombinerar data från flera system byggs när samlingarna har körts. Ett bra exempel på detta är den första posten i datamängderna för lojalitet, CRM och offlineköp. Slå upp den profilen för att bekräfta att data har importerats. I Adobe Experience Platform:
Luma Loyalty Id
som Namnutrymme för identitet5625458
som IdentitetsvärdeDaniel Wright
profilOm du inte ser profilen kan du kontrollera Datauppsättningar för att bekräfta att alla datauppsättningar har skapats och importerats. Om det ser bra ut kan du vänta i femton minuter och se om profilen är tillgänglig i visningsprogrammet. Om det uppstår problem med dataimporten kontrollerar du felmeddelandena för att försöka hitta problemet. Du kan även försöka aktivera feldiagnostik på Datauppsättningar och dra och släpp JSON-datafilen för att importera data igen.
Genom att bläddra bland data i Attribut och Händelser ser du att profilen innehåller data från de olika datafilerna:
Om du vill veta mer om Adobe Journey Optimizer innehåller den här sandlådan allt du behöver för att ta Utmaningar inom Journey Optimizer
Om du vill veta mer om sammanfogningsprinciper, datastyrning, frågetjänst och segmentbyggaren går du till lektion 11 i självstudiekursen Getting Started for Data Architects and Data Engineers. I de tidigare lektionerna av den här andra självstudiekursen kan du manuellt skapa allt som just fyllts i av de här Postman-kollektionerna - du kommer snabbt igång!
Om du vill skapa en exempelimplementering av Web SDK för att länka till den här sandlådan går du igenom
Implementera Adobe Experience Cloud med Web SDK, genomgång. När du har konfigurerat lektionerna "Initial Configuration", "Tags Configuration" och "Set up Experience Platform" i självstudiekursen för Web SDK loggar du in på Lumas webbplats med de första tio e-postadresserna i dialogrutan luma-crm.json
med lösenord test
för att se profilfragmenten sammanfogas med data som överförts i den här självstudiekursen.
Om du vill skapa ett exempel på en mobil SDK-implementering som länkar till den här sandlådan går du igenom
Implementera Adobe Experience Cloud i mobilappar, genomgång. När du har konfigurerat lektionerna"Inledande konfiguration","App-implementering" och"Experience Platform" i självstudiekursen för Web SDK loggar du in på Lumas webbplats med de första e-postadresserna i luma-crm.json
om du vill se en profilfragmentsammanslagning med data som överförts i den här självstudiekursen.
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ö.