Merge pull request #1919 from segmentio/personasadditions

DOC-261: Folders, Cloning, Debugger content

Author: pwseg

src/images/personas_debugger.png

@@ -0,0 +1,82 @@
+---
+title: Organizing Your Audiences
+---
+
+To add structure to your [Personas Spaces](/docs/personas/identity-resolution/personas-space-set-up/), you can organize Audiences into folders and clone Audiences within, and between, Spaces.
+
+## Working with Folders
+
+Folders allow you to group Audiences together. You can create, edit, and search through folders directly within the Personas Audiences page.
+
+### Creating a Folder
+
+To create a Folder, follow the steps below:
+
+1. Navigate to the Audiences tab within your Personas space.
+2. Click **Create**, then select **Folder** from the dropdown menu.
+3. Give your Folder a unique name, then click **Add Audiences**.
+4. Search for and select the Audience(s) you want to add to the Folder.
+5. To confirm the new Folder, click **Add Audiences**.
+
+## Editing and Disbanding Folders
+
+To edit the name or description of a Folder you’ve created in Personas, click the **More Options** icon and select **Edit**.  Once you’ve made your desired changes, click **Save**.
+
+To disband a Folder you’ve made in Personas, click the **More Options** icon and select **Disband**.   Audiences from the disbanded Folder return to your main Audience list.
+
+> info "Note"
+> Disbanding a Folder won't delete any Audiences.
+
+## Moving Audiences into Folders
+
+To move an Audience to a Folder you’ve already created, follow the steps below:
+
+1. Navigate to the Audiences tab within your Personas space.
+2. Hover over the Audience you want to move.
+3. Check the selection box that appears next to the Audience name.
+4. **Optional**: repeat Steps 2 and 3 to move multiple Audiences.
+5. Click the **Move** icon that appears in the Audiences header.
+6. Select your destination Folder from the modal window.
+7. Click **Move** to confirm and move the selected Audiences.
+
+
+## Cloning Audiences
+
+Audience cloning creates a copy of your Audience.  Within Personas, you can clone an Audience within the same space, or clone an Audience to a different space.
+
+### Cloning an Audience inside a Space
+
+To clone an Audience within the same Space, follow the steps below:
+
+1. Navigate to the Audiences tab within your Personas space.
+2. Click the **More Options** icon next to the Audience you want to clone.
+3. From the dropdown menu, click **Clone**.
+4. Select **Current Space**, then click **Continue**.
+5. Configure the Audience, click **Preview Results**, then click **Select Destination**.
+6. **Optional**: on the next screen, connect the Audience to a Destination.  Click **Review & Create**.
+7. Give your Audience a unique name, then click **Create Audience**.
+
+### Cloning an Audience between Spaces
+
+You may wish to clone an Audience between spaces for a number of use cases, including the following:
+
+
+* Copying an Audience between testing and production spaces
+* Copying an Audience between business units
+* Copying an Audience between teams
+
+> info "Note"
+> When you clone an Audience to a different space, first verify that the target Space includes the same events and traits for the cloned Audience.
+
+To clone an Audience between Spaces, follow the steps below:
+
+1. Navigate to the Audiences tab within your Personas space.
+2. Click the **More Options** icon next to the Audience you want to clone.
+3. From the dropdown menu, click **Clone**.
+4. Select **Different Space**, choose your target Space, then click **Continue**.
+5. Configure the Audience, click **Preview Results**, then click **Select Destination**.
+6. **Optional**: on the next screen, connect the Audience to a Destination.  Click **Review & Create**.
+7. Give your Audience a unique name, then click **Create Cloned Audience**.
+
+
+If your target Space doesn't include the cloned Audience's events and traits, Personas prompts you to resolve the Space incompatibilities during Step 5.  As a best practice, verify that the target Space includes the Audience's traits and events before cloning.

src/images/personas_debugger1.png

@@ -0,0 +1,26 @@
+---
+title: Using the Personas Source Debugger
+---
+
+Using the Personas Source Debugger, you can inspect and monitor the events that Personas sends downstream.
+
+Because Personas generates a unique Source for every Destination connected to a Space, the Debugger gives you insight into how Personas sends events before they reach their Destination.
+
+The Debugger provides you with the payload information you need to troubleshoot potential formatting issues and ensure process and sends events as your Destinations expect.
+
+## Working with the Debugger
+
+To access the Debugger within your Space, click on the **Settings** tab, and then the **Debugger** tab.
+
+![](images/personas_debugger.png)
+
+Next, click on the Source you want to inspect in the Debugger.
+
+![](images/personas_debugger1.png)
+
+The Debugger displays the payload in two tabs:
+
+* **Pretty view** shows the actual API call Segment sends to your Destination.
+* **Raw view** shows the full JSON object Segment sends to your Destination from the calls you sent, including timestamps, properties, traits, and ids.
+
+Similar to the Connections Debugger, the Personas Debugger allows you to search through events, using information contained within the event's payload.