Configure a playbook sandbox
Learn how to configure a sandbox for Use Case Playbooks. To get started with Use Case Playbooks, you must:
- Create a development sandbox with
-ucp
as a suffix in the name - Add permissions and users to the sandbox
- Configure channel surfaces for email, push, and SMS
For more information, see Get started with Use Case Playbooks.
Transcript
Hi, it鈥檚 Daniel. In this video, I鈥檓 going to show you how to configure your account for UseCase Playbooks. UseCase Playbooks is a feature for real-time customer data platform and Journey Optimizer customers. The three main configuration steps are to create a sandbox, configure user permissions, and configure Journey Optimizer channel services for email push and SMS. UseCase Playbooks uses a special type of development sandbox. You need to create a new sandbox in your account using hyphen ucp in the name. Let me demonstrate. I can title it whatever I want, but the name must include hyphen ucp. Now that the sandbox is created, I need to myself and other users access. So let鈥檚 get into step two, configuring the user permissions. The quick way to add permissions is just to add this new sandbox to roles that you鈥檝e already configured. Maybe you have some roles you use to give access to other dev sandboxes, and maybe you just add your new UseCase Playbooks sandbox to those roles. The other option is to add a new role or roles and add the necessary permissions. Let me set up a new role with permissions needed to do the essential tasks with Playbooks. First, I鈥檒l create the role and add my new sandbox to it. Now, when a user creates an instance of a Playbook, they generate assets like schemas, audiences, and journeys. So users need permissions to create those objects. So to create schemas, I need the data modeling items for view and manage schemas. Plus I need the ability to attach identities to schema fields. Let me just show you a quick snapshot of all of the permission items needed to create all instances of the Playbooks. So lastly, I鈥檒l add myself as a user to this role. If you have another set of users you wanted to only give view access to, you鈥檇 create a pared down role that only had the view items associated with these permissions. So now we鈥檙e on to the third step, which is to configure the email, SMS, and push channel surfaces for Journey Optimizer. Obviously, this is only a requirement and you want to create instances of Playbooks containing Journey Optimizer assets. Let me show you what will happen if you don鈥檛 configure your channel surfaces. If you attempt to create an instance of a Playbook using Journey Optimizer, you鈥檒l be prompted with this message. I鈥檓 just going to show you a quick version of how to set up these channel surfaces. There are other materials which go into much more depth. I鈥檓 going to begin with the assumption that you鈥檙e already using Journey Optimizer and other sandboxes and that you have some account level settings already configured. So let鈥檚 start with email. In the Journey Optimizer interface, I鈥檒l go to channels. We begin with the assumption that you already have separate subdomains configured for marketing and transactional messages. I鈥檒l also assume that you have separate IP pools configured for marketing and transactional messages. These are both best practices to help ensure that transactional messages such as order confirmation emails get through to your customers. Now I can create my email channel surface. I鈥檒l configure this surface for marketing emails. I鈥檒l name the surface and select the email channel. I鈥檒l choose my marketing subdomain and IP pool. Then I鈥檒l specify the names and email addresses that I want to appear in my emails. There are other fields I can complete to receive copies of the emails, attempt to resending emails and attaching tracking parameters. I鈥檒l just skip over those. I鈥檒l scroll to the top, hit submit and my marketing channel surface will be created. Next I鈥檒l do SMS. First I need to create an SMS API credential. We support several vendors. I鈥檒l configure my cinch API credential. Now I can configure the SMS channel surface. I鈥檒l name it SMS marketing. I鈥檒l select my cinch configuration and enter a sender number. Now I can hit submit to save my SMS channel. We set up marketing surfaces for email and SMS, but some of the playbooks contain transactional messages like order confirmations and I recommend you configure those channels too. Okay, last but not least is the push channel. We begin with the assumption that you鈥檝e already configured your app surfaces. App surfaces can be configured from the experience platform or data collection interfaces. I鈥檒l just go to data collection briefly to show you app surfaces in the left navigation. You can see that I have three iOS app surfaces and one Android app surface configured. Back in journey optimizer, I can create a channel surface for push. I just select the channel, my platforms, select the apps we just looked at in my app surface configurations and hit submit. That鈥檚 it. Now I have a development sandbox with use case playbooks available in the left navigation and I can successfully create instances of playbooks.
recommendation-more-help
9051d869-e959-46c8-8c52-f0759cee3763