{"_id":"576a656d6f15260e001f8991","category":{"_id":"576a656c6f15260e001f893a","version":"576a656c6f15260e001f8938","__v":0,"project":"54aa7f773b56130b0056c86e","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-01-05T12:25:25.590Z","from_sync":false,"order":3,"slug":"working-with-pulsate","title":"Working with Pulsate"},"user":"54aa7f3f9bb00c0b00cb899b","version":{"_id":"576a656c6f15260e001f8938","__v":3,"project":"54aa7f773b56130b0056c86e","createdAt":"2016-06-22T10:16:12.661Z","releaseDate":"2016-06-22T10:16:12.661Z","categories":["576a656c6f15260e001f8939","576a656c6f15260e001f893a","576a656c6f15260e001f893b","576a656c6f15260e001f893c","576a656c6f15260e001f893d","576a656c6f15260e001f893e","576a656c6f15260e001f893f","5797787ce2d8f40e0052b4a6","5b041bc0769904000374c645"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"For Marketers","version_clean":"4.0.0","version":"4.0"},"__v":1,"githubsync":"","parentDoc":null,"project":"54aa7f773b56130b0056c86e","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-09T11:27:56.426Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"What is a Deep link?\",\n  \"body\": \"if you would like to learn what a deeplink is, please go [here](http://product.pulsatehq.com/dive-into-deeplinks)  for our blog post on deep links and how they can help you send great campaigns.\"\n}\n[/block]\nThis guide will walk you through how to add deep links to Pulsate and how to select a deep link when you are sending a campaign. For more information on adding deep links to your iOS and Android app, please see our guides for [Android](https://pulsate.readme.io/docs/supporting-deep-links-1) and [iOS](https://pulsate.readme.io/docs/supporting-deep-links).\n\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Adding Deep Links to Pulsate\"\n}\n[/block]\nBefore you can use deeplinks in a campaign, you have to add the deeplinks for your app to Pulsate. Thankfully, this is a very simple process. First of all, open the Pulsate CMS and navigate to App Settings.\n\n\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/mqsXPbfAQZuAEQrmv9BW_Add%20Deeplink.gif\",\n        \"Add Deeplink.gif\",\n        \"1349\",\n        \"624\",\n        \"#4c5c7c\",\n        \"\"\n      ],\n      \"caption\": \"Open App Settings\"\n    }\n  ]\n}\n[/block]\nTo add a new deep link to Pulsate, you need to add the following: \n\n* Label - A label is like a nickname for your deep link, an easy way to remind you where each deep link will bring users. You can use whatever naming convention you like for deep links. However, most of the time a simple reminder of where this deep link will bring users to is a good idea. Deep link labels must be less than 50 characters so make sure that they are short and concise. When you get around to adding a deeplink to a campaign, you will be selecting it from a list of deep link labels so make sure that whatever label you choose is likely to make sense to every user in your organisation that uses Pulsate. \n\n* Deep link URL - This is the URL address of your deep link. For more info on setting up deep links for your app see our [Android](https://pulsate.readme.io/docs/supporting-deep-links-1) and [iOS](https://pulsate.readme.io/docs/supporting-deep-links) guides.  \n\nOnce you have chosen a label and added a deep link to your app, it is just a case of adding them to Pulsate's deep link manager and pressing Save. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/Yg0uZZLqQ9aBwDBvWnm5_Add%20Deeplink2.gif\",\n        \"Add Deeplink2.gif\",\n        \"1349\",\n        \"624\",\n        \"#4c5c7c\",\n        \"\"\n      ],\n      \"caption\": \"Add Deep Link\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Deeplinks Must Be Unique\",\n  \"body\": \"Please note that all deeplinks must be unique. If they are not unique, multiple apps may have the same deeplink and this can result in the wrong app being opened when a deeplink is triggered. \\n\\nThis means that if you have a test app and a production app in Pulsate, the url scheme for each deeplink will have to be unique. It is also good practice to make all of your deeplinks as non generic as possible.\"\n}\n[/block]\n# Editing Deep Links\n\nOnce a deep link has been added, you can quickly edit or delete that deeplink. \n\nTo edit a deep link, click on the Edit button beside the saved deeplink and you will be able to update the text of the deep link or URL. When you are finished editing, press Save to confirm your changes. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d44T5x3ZRd6nAYNI9YG2_Edit%20Deeplink.gif\",\n        \"Edit Deeplink.gif\",\n        \"1349\",\n        \"624\",\n        \"\",\n        \"\"\n      ],\n      \"caption\": \"Edit Deep Link\"\n    }\n  ]\n}\n[/block]\nTo delete an existing deep link, click on the Delete button and confirm that you wish to delete that deep link. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/xnbSv0ESUmkyVCRbnFi3_Delete%20Deeplink.gif\",\n        \"Delete Deeplink.gif\",\n        \"1349\",\n        \"624\",\n        \"#4c5c7c\",\n        \"\"\n      ],\n      \"caption\": \"Delete Deep Link\"\n    }\n  ]\n}\n[/block]\nIf you have existing deep links that were added before this update, they will be imported automatically into this deep link manager with the label left blank so that you can fill in your own deep link by following the above instructions for editing.\n\n# Choosing a Deep Link\n\nOnce you have added all of your deep links, you can select them in any campaigns that you wish to send. Deep links can be selected as the Call to Action button destination for the front or back of a card. \n\nWhen you are building a campaign, open the Call to Action widget on the front or back of the card and select Deep Links. You can then choose the deep link that you wish to select from the dropdown. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/bCKe7XxTVyeP3W6rYp2g_Select%20Deeplink.gif\",\n        \"Select Deeplink.gif\",\n        \"1349\",\n        \"624\",\n        \"#4b5a79\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"using-deeplinks","type":"basic","title":"Using Deep Links"}
[block:callout] { "type": "info", "title": "What is a Deep link?", "body": "if you would like to learn what a deeplink is, please go [here](http://product.pulsatehq.com/dive-into-deeplinks) for our blog post on deep links and how they can help you send great campaigns." } [/block] This guide will walk you through how to add deep links to Pulsate and how to select a deep link when you are sending a campaign. For more information on adding deep links to your iOS and Android app, please see our guides for [Android](https://pulsate.readme.io/docs/supporting-deep-links-1) and [iOS](https://pulsate.readme.io/docs/supporting-deep-links). [block:api-header] { "type": "basic", "title": "Adding Deep Links to Pulsate" } [/block] Before you can use deeplinks in a campaign, you have to add the deeplinks for your app to Pulsate. Thankfully, this is a very simple process. First of all, open the Pulsate CMS and navigate to App Settings. [block:image] { "images": [ { "image": [ "https://files.readme.io/mqsXPbfAQZuAEQrmv9BW_Add%20Deeplink.gif", "Add Deeplink.gif", "1349", "624", "#4c5c7c", "" ], "caption": "Open App Settings" } ] } [/block] To add a new deep link to Pulsate, you need to add the following: * Label - A label is like a nickname for your deep link, an easy way to remind you where each deep link will bring users. You can use whatever naming convention you like for deep links. However, most of the time a simple reminder of where this deep link will bring users to is a good idea. Deep link labels must be less than 50 characters so make sure that they are short and concise. When you get around to adding a deeplink to a campaign, you will be selecting it from a list of deep link labels so make sure that whatever label you choose is likely to make sense to every user in your organisation that uses Pulsate. * Deep link URL - This is the URL address of your deep link. For more info on setting up deep links for your app see our [Android](https://pulsate.readme.io/docs/supporting-deep-links-1) and [iOS](https://pulsate.readme.io/docs/supporting-deep-links) guides. Once you have chosen a label and added a deep link to your app, it is just a case of adding them to Pulsate's deep link manager and pressing Save. [block:image] { "images": [ { "image": [ "https://files.readme.io/Yg0uZZLqQ9aBwDBvWnm5_Add%20Deeplink2.gif", "Add Deeplink2.gif", "1349", "624", "#4c5c7c", "" ], "caption": "Add Deep Link" } ] } [/block] [block:callout] { "type": "warning", "title": "Deeplinks Must Be Unique", "body": "Please note that all deeplinks must be unique. If they are not unique, multiple apps may have the same deeplink and this can result in the wrong app being opened when a deeplink is triggered. \n\nThis means that if you have a test app and a production app in Pulsate, the url scheme for each deeplink will have to be unique. It is also good practice to make all of your deeplinks as non generic as possible." } [/block] # Editing Deep Links Once a deep link has been added, you can quickly edit or delete that deeplink. To edit a deep link, click on the Edit button beside the saved deeplink and you will be able to update the text of the deep link or URL. When you are finished editing, press Save to confirm your changes. [block:image] { "images": [ { "image": [ "https://files.readme.io/d44T5x3ZRd6nAYNI9YG2_Edit%20Deeplink.gif", "Edit Deeplink.gif", "1349", "624", "", "" ], "caption": "Edit Deep Link" } ] } [/block] To delete an existing deep link, click on the Delete button and confirm that you wish to delete that deep link. [block:image] { "images": [ { "image": [ "https://files.readme.io/xnbSv0ESUmkyVCRbnFi3_Delete%20Deeplink.gif", "Delete Deeplink.gif", "1349", "624", "#4c5c7c", "" ], "caption": "Delete Deep Link" } ] } [/block] If you have existing deep links that were added before this update, they will be imported automatically into this deep link manager with the label left blank so that you can fill in your own deep link by following the above instructions for editing. # Choosing a Deep Link Once you have added all of your deep links, you can select them in any campaigns that you wish to send. Deep links can be selected as the Call to Action button destination for the front or back of a card. When you are building a campaign, open the Call to Action widget on the front or back of the card and select Deep Links. You can then choose the deep link that you wish to select from the dropdown. [block:image] { "images": [ { "image": [ "https://files.readme.io/bCKe7XxTVyeP3W6rYp2g_Select%20Deeplink.gif", "Select Deeplink.gif", "1349", "624", "#4b5a79", "" ] } ] } [/block]