Send audience lists to Sailthru by Marigold

Note

This topic contains information about configuring a destination that sends query results to Sailthru by Marigold using orchestrations. To configure a destination that sends audiences to Sailthru by Marigold using campaigns see this topic .

Sailthru by Marigold is a cross-channel marketing platform built to deliver personalized experiences for consumers across email, web, and mobile channels.

Use Amperity to manage audience lists in Sailthru by Marigold. Build a query using the email field, and then send the results of that query to Sailthru by Marigold or build a segment that matches specific criteria, and then send the email addresses for customers who belong to that audience. You may extend the audience using custom attributes.

Note

This destination uses the Sailthru API .

Get details

Review the following details before configuring credentials for Sailthru by Marigold and before configuring Amperity to send email lists to Sailthru by Marigold.

Detail 1.

Credential settings

API key

Required

The API key for your Sailthru by Marigold account.

API secret

Required

The API secret for your Sailthru by Marigold account.

You can find the API key and secret after you log in to Sailthru by Marigold and authenticate to the Sailthru API. The API key and API secret are available on the “Setup – API & Postbacks” page.

Tip

You can find the API key and secret after you log in to Sailthru by Marigold. The API key and API secret are available after you authenticate to the Sailthru by Marigold API. (See the first item under “Setup – API & Postbacks” on that page.)

Detail 2.

Required configuration settings

Audience primary key

Required

The primary key for the audience. Set to “email”.

List name

The name of the list in Sailthru by Marigold that is managed by Amperity. This list will be created by Amperity if it does not exist.

Detail 3.

A query that outputs the fields that must be mapped to the Sailthru by Marigold audience.

Configure credentials

Configure credentials for Sailthru by Marigold before adding a destination.

An individual with access to Sailthru by Marigold should use SnapPass to securely share “refresh token” details with the individual who will configure Amperity.

To configure credentials for Pinterest

Step 1.

From the Settings page, select the Credentials tab, and then click the Add credential button.

Step 2.

In the Credentials settings dialog box, do the following:

From the Plugin dropdown, select Sailthru by Marigold.

Assign the credential a name and description that ensures other users of Amperity can recognize when to use this destination.

Step 3.

The settings that are available for a credential are determined by the credential type. For the “sailthru” credential type, configure settings, and then click Save.

API key

Required

The API key for your Sailthru by Marigold account.

API secret

Required

The API secret for your Sailthru by Marigold account.

You can find the API key and secret after you log in to Sailthru by Marigold and authenticate to the Sailthru API. The API key and API secret are available on the “Setup – API & Postbacks” page.

Add destination

Use a sandbox to configure a destination for Sailthru by Marigold. Before promoting your changes, send a test audience, and then verify the the results in Sailthru by Marigold. After the end-to-end workflow has been verified, push the destination from the sandbox to production.

To add a destination for Pinterest

Step 1.

Open the Destinations page, and then click the Add destination button.

Add

To configure a destination for Sailthru by Marigold, do one of the following:

  1. Click the row in which Sailthru by Marigold is located. Destinations are listed alphabetically and you can scroll up and down the list.

  2. Search for Sailthru by Marigold. Start typing “sai”. The list will filter to show only matching destinations. Select “Sailthru”.

Step 2.

Select the credential for Sailthru by Marigold from the Credential drop-down, and then click Continue.

Tip

Click the “Test connection” link on the “Configure destination” page to verify that Amperity can connect to Sailthru by Marigold.

Step 3.

In the “Destination settings” dialog box, assign the destination a name and description that ensures other users of Amperity can recognize when to use this destination.

Configure business user access

By default a destination is available to all users who have permission to view personally identifiable information (PII).

Enable the Admin only checkbox to restrict access to only users assigned to the Datagrid Operator and Datagrid Administrator policies.

Enable the PII setting checkbox to allow users with limited access to PII access to this destination.

Restricted PII access is enabled when the Restrict PII access policy option that prevents users who are assigned to that option from viewing data that is marked as PII anywhere in Amperity and from sending that data to any downstream workflow.

Step 4.

Configure the following settings, and then click “Save”.

Audience primary key

The primary key for the audience. Set to “email”.

List name (Required at orchestration)

The name of the list in Sailthru by Marigold that is managed by Amperity. This list will be created by Amperity if it does not exist.

Step 5.

After this destination is configured, users may configure Amperity to:

  • Use orchestrations to send query results

  • Use orchestrations and campaigns to send audiences

  • Use orchestrations and campaigns to send offline events

to Sailthru by Marigold.

Extended profile attributes

You can extend audiences that are sent to Sailthru by Marigold by including extended profile attributes.

The following SQL query shows how to return results that map to Sailthru by Marigold field naming requirements:

SELECT
  address AS postal_address
  ,address2 AS postal_address2
  ,birthdate AS birth_date
  ,city AS postal_city
  ,country
  ,full_name AS name
  ,gender
  ,given_name AS first_name
  ,phone
  ,postal AS postal_code
  ,surname AS last_name
  ,state AS postal_state
FROM Customer360

Note

Sailthru by Marigold field names are case sensitive and cannot start with a number. Review the list of extended profile attributes that are supported by Sailthru by Marigold.