Sandbox UI guide
This document provides steps on how to perform various operations related to sandboxes in the Adobe Experience Platform user interface.
View sandboxes
In the Experience Platform UI, select Sandboxes in the left navigation and then select the Browse tab to open the Sandboxes dashboard. The dashboard lists all available sandboxes for your organization, including their respective types (production or development).
Switch between sandboxes
The sandbox indicator is located in the top header of the Platform UI and displays the title of the sandbox that you are currently in, its region, and its type.
To switch between sandboxes, select the sandbox indicator and then select the desired sandbox from the dropdown list. Alternatively, you can search for your desired sandbox using the search feature within the dropdown menu.
Once a sandbox is selected, the screen refreshes and updates to the sandbox you selected.
Create a new sandbox create
Use the following video for a quick overview on how to use Sandboxes in Experience Platform.
To create a new sandbox, select Create sandbox on the top-right corner of the screen.
The Create sandbox dialog box appears. Select the Type dropdown and choose either the Development or Production sandbox type.
After selecting the type, provide a name for your sandbox in the Name field. The sandbox name is an all-lowercase identifier for use in API calls and should therefore be unique and concise. The sandbox name must begin with a letter, have a maximum of 256 characters, and consist only of alphanumeric characters and hyphens (-). Next, provide a title for your sandbox in the Title field. The title is meant to be human-readable and should be descriptive enough to be easily identifiable.
When finished, select Create.
Once you have finished creating the sandbox, refresh the page and the new sandbox appears in the Sandboxes dashboard with a status of “Creating”. New sandboxes take approximately 30 seconds to be provisioned by the system, after which their status changes to “Active”.
Reset a sandbox
- A user-created production sandbox that is used for bi-directional segment sharing with Adobe Audience Manager or Audience Core Service can be reset after a warning message.
- Before initiating a sandbox reset, you will be required to delete your compositions manually to ensure that the associated audience data is cleaned up properly.
- The sandbox ID will change after the reset is complete.
- For Journey Optimizer B2B Edition, sandbox reset is not currently supported. Resetting or deleting a sandbox that is mapped to Journey Optimizer B2B Edition may result in permanent loss of data in Journey Optimizer B2B Edition and could require provisioning of a new Journey Optimizer B2B Edition instance.
Delete audience compositions
Audience composition is currently not integrated with the sandbox reset capability, so audiences will need to be deleted manually prior to performing the sandbox reset.
Select Audiences from the Customers section in the left navigation and then select the Compositions tab.
Next, select the ellipsis (...
) next to the first audience, then select Delete.
A confirmation of successful deletion is displayed and you are returned to the Compositions tab.
Repeat the above steps with all your compositions. This will delete all audiences from the audience inventory. Once all audiences have been removed, you can continue to reset the sandbox.
Resetting a sandbox
Resetting a production or development sandbox deletes all resources associated with that sandbox (schemas, datasets, and so on), while maintaining the sandbox’s name and associated permissions. This “clean” sandbox continues to be available under the same name for users that have access to it.
Select the sandbox you want to reset from the list of sandboxes. In the right-navigation panel that appears, select Sandbox reset.
A dialog box appears prompting you to confirm your choice. Select Continue to proceed.
In the final confirmation window, enter the name of the sandbox in the dialog box and select Reset.
Delete a sandbox
Deleting a production or development sandbox permanently removes all resources associated with that sandbox, including permissions.
Select the sandbox you want to delete from the list of sandboxes. In the right-navigation panel that appears, select Delete.
A dialog box appears prompting you to confirm your choice. Select Continue to proceed.
In the final confirmation window, enter the name of the sandbox in the dialog box and select Continue.
Next steps
This document demonstrated how to manage sandboxes within the Experience Platform UI. Now that you know how to manage sandboxes, learn how to improve configuration accuracy across sandboxes and seamlessly export and import sandbox configurations between sandboxes with the sandbox tooling feature guide.
For information on how to manage sandboxes using the Sandbox API, see the sandbox developer guide.