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 detaljhandelsmärke som kallas Luma. De investerar i Adobe Experience Platform för att kombinera lojalitet, CRM, produktkataloger 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örutsättningar

• Du har tillgång till Experience Platform API:er och kan autentisera. Om inte, gå igenom detta självstudiekurs.
• Du har tillgång till en Experience Platform-utvecklingssandlåda.
• Du känner till ditt Experience Platform tenant-ID. Du kan få det genom att skapa 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 "
  techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home.

Använda Postman

Ställ in miljövariabler

Kontrollera att du har hämtat Postman program. Kom så börjar vi!

1. Ladda ned platform-utils-main.zip som innehåller alla filer som behövs för kursen.

   OBSERVERA

   Användardata i platform-utils-main.zip filen är fiktiv och ska endast användas som exempel.

2. Flytta platform-utils-main.zip till önskad plats på datorn och packa upp den.

3. 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.

4. Öppna luma-offline-purchases.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-06 och ersätta år och månad)

5. Observera platsen för den uppzippade mappen, som du behöver den senare när du konfigurerar FILE_PATH Postman miljövariabel:

   OBSERVERA

   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.

   

   OBSERVERA

   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.

   

6. Öppna Postman och skapa en ny arbetsyta från Arbetsytor nedrullningsbar meny:
   

7. Ange Namn och valfria Sammanfattning för arbetsytan och klicka Skapa arbetsyta. Postman växlar till den nya arbetsytan när du skapar den.
   

8. Justera några inställningar för att köra Postman-samlingar på den här arbetsytan. Klicka på kugghjulsikonen i Postman sidhuvud 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.

9. Under General uppdaterar du timeout för begäran i ms till 5000 ms och aktivera allow reading file outside this directory
   

   OBSERVERA

   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 samma som sökvägen till Postman arbetskatalog, så det här alternativet bör aktiveras.

10. Stäng Inställningar -panelen.

11. Välj Miljö och sedan markera Importera:
    

12. Importera den hämtade JSON-miljöfilen, DataInExperiencePlatform.postman_environment

13. I Postman väljer du din miljö i den övre högra listrutan och klickar på ögonikonen för att visa miljövariablerna:
    

14. 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 Console
    • TECHNICAL_ACCOUNT_ID
    • META_SCOPE
    • IMS
    • IMS_ORG—Organization ID i Adobe Developer Console
    • PRIVATE_KEY
    • SANDBOX_NAME
    • CONTAINER_ID
    • TENANT_ID—se till att leda med ett understreck, till exempel _techmarketingdemos
    • 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

15. Spara den uppdaterade miljön

Importera Postman-samlingar

Därefter måste du importera samlingarna till Postman.

1. Välj Samlingar och välj sedan importalternativet:

   

2. 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

   

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.

1. Ö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.

   

2. Granska miljövariablerna och lägg märke till att JWT_TOKEN och ACCESS_TOKEN är nu ifyllda.

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!

1. Öppna 1-Luma-Loyalty-Data samling och klicka Kör på översiktsfliken för att starta en Collection Runner.

   

2. 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

   

   OBSERVERA

   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.

   OBSERVERA

   Om en samlingsbegäran misslyckas under Postman-samlingens körningsprogram stoppar du körningen och kör samlingsbegäran en i taget.

3. Om allt går bra, finns alla förfrågningar i Luma-Loyalty-Data -samlingen ska passera.

   

4. Nu ska vi logga in på Adobe Experience Platform och navigera till datauppsättningar.

5. Ö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.
   

6. 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öp. Schemat är baserat på XDM ExperienceEvent-klassen och består av en anpassad identitet och fältgrupper för Commerce Details.

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:

1. Gå till Profiler > Bläddra
2. Välj Luma Loyalty Id som Namnutrymme för identitet
3. Sök efter 5625458 som Identitetsvärde
4. Öppna Danny Wright profil

Genom att bläddra bland data i Attribut och Händelser ser du att profilen innehåller data från de olika datafilerna:

Nästa steg

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.

Återställ sandlådemiljö

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ö.

Resurser för Business.Adobe.com