Importera exempeldata till Adobe Experience Platform
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.
Exempel på dataanvändning
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.
Förhandskrav
- Du har tillgång till Experience Platform API:er och kan autentisera. Om inte, gå igenom den här självstudiekursen.
- Du har tillgång till en Experience Platform-utvecklingssandlåda.
- Du känner till ditt Experience Platform tenant-ID. Du kan hämta den genom att göra en autentiserad API-begäran
eller genom att extrahera det från URL:en när du loggar in på ditt plattformskonto. I följande URL är klientorganisationen till exempeltechmarketingdemos
https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
.
Använder Postman postman
Ställ in miljövariabler
Kontrollera att du har hämtat programmet Postman innan du följer stegen. Kom så börjar vi!
-
Hämta filen platform-utils-main.zip som innehåller alla filer som krävs för den här självstudiekursen.
note note NOTE Användardata i filen platform-utils-main.zip är fiktiva och ska endast användas i demonstrationssyfte. -
Flytta
platform-utils-main.zip
-filen till önskad plats på datorn från hämtningsmappen och packa upp den. -
Öppna alla
json
-filer i en textredigerare i mappenluma-data
och ersätt alla instanser av_yourTenantId
med ditt eget klient-ID, föregånget av ett understreck. -
Öppna
luma-offline-purchases.json
,luma-inventory-events.json
ochluma-web-events.json
i en textredigerare och uppdatera alla tidsstämplar så att händelserna inträffar den senaste månaden (sök till exempel efter"timestamp":"2022-11
och ersätt år och månad) -
Observera platsen för den uppzippade mappen, som du behöver den senare när du konfigurerar miljövariabeln
FILE_PATH
Postman :note note NOTE Om du vill hämta filsökvägen på din Mac går du till mappen platform-utils-main
, högerklickar på mappen och väljer alternativet Visa info .note note NOTE 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 den nedrullningsbara menyn Arbetsytor:
-
Ange ett namn och valfri sammanfattning för arbetsytan och klicka på Skapa Workspace. Postman växlar till din nya arbetsyta när du skapar den.
-
Justera några inställningar för att köra Postman-samlingarna på den här arbetsytan. Klicka på kugghjulsikonen i sidhuvudet på Postman och välj Inställningar för att öppna inställningarna modal. Du kan också använda kortkommandot (CMD/CTRL + ,) för att öppna modala bilder.
-
Under fliken
General
uppdaterar du timeout för begäran i ms till5000 ms
och aktiverarallow reading file outside this directory
note note NOTE 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
inte är samma som arbetskatalogsökvägen för Postman bör det här alternativet aktiveras. -
Stäng panelen Inställningar.
-
Markera miljöerna och välj 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 lära dig hur du hämtar miljövariabelns värde kan du gå till självstudiekursen Autentisera till Experience Platform-API:er 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 uppplatform-utils-main.zip
-filen. Kontrollera att den innehåller mappnamnet, till exempel/Users/dwright/Desktop/platform-utils-main
-
Spara den uppdaterade miljön
Importera Postman-samlingar
Därefter måste du importera samlingarna till Postman.
-
Markera 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
Autentisera
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 samlingen
0-Authentication
, markeraOAuth: Request Access Token
-begäran och klicka påSEND
för att autentisera och hämta åtkomsttoken. -
Granska miljövariablerna och observera att
ACCESS_TOKEN
nu är ifylld.
Importera data
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 samlingen
1-Luma-Loyalty-Data
och klicka på Kör på översiktsfliken för att starta en samlingskörare. -
I samlingskörningsfönstret ska du se till att välja miljön i listrutan, uppdatera Fördröjning till
4000ms
, kontrollera alternativet Spara svar och se till att körningsordningen är korrekt. Klicka på knappen Kör Luma-lojalitetsdatanote note NOTE 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. note note NOTE Om en samlingsbegäran misslyckas under Postman-samlingens körningsprogram stoppar du körningen och kör samlingsbegäran en i taget. -
Om allt fungerar bra bör alla begäranden i samlingen
Luma-Loyalty-Data
skickas. -
Nu ska vi logga in på Adobe Experience Platform-gränssnittet och navigera till datauppsättningar.
-
Öppna datauppsättningen
Luma Loyalty Dataset
, och under aktivitetsfönstret för datauppsättningen kan du visa en lyckad batchkörning som kapslade 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 New Profile Fragments 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 CRM-data för kunder. 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 datamängd 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 offlineinköpshändelsedata. Schemat baseras på klassen XDM ExperienceEvent 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 datamängd för händelser som är relaterade till 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.
Validering
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-gränssnittet:
- Gå till Profiles > Browse
- Välj
Luma Loyalty Id
som Identity namespace - Sök efter
5625458
som Identity value - Öppna profilen
Daniel Wright
Genom att bläddra igenom data på flikarna Attributes och Events bör du se att profilen innehåller data från de olika datafilerna:
Nästa steg
Om du vill veta mer om Adobe Journey Optimizer innehåller den här sandlådan allt du behöver för att hantera Journey Optimizer-utmaningar
Om du vill lära dig mer om sammanfogningsprinciper, datastyrning, frågetjänst och segmentbyggaren går du till lektion 11 i självstudiekursen Komma igång för dataarkitekter och datatekniker. 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, självstudiekurs. När du har konfigurerat lektionerna"Inledande konfiguration","Taggkonfiguration" och"Konfigurera Experience Platform" i självstudiekursen för Web SDK loggar du in på Lumas webbplats med hjälp av de första tio e-postadresserna i filen luma-crm.json
med hjälp av lösenordet 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 filen luma-crm.json
för att se en profilfragmentsammanslagning med data som överförts i den här självstudiekursen.
Återställ sandlådemiljö reset-sandbox
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ö.