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.

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

Förutsättningar

  • Du har tillgång till Experience Platform API:er och kan autentisera. Om inte, granska 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 postman

Ställ in miljövariabler

Innan du följer instruktionerna kontrollerar du 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.

    note note
    NOTE
    Användardata i platform-utils-main.zip filen är fiktiv och ska endast användas för demonstrationssyften.
  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 _yourTenantId med ditt eget klient-ID, föregånget av ett understreck.

  4. Öppna luma-offline-purchases.json, luma-inventory-events.jsonoch 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)

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

    note note
    NOTE
    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.
    Sökväg till Mac
    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.
    Sökväg till Windows-fil
  6. Öppna Postman och skapa en arbetsyta från Arbetsytor listrutemeny:
    Skapa arbetsyta

  7. 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.
    Spara arbetsyta

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

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

    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 är inte detsamma som PostmanI arbetskatalogsökvägen ska det här alternativet aktiveras.
  10. Stäng Inställningar -panelen.

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

  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:
    Miljöval

  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_KEYClient ID i Adobe Developer Console
    • SCOPES
    • TECHNICAL_ACCOUNT_ID
    • IMS
    • IMS_ORGOrganization ID i Adobe Developer Console
    • SANDBOX_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
  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:

    Samlingar

  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
    • 5-Luma-Product-Inventory-Events.postman_collection.json
    • 6-Luma-Test-Profiles.postman_collection.json
    • 7-Luma-Web-Events.postman_collection.json

    Import av samlingar

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 0-Authentication samling, välj OAuth: Request Access Token begär och klickar på SEND för att autentisera och hämta åtkomsttoken.

    Import av samlingar

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

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.

    Import av samlingar

  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

    Import av samlingar

    note 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.
  3. Om allt går bra, finns alla förfrågningar i Luma-Loyalty-Data -samlingen ska passera.

    Förmånsresultat

  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 New Profile Fragments skapades.
    Förmånsdatauppsättning

  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ö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 Optimizer
    • 7-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:

  1. Gå till Profiles > Browse
  2. Välj Luma Loyalty Id som Identity namespace
  3. Sök efter 5625458 som Identity value
  4. Öppna Daniel Wright profil
TIP
Om du inte ser profilen kan du kontrollera Datasets 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å Datasets och dra och släpp JSON-datafilen för att importera data igen.

Öppna en profil

Genom att bläddra bland data i Attributes och Events ser du att profilen innehåller data från de olika datafilerna:
Händelsedata från offlineinköpshändelsefilen

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

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

recommendation-more-help
9051d869-e959-46c8-8c52-f0759cee3763