PeopleStage broadcasting and responses

Defining the Broadcast Channel in PeopleStage

To use Instiller with PeopleStage, you must set up a channel that defines the settings and parameters and any fields that you always want to send to Instiller.

To define a broadcast channel:

1. Open PeopleStage, select File > Administration > Channel Editor.

2. Click Add Email Channel through the context menu.

   

3. Enter a name in Channel Name.

   Note: (Optional) Select Yes from the Allow In Transactional Output (you need to be careful if you select this option, as it means we can send multiple emails to the same email address).

4. Define Output Settings for Instiller.

   

   Field	Settings
   Broadcaster	Select Instiller from the drop-down
   Username	Enter your API username
   Password	Enter your API password
   Variable Name	Select Email Address from the drop-down
   Variable Description Override	Enter the description, for example, “Email Address” Note: This must correspond to the e-mail field within Instiller
   Upload but don’t broadcast	(Optional) – Select this check box to upload the list only without initiating a broadcast
   Append to List	Deselected
   Reply email Address	The email address that will receive notifications when the channel is used, i.e. list uploaded / broadcast. Note: This is not the reply email address that will be used for the email send.
   Number of Retries	The number of times to retry on failure of the channel. It is recommended (for Broadcast Channels) to leave this at 0. The Delivery Agent also has a retry value, so setting this to > 0 can result in multiple retries and may cause undesirable results
   Response File Key Type	The key field to match responses to sends. Varies from broadcaster to broadcaster due to the fields they return in the response file. Should be set to Communication Key for Instiller.
   Message Content Type	Only Dynmark has the ability to use PeopleStage templates so this will always be Broadcaster Template. This is where the creative comes from.

5. Complete the File Settings.

   

   Note: The Encoding is set to UTF8 in the code.

6. The ESP Parameter Settings tab is blank by default, select parameters from the drop-down and click Add to complete the form.

   You are able to get these from Instiller or contact your Partner or Apteco support.

   

   Field	Settings
   	*Example, or these are specific to your account
   API Key	Your Instiller API Key
   API ID	Your Instiller API ID
   Field Map Name	Your Instiller Field Map Name
   Use Dated List	True
   Urn Field Name	Your Instiller Urn Field Name
   Email Field Name	Your Instiller Email Filed Name
   Encoding	UTF8

   See API Parameters for all the available parameters.

7. Add any additional variables on the Additional Variables tab.

   Tip: You can map actual variables from your FastStats System or you can use an empty Virtual Variable (VV) text field created in FastStats to map to the Instiller fields.

8. Click Save & Close.

Broadcasting in PeopleStage

You can now test your channel at any Delivery Stage.

To do so:

1. Drag your new Instiller channel from the Library to your Delivery step.

2. You can select from the available messages in Instiller from the Message Name drop-down or use PeopleStage’s functionality to dynamically select a message, to use a different language for example.

3. Deselect the As above check-box use the same List Name as the Message Name.

Selecting the Requires Manual Approval check box gives the option to view a sample list before processing.