{"_id":"57ffcd89c135231700aed879","category":{"_id":"561c7271d2fb350d004bf89a","pages":["561c80a3a2cc000d00e9a861","564de2b5b5bea52b00c3457b"],"project":"561c70aabe5fb20d00077758","version":"561c70aabe5fb20d0007775b","__v":2,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-13T02:54:41.501Z","from_sync":false,"order":4,"slug":"settings-other","title":"Settings & Other"},"parentDoc":null,"project":"561c70aabe5fb20d00077758","user":"55d29988486de50d00327118","__v":1,"version":{"_id":"561c70aabe5fb20d0007775b","__v":6,"project":"561c70aabe5fb20d00077758","createdAt":"2015-10-13T02:47:06.824Z","releaseDate":"2015-10-13T02:47:06.824Z","categories":["561c70abbe5fb20d0007775c","561c725c4b0a9b0d00c0f515","561c7260cd5e7b0d00eb48c6","561c726bf0e0580d00ddd9a4","561c7271d2fb350d004bf89a","564de219b5bea52b00c3457a"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-10-13T18:08:09.646Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Carnival is Sailthru's mobile product. You can sync and match users across email and mobile by using a shared email identifier. You can use Sailthru Natural Lists and Smart Lists to target users in your Carnival app, and you can identify and target shared Carnival users via Sailthru’s Audience Builder.\n\nWith the ability to find and target customers across email and mobile, you can now give people a more seamless, coordinated experience. For example, you can reach out by sending offers to your mobile app users who just signed up for your daily newsletter, or finding mobile customers who did not open your email re-engagement campaign and retarget them through your app. If you use Prediction Manager, you can even expand your targeting criteria to include users with high likelihood to opt out, so you can suppress these users and send them an in-app message or a push notification instead.\n\nThis will enable you to:\n- Create a Smart List with the criteria available in the Sailthru portal\n- Suppress those users from an email campaign\n- Retarget the same list with in-app message as soon as they open the app, or a push notification if their app is closed, or both.\n\n## How it Works\n- Multiple Carnival applications can be linked to a Sailthru account.\n- Shared users are identified and updated in real time, whenever email addresses match across both systems.\n- Each night, all Sailthru lists’ memberships are updated in Carnival. Using Carnival’s Audiences tool, you can then include users from any list.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"You can also manually initiate an update by starting a resync from the Sailthru portal.\",\n  \"title\": \"Update anytime\"\n}\n[/block]\n## Setup\nEmail is used as the connecting identifier between users in Sailthru and devices in Carnival. Check in with your Customer Success Manager or with your app developer to make sure you are already collecting an Email ID. You can find technical details on how to collect a shared identifier in our [Collecting User Data](http://docs.carnival.io/docs/collecting-user-data#setting-a-user-email) guide.\n\nNow that you are identifying shared users, you can enable data sharing between Carnival and Sailthru via the following one-time setup. Your Customer Success Manager can set this up for you.\n\nPerform the following actions in Carnival:\n\n1. Go to **Settings** -> **Developer**\n2. On the top navigation bar, select **Integrations**\n3. Copy the **Sailthru Integration Key**\n\nPerform the following actions in My Sailthru:\n\n1. Click the gear to get settings.\n2. In the left navigation menu, select **Channels** -> **Mobile Apps**\n3. Enter the **App Name** used in Carnival. You can use any custom meaningful name to help you uniquely identify the app.\n4. In the **Platform App ID** field, paste the **Integration Key** that you copied from Carnival\n5. Set the **Environment** for the app — whether the app is considered a Production (prod) or Development (dev) version of your app. This is displayed with the app on the Mobile Apps List in Sailthru and has no technical effect.\n6. In the **Device Type** field, select **Carnival Integration**.\n\n\n### Use Device Criteria in Sailthru Audience Builder\n\nYou can use the **Carnival Mobile User** criteria to segment users in Sailthru. The available criteria are:\n * has a Carnival device\n * does not have a Carnival device\n\nOr, use any user criteria to create a Smart List. Then, in Carnival, you’ll be able to target the subset of users who exist in both systems and are also part of that Smart List.\n\n#### Manually Sync All Lists\n\nAll of your lists sync with Carnival nightly, but you can also initiate a manual list sync at any time, to ensure that the latest list memberships are reflected in your Carnival account.\n\n1. Go to the Sailthru Lists page.\n2. Next to any list you wish to sync with Carnival, click the Cloud Export icon.\n3. Select Carnival, then click Export your lists to Carnival.\n\n### Use Sailthru Lists in Carnival\nSailthru Lists will appear in Carnival Audience Builder. You can select one or more lists to create a mobile audience.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/b95ac05-Screen_Shot_2017-05-10_at_11.40.12_AM.png\",\n        \"Screen Shot 2017-05-10 at 11.40.12 AM.png\",\n        1199,\n        633,\n        \"#e0e7ef\"\n      ]\n    }\n  ]\n}\n[/block]\n1. Go to the **Audiences** menu.\n2. Click **Create Audience**.\n3. In the left criteria listing, under **Sailthru**, select **Lists**.\n4. All Sailthru lists that have at least one Carnival user are available, with the top 10 in terms of membership size listed by default.If needed, enter part of a list name to filter and locate a list.\n5. Select one or more lists.\n6. Under **Active Filters**, choose whether each user you want to select “IS” or “IS NOT” on each list. Enter an **Audience Name** and click **Save**.","excerpt":"","slug":"sailthru-integration","type":"basic","title":"Sailthru Integration"}

Sailthru Integration


Carnival is Sailthru's mobile product. You can sync and match users across email and mobile by using a shared email identifier. You can use Sailthru Natural Lists and Smart Lists to target users in your Carnival app, and you can identify and target shared Carnival users via Sailthru’s Audience Builder. With the ability to find and target customers across email and mobile, you can now give people a more seamless, coordinated experience. For example, you can reach out by sending offers to your mobile app users who just signed up for your daily newsletter, or finding mobile customers who did not open your email re-engagement campaign and retarget them through your app. If you use Prediction Manager, you can even expand your targeting criteria to include users with high likelihood to opt out, so you can suppress these users and send them an in-app message or a push notification instead. This will enable you to: - Create a Smart List with the criteria available in the Sailthru portal - Suppress those users from an email campaign - Retarget the same list with in-app message as soon as they open the app, or a push notification if their app is closed, or both. ## How it Works - Multiple Carnival applications can be linked to a Sailthru account. - Shared users are identified and updated in real time, whenever email addresses match across both systems. - Each night, all Sailthru lists’ memberships are updated in Carnival. Using Carnival’s Audiences tool, you can then include users from any list. [block:callout] { "type": "success", "body": "You can also manually initiate an update by starting a resync from the Sailthru portal.", "title": "Update anytime" } [/block] ## Setup Email is used as the connecting identifier between users in Sailthru and devices in Carnival. Check in with your Customer Success Manager or with your app developer to make sure you are already collecting an Email ID. You can find technical details on how to collect a shared identifier in our [Collecting User Data](http://docs.carnival.io/docs/collecting-user-data#setting-a-user-email) guide. Now that you are identifying shared users, you can enable data sharing between Carnival and Sailthru via the following one-time setup. Your Customer Success Manager can set this up for you. Perform the following actions in Carnival: 1. Go to **Settings** -> **Developer** 2. On the top navigation bar, select **Integrations** 3. Copy the **Sailthru Integration Key** Perform the following actions in My Sailthru: 1. Click the gear to get settings. 2. In the left navigation menu, select **Channels** -> **Mobile Apps** 3. Enter the **App Name** used in Carnival. You can use any custom meaningful name to help you uniquely identify the app. 4. In the **Platform App ID** field, paste the **Integration Key** that you copied from Carnival 5. Set the **Environment** for the app — whether the app is considered a Production (prod) or Development (dev) version of your app. This is displayed with the app on the Mobile Apps List in Sailthru and has no technical effect. 6. In the **Device Type** field, select **Carnival Integration**. ### Use Device Criteria in Sailthru Audience Builder You can use the **Carnival Mobile User** criteria to segment users in Sailthru. The available criteria are: * has a Carnival device * does not have a Carnival device Or, use any user criteria to create a Smart List. Then, in Carnival, you’ll be able to target the subset of users who exist in both systems and are also part of that Smart List. #### Manually Sync All Lists All of your lists sync with Carnival nightly, but you can also initiate a manual list sync at any time, to ensure that the latest list memberships are reflected in your Carnival account. 1. Go to the Sailthru Lists page. 2. Next to any list you wish to sync with Carnival, click the Cloud Export icon. 3. Select Carnival, then click Export your lists to Carnival. ### Use Sailthru Lists in Carnival Sailthru Lists will appear in Carnival Audience Builder. You can select one or more lists to create a mobile audience. [block:image] { "images": [ { "image": [ "https://files.readme.io/b95ac05-Screen_Shot_2017-05-10_at_11.40.12_AM.png", "Screen Shot 2017-05-10 at 11.40.12 AM.png", 1199, 633, "#e0e7ef" ] } ] } [/block] 1. Go to the **Audiences** menu. 2. Click **Create Audience**. 3. In the left criteria listing, under **Sailthru**, select **Lists**. 4. All Sailthru lists that have at least one Carnival user are available, with the top 10 in terms of membership size listed by default.If needed, enter part of a list name to filter and locate a list. 5. Select one or more lists. 6. Under **Active Filters**, choose whether each user you want to select “IS” or “IS NOT” on each list. Enter an **Audience Name** and click **Save**.