Verktyg i sandlådan
Du måste ha följande två rollbaserade åtkomstkontrollsbehörigheter för att kunna använda sandlådeverktygsfunktionen:
-
manage-sandbox eller view-sandbox-
manage-packageFörbättra konfigurationsnoggrannheten över sandlådor och exportera och importera smidigt sandlådekonfigurationer mellan sandlådor med sandlådeverktygen. Använd sandlådeverktyg för att minska tidsåtgången för implementeringsprocessen och flytta framgångsrika konfigurationer mellan sandlådor.
Du kan använda sandlådeverktygen för att markera olika objekt och exportera dem till ett paket. Ett paket kan bestå av ett eller flera objekt. Alla objekt som ingår i ett paket måste komma från samma sandlåda.
Objekt som stöds för sandlådeverktyg supported-objects
Verktygsfunktionen i sandlådan ger dig möjlighet att exportera Adobe Real-Time Customer Data Platform- och Adobe Journey Optimizer-objekt till ett paket.
Objekt för kunddataplattform i realtid real-time-cdp-objects
Ändringar av målgruppsimporter för flera enheter
Med B2B-arkitekturuppgraderingarna kan du inte längre importera målgrupper med flera enheter med B2B-attribut och Experience Events om ett paket som innehöll dessa målgrupper publicerades före uppgraderingen. Dessa målgrupper kommer inte att kunna importera och kan inte automatiskt konverteras till den nya arkitekturen.
För att kringgå den här begränsningen måste du skapa ett nytt paket med de uppdaterade målgrupperna och sedan importera dem till deras respektive målsandlådor med hjälp av sandlådeverktyg.
Tabellen nedan visar Adobe Real-Time Customer Data Platform objekt som för närvarande stöds för sandlådeverktyg:
- Källkontots autentiseringsuppgifter replikeras inte i målsandlådan av säkerhetsskäl och måste uppdateras manuellt.
- Källdataflödet kopieras som standard i utkaststatus.
- Endast typen Customer Audience Segmentation service stöds.
- Befintliga etiketter för samtycke och styrning kopieras över i samma importjobb.
- Systemet väljer automatiskt standardsammanslagningsprincip i målsandlådan med samma XDM-klass när kopplingsprincipberoenden kontrolleras.
- Om ett befintligt objekt med samma namn upptäcks när du importerar publiker kommer sandlådeverktygen alltid att återanvända det befintliga objektet för att undvika objektförökning.
- Systemet deduplicerar Adobe standardnamnutrymmen för identiteter automatiskt när det skapas i målsandlådan.
- Publiker kan bara kopieras när alla attribut i målgruppsreglerna är aktiverade i unionsschemat. De scheman som behövs måste först flyttas och aktiveras för en enhetlig profil.
- Befintliga etiketter för samtycke och styrning kopieras över i samma importjobb.
- Du kan importera scheman utan att alternativet för enhetlig profil är aktiverat. Kantfallet för schemarelationer inkluderas inte i paketet.
- Om ett befintligt objekt med samma namn upptäcks när du importerar scheman/fältgrupper kommer sandlådeverktygen alltid att återanvända det befintliga objektet för att undvika objektförökning.
Följande objekt importeras men har statusen Utkast eller Inaktiverat:
Adobe Journey Optimizer-objekt abobe-journey-optimizer-objects
Tabellen nedan visar Adobe Journey Optimizer objekt som för närvarande stöds för sandlådeverktyg och begränsningar:
Följande objekt som används under resan kopieras som beroende objekt. Under importarbetsflödet kan du välja antingen Create new eller Use existing för varje:
- Målgrupper
- Arbetsytedetaljer
- Innehållsmallar
- Anpassade åtgärder
- Datakällor
- Händelser
- Fältgrupper
- Fragment
- Scheman
Systemet kopierar händelser och händelseinformation som används under resan och skapar en ny version i målsandlådan.
Åtgärden för att uppdatera profil som används under resan kan kopieras. Anpassade åtgärder kan läggas till i ett paket oberoende av varandra. Åtgärdsinformation som används under resan kopieras också. Den skapar alltid en ny version i målsandlådan.
Anpassade åtgärder kan läggas till i ett paket oberoende av varandra. När en anpassad åtgärd har tilldelats en resa kan den inte längre redigeras. Om du vill uppdatera anpassade åtgärder bör du:
- flytta anpassade åtgärder innan en resa migreras
- uppdateringskonfigurationer (till exempel begärandehuvuden, frågeparametrar och autentisering) för anpassade åtgärder efter migrering
- migrera reseobjekt med de anpassade åtgärder du lade till under det första steget
Följande objekt som används i kampanjen kopieras som beroende objekt:
- Kampanjer
- Målgrupper
- Scheman
- Innehållsmallar
- Fragment
- Meddelande/innehåll
- Kanalkonfiguration
- Enhetliga beslutsobjekt
- Experimentera med inställningar/varianter
- Kampanjer kan kopieras tillsammans med alla objekt som hör till profilen, målgruppen, schemat, textbundna meddelanden och beroende objekt. Vissa objekt kopieras inte, t.ex. dataanvändningsetiketter och språkinställningar. En fullständig lista över objekt som inte kan kopieras finns i guiden Exportera objekt till en annan sandlåda.
- Systemet identifierar och återanvänder automatiskt ett befintligt kanalkonfigurationsobjekt i målsandlådan om det finns en identisk konfiguration. Om ingen matchande konfiguration hittas hoppas kanalkonfigurationen över under importen, och användare måste uppdatera kanalinställningarna manuellt i målsandlådan för den här resan.
- Användare kan återanvända befintliga experiment och målgrupper i målsandlådan som beroende objekt för valda kampanjer.
Följande objekt måste finnas i målsandlådan innan du kopierar beslutsobjekt:
- Profilattribut som används mellan beslutsobjekt
- Fältgruppen med anpassade erbjudandeattribut
- Scheman för datastreams som används för kontextattribut i regler, rankning eller appning.
- Kopiering av rankningsformler som använder AI-modeller stöds för närvarande inte.
- Beslutsobjekt (erbjudandeartiklar) inkluderas inte automatiskt. Om du vill vara säker på att de överförs lägger du till dem manuellt med alternativet Lägg till i paket.
- Principer som använder en urvalsstrategi kräver att associerade beslutsartiklar läggs till manuellt under kopieringsprocessen. Principer som använder manuella eller reservbeslutsobjekt inkluderas automatiskt dessa objekt som direkta beroenden.
- Beslutsobjekt måste kopieras först, innan andra relaterade objekt.
Profilattribut som används mellan beslutsobjekt,
Fältgruppen med anpassade erbjudandeattribut,
Scheman för datastreams som används för kontextattribut i regler, rankning eller appning.
Ytor (till exempel förinställningar) kopieras inte över. Systemet väljer automatiskt den närmsta möjliga matchningen i målsandlådan baserat på meddelandetyp och ytnamn. Om det inte finns några ytor i målsandlådan, kommer ytkopian att misslyckas, vilket gör att meddelandekopian misslyckas eftersom ett meddelande kräver att en yta är tillgänglig för konfiguration. I det här fallet måste minst en yta skapas för den högra kanalen i meddelandet för att kopian ska fungera.
Anpassade identitetstyper stöds inte som beroende objekt när en resa exporteras.
Exportera objekt till ett paket export-objects
I det här exemplet dokumenteras processen att exportera ett schema och lägga till det i ett paket. Du kan använda samma process för att exportera andra objekt, till exempel datauppsättningar, resor och många andra.
Lägga till objekt i ett nytt paket add-object-to-new-package
Välj Schemas i den vänstra navigeringen och välj sedan fliken Browse som listar tillgängliga scheman. Markera sedan ellipsen (...) bredvid det valda schemat och en listruta visar kontroller. Välj Add to package i listrutan.
Välj alternativet Add to package i dialogrutan Create new package. Ange en Name för ditt paket och en valfri Description och välj sedan Add.
Du återgår till miljön Schemas. Nu kan du lägga till fler objekt i det paket du skapade genom att följa stegen nedan.
Lägga till ett objekt i ett befintligt paket och publicera add-object-to-existing-package
Om du vill visa en lista över tillgängliga scheman väljer du Schemas i den vänstra navigeringen och väljer sedan fliken Browse. Markera sedan ellipsen (...) bredvid det valda schemat för att visa kontrollalternativen i en listruta. Välj Add to package i listrutan.
Dialogrutan Add to package visas. Välj alternativet Existing package, markera sedan listrutan Package name och välj det paket som krävs. Slutligen väljer du Add för att bekräfta dina val.
Listan med objekt som läggs till i paketet visas. Om du vill publicera paketet och göra det tillgängligt för import till sandlådor väljer du Publish.
Välj Publish för att bekräfta publiceringen av paketet.
Du återgår till fliken Packages i miljön Sandboxes där du kan se det nya publicerade paketet.
Importera ett paket till en målsandlåda import-package-to-target-sandbox
Om du vill importera paketet till en mållandlåda går du till fliken Sandlådor Browse och väljer plustecknet (+) bredvid namnet på sandlådan.
Välj den Package name som du vill importera till målsandlådan med hjälp av listrutan. Lägg till en Job name som kommer att användas för framtida övervakning. Som standard inaktiveras den enhetliga profilen när paketets scheman importeras. Aktivera det här genom att växla Aktivera scheman för profilen och sedan välja Next.
Sidan Package object and dependencies innehåller en lista med alla resurser som ingår i det här paketet. Systemet identifierar automatiskt beroende objekt som krävs för att importera markerade överordnade objekt. Eventuella attribut som saknas visas högst upp på sidan. Välj View details om du vill ha en mer detaljerad beskrivning.
Om du vill använda ett befintligt objekt väljer du pennikonen bredvid det beroende objektet.
Alternativen för att skapa nya eller använda befintliga visas. Välj Use existing.
Dialogrutan Field group visar en lista med fältgrupper som är tillgängliga för objektet. Markera de fältgrupper som krävs och välj sedan Save.
Du återgår till sidan Package object and dependencies. Här väljer du Finish för att slutföra paketimporten.
Exportera och importera en hel sandlåda
Du kan exportera alla objekttyper som stöds till ett fullständigt sandlådepaket och sedan importera paketet mellan olika sandlådor för att replikera objektkonfigurationer. Med den här funktionen kan du till exempel:
- Importera om en sandlåda för att återskapa alla objektets konfigurationer om du behöver återställa sandlådan
- Importera paketet till andra sandlådor och använd det som en blå sandlåda för att snabba upp utvecklingsprocessen.
Exportera en hel sandlåda export-entire-sandbox
Om du vill exportera en hel sandlåda går du till fliken Sandboxes Packages och väljer Create package.
Välj Entire sandbox för Type of package i dialogrutan Create package. Ange en Package name för ditt nya paket och välj Sandbox i listrutan. Slutligen väljer du Create för att bekräfta dina inlägg.
Paketet har skapats. Välj Publish om du vill publicera paketet.
Du återgår till fliken Packages i miljön Sandboxes där du kan se det nya publicerade paketet.
Importera hela sandlådepaketet import-entire-sandbox-package
Om du vill importera paketet till en målsandlåda går du till fliken Sandboxes Browse och väljer plustecknet (+) bredvid namnet på sandlådan.
Använd listrutan och markera den fullständiga sandlådan med listrutan Package name. Lägg till en Job name som kommer att användas för framtida övervakning och en valfri Job description och välj sedan Next.
Du dirigeras till sidan Package object and dependencies där du kan se antalet objekt och beroenden som är importerade och exkluderade objekt. Här väljer du Import för att slutföra paketimporten.
Tillåt en tid för importen att slutföras. Tiden det tar att slutföra kan variera beroende på antalet objekt i paketet. Du kan övervaka importjobbet på fliken Sandboxes Jobs.
Importinformation för bildskärm view-import-details
Om du vill visa importerad information går du till fliken Sandboxes Jobs och väljer paketet i listan. Du kan också använda sökfältet för att söka efter paketet.
Välj View import summary i den högra informationsrutan på fliken Jobs i sandlådemiljön.
Dialogrutan Import summary visar en fördelning av importen med förlopp i procent.
När importen är klar visas ett meddelande i Experience Platform-gränssnittet. Du kommer åt dessa meddelanden via varningsikonen. Du kan navigera till felsökning härifrån om ett jobb misslyckas.
Överför iterativa objektkonfigurationsuppdateringar över sandlådor via sandlådeverktyg move-configs
Du kan använda sandlådeverktyg för att överföra objektkonfigurationer mellan olika sandlådor. Tidigare var det nödvändigt att manuellt återskapa eller importera konfigurationsuppdateringar för dina objekt (t.ex. scheman, fältgrupper och datatyper) för att kunna överföras till andra sandlådor. Med den här funktionen kan du använda sandlådeverktyg för att snabba upp dina arbetsflöden och minska antalet potentiella fel genom att överföra dina konfigurationsuppdateringar mellan olika sandlådor.
- Lämpliga behörigheter för att komma åt sandlådeverktyg.
- Ett nyskapat eller uppdaterat objekt (till exempel ett schema) i källsandlådan.
Objekttyper som stöds för uppdateringsåtgärd
Följande objekttyper stöds för uppdatering:
- Scheman
- Fältgrupper
- Datatyper
- Lägger till nya fält/fältgrupper till resursen.
- Gör ett obligatoriskt fält valfritt.
- Nya obligatoriska fält introduceras.
- Vi presenterar ett nytt relationsfält.
- Ett nytt identitetsfält introduceras.
- Ändra resursens visningsnamn och beskrivning.
- Tar bort tidigare definierade fält.
- Definiera om befintliga fält när schemat är aktiverat för kundprofil i realtid.
- Tar bort eller begränsar fältvärden som tidigare stöds.
- Befintliga fält flyttas till en annan plats i schematrädet. Detta skapar ett nytt fält i målsandlådan, men det föregående fältet tas inte bort.
- Aktivera eller inaktivera schemat för att delta i profilen - den här åtgärden hoppas över vid differensjämförelse.
- Åtkomstkontrolletiketter.
Följ stegen nedan för att lära dig hur du använder sandlådeverktyg för att överföra objektkonfigurationer mellan olika sandlådor.
Tidigare importerade objekt
Följ de här stegen om du använder befintliga objekt i din källsandlåda som kräver konfigurationsuppdateringar när du redan har paketerat och importerat dem till andra sandlådor.
Uppdatera först objektet i källsandlådan. Navigera till arbetsytan Schemas, markera ditt schema och lägg till en ny fältgrupp.
När du har uppdaterat ditt schema går du till Sandboxes, väljer Packages och letar upp ditt befintliga paket.
Använd paketgränssnittet för att verifiera dina ändringar. Välj Check for updates om du vill visa ändringar i artefakterna i ditt paket. Välj sedan View diff om du vill få en detaljerad sammanfattning av alla ändringar som har utförts mot dina artefakter.
Gränssnittet View diff visas. Se den här avgiften för information om dina käll- och målartefakter samt vilka ändringar som ska tillämpas på dem.
Under det här steget kan du även välja Summarize with AI om du vill se en stegvis sammanfattning av alla ändringar.
När du är klar väljer du Update package och sedan Confirm i popup-fönstret som visas. När jobbet är klart kan du uppdatera sidan och välja View history för att verifiera paketversionen.
Om du vill importera ändringarna går du tillbaka till katalogen Packages och markerar ellipserna (...) bredvid paketet. Välj sedan Import package. Experience Platform väljer automatiskt Update existing objects. Kontrollera ändringarna och välj sedan Finish.
Om du vill validera din importprocess ytterligare navigerar du till målsandlådan och manuellt visar det uppdaterade objektet inifrån den sandlådan.
Objekt som skapats manuellt i mållandlådan
Följ de här stegen om du använder konfigurationsändringar på objekt som har skapats manuellt i separata sandlådor.
Först skapar och publicerar du ett nytt paket med det uppdaterade objektet.
Importera sedan paketet till målsandlådan som innehåller de objekt som du också vill uppdatera. Under importprocessen markerar du Update existing objects och använder sedan objektnavigeraren för att manuellt markera de målobjekt som du vill att dina uppdateringar ska gälla för.
- Det är valfritt att välja en målmappning i en annan sandlåda för beroende objekt. Om ingen är markerad skapas en ny.
- För identitetsnamnutrymmen upptäcker systemet automatiskt om en ny identitet behöver skapas om en befintlig identitet måste återanvändas i målsandlådan.
När du har identifierat de målobjekt som du vill uppdatera väljer du Finish.
Videosjälvstudiekurs
Följande video är avsedd att ge stöd för din förståelse av sandlådeverktyg och visar hur du skapar ett nytt paket, publicerar ett paket och importerar ett paket.
Nästa steg
Det här dokumentet visar hur du använder sandlådeverktygen i Experience Platform-gränssnittet. Mer information om sandlådor finns i användarhandboken för sandlådan.
Anvisningar om hur du utför olika åtgärder med sandbox-API:t finns i utvecklarhandboken för sandlådan. En översikt över sandlådor i Experience Platform på hög nivå finns i översiktsdokumentationen.