{"_id":"576a656d6f15260e001f8989","githubsync":"","project":"54aa7f773b56130b0056c86e","user":"54aa7f3f9bb00c0b00cb899b","parentDoc":null,"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":2,"category":{"_id":"5797787ce2d8f40e0052b4a6","version":"576a656c6f15260e001f8938","project":"54aa7f773b56130b0056c86e","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-07-26T14:49:32.231Z","from_sync":false,"order":2,"slug":"pulsate-campaigns","title":"Pulsate Campaigns"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-11-30T12:26:41.987Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"[block:embed]\n{\n  \"html\": \"<iframe class=\\\"embedly-embed\\\" src=\\\"//cdn.embedly.com/widgets/media.html?url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D0ZuQSXMjKQQ&src=https%3A%2F%2Fwww.youtube.com%2Fembed%2F0ZuQSXMjKQQ%3Ffeature%3Doembed&type=text%2Fhtml&key=02466f963b9b4bb8845a05b53d3235d7&schema=youtube\\\" width=\\\"640\\\" height=\\\"480\\\" scrolling=\\\"no\\\" frameborder=\\\"0\\\" allowfullscreen></iframe>\",\n  \"url\": \"https://www.youtube.com/watch?v=0ZuQSXMjKQQ&feature=youtu.be\",\n  \"title\": \"Creating the card for your campaign in Pulsate\",\n  \"favicon\": \"https://s.ytimg.com/yts/img/favicon-vflz7uhzw.ico\"\n}\n[/block]\n**Mandatory Front of Card Parameters**\n\nOn the front of card, the following parameters are mandatory before a campaign can be sent: \n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"Campaign Name\",\n    \"0-1\": \"Every campaign must be given a name in order to proceed. The naming modal becomes active as soon as a user presses Create Campaign and there are two options: \\n\\n- Enter a name for your campaign and press Save and a campaign with that name will be created and you will be able to begin configuring it. \\n- Press Cancel and you will be taken back to the Campaign List screen and no campaign will be created.\",\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"Description\",\n    \"0-2\": \"On the Front of the Card, one text field (Personal, Headline or Text) must be activated before a campaign can be sent.\",\n    \"1-0\": \"Selected Widget\",\n    \"1-1\": \"At least one widget from the following list must be activated on the front of card:\\n\\n- Personal Message\\n- Image\\n- Headline\\n- Text \\n\\nAny combination of these paramaters can be selected but at least one must be activated on the front of card in order to proceed.\",\n    \"2-0\": \"Call to Action\",\n    \"2-1\": \"At least one of the following Call to Action button destinations must be selected before you can proceed to the next screen: \\n\\n- Card (Back)\\n- Deeplink\\n- URL\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]\n**Front of Card Parameters**\n\n**Personal Message**\n\nThe Personal Message widget allow you to send a card to a user as if it is directly from a member of your company. You can choose any Pulsate admin to send the campaign from and these campaigns work best when they are tailored to a very specific segment of users such as High Value Customers or Lapsed Customers. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/uI78r60RTjWvSMDP4Ht0_Screen%20Shot%202015-11-30%20at%201.08.41%20p.m..png\",\n        \"Screen Shot 2015-11-30 at 1.08.41 p.m..png\",\n        \"369\",\n        \"298\",\n        \"#48587c\",\n        \"\"\n      ],\n      \"caption\": \"Example of a Personal Message\"\n    }\n  ]\n}\n[/block]\nThe following are a list of all of the parameters that can be added to a Personal Message: \n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"Select Admin\",\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-1\": \"You can choose the admin that you wish to send the card from. You can choose any admin that has been added to your account. To add an admin, please select Settings and then Account Settings. \\n\\nIf you have added a photo for the admin, it will also be send within each card that Personal Message is selected to build up personal rapport with the user who is receiving it. \\n\\nIf you choose to send a card with a Personal Message, it is mandatory to select an admin for the Personal Message.\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1GE29UexS4OV2XcoVCrU_Select%20Admin.gif\",\n        \"Select Admin.gif\",\n        \"469\",\n        \"316\",\n        \"#4db2f1\",\n        \"\"\n      ],\n      \"caption\": \"Select Admin\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"Personal Message Text\",\n    \"0-1\": \"There is no limit to the amount of text that you can enter for a Personal Message. However, we advise that the optimum length for a personal message is less than 3 lines of text.\",\n    \"1-0\": \"Select a Merge Tag\",\n    \"1-1\": \"Merge tags insert a piece of data that you have sent us about your users. One example is First Name. \\n\\nIf you have supplied us with the [first name of the user](https://pulsate.readme.io/docs/passing-email-address-or-name), we will can programatically insert it into a message to personalise the experience for the user. In situations where we do not have the user's first name, we will not insert anything so those users will not be aware of the merge tag.\\n\\nAny piece of custom data can be used as a merge tag. In the Personal Message section, you can choose to add the label for the custom tag and we will programatically insert the value that was sent to us for that user. Again, if we do not have that custom tag for the user, we will not insert anything. \\n\\nWhen you click Insert to add a Merge tag, you can scroll through the list of available Merge tags or search directly for them. \\n\\nPlease note that if the value of the Merge Tag is quite long (such as a long first name) if will expand the length of this field for the user when it is inserted.\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"caption\": \"Select Merge Tag\",\n      \"image\": [\n        \"https://files.readme.io/GECg2p5jSOa3mSEGecH8_Select%20Merge%20Tag%202.gif\",\n        \"Select Merge Tag 2.gif\",\n        \"471\",\n        \"601\",\n        \"#925830\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n**Image**\n\nGreat imagery can really improve your card and entice users to really take notice of it and take that next important stop of clicking on one of the Call To Action buttons to find out more. \n\nThis is a list of the parameters that you need to be aware of when you decide to add an image to your card:\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"Image Sizes\",\n    \"0-1\": \"Images must be be a minimum width of 300px\",\n    \"1-0\": \"Image File Size\",\n    \"1-1\": \"The image file must not be more than 10MB\",\n    \"2-0\": \"Supported Image Types\",\n    \"2-1\": \"The following image types are supported by Pulsate: \\n\\nJPEG\\nPNG\",\n    \"3-0\": \"Drag and Drop Image Builder\",\n    \"3-1\": \"To Add an Image you should enable and open the Image Widget by clicking anywhere on the widget and then either drag and drop an image or press Click Here to manually locate the image on your machine. \\n\\nIf you wish to Remove an image that you have uploaded, press *Remove*.\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d6bq0oFvR1qqC2IU4vQR_Add%20Image.gif\",\n        \"Add Image.gif\",\n        \"1495\",\n        \"503\",\n        \"#3a587e\",\n        \"\"\n      ],\n      \"caption\": \"Add/ Remove Image\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"Crop Image\",\n    \"0-1\": \"Pulsate also allows you to crop any image that you upload. To crop an image, select *Crop* and a new modal will appear. \\n\\nYou can then drag the cropping cropper around the image until you are happy with the new dimensions. When the image is satisfactorily cropped, press the *Crop* button. \\n\\nIf you wish to edit the image dimensions or return to the original dimensions, you can follow the same steps. \\n\\nPlease note that you cannot crop an image and\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"caption\": \"Cropping an Image\",\n      \"image\": [\n        \"https://files.readme.io/T7hmMvzAQCyAm4b5OqW8_Crop.gif\",\n        \"Crop.gif\",\n        \"1495\",\n        \"747\",\n        \"\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n**Headline**\n\nThe Headline widget is great for quickly getting a message across to users with bold text. It is much more direct than a Personal Message but also less tailored to individual users and/ or segments. \n\nHeadlines should be short and snappy and only a few words long to make it as striking as possible. You can also add merge tags to the Headline widget by pressing the *Insert* button when you are in the widget. See Personal Message for more information on Merge Tags. \n[block:image]\n{\n  \"images\": [\n    {\n      \"caption\": \"Headline Example\",\n      \"image\": [\n        \"https://files.readme.io/IAiWuYfFTrqdhhmCnhgM_Screen%20Shot%202015-11-30%20at%203.31.02%20p.m..png\",\n        \"Screen Shot 2015-11-30 at 3.31.02 p.m..png\",\n        \"381\",\n        \"432\",\n        \"#785a47\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n**Text**\n\nThe text widget can be used as a standalone widget to outline the message that you are trying to deliver with the camapign card. However, it can also be used in addition to the other widgets (Personal Message, Image and Headline) to add more information to the content within those widgets. It is a great way to add extra information about the campaign you are sending and the copy entered should be short, snappy and informative for the end user. \n\n\nUse the text widget to explain why somebody should be interested in the campaign that you are sending and to offer additional background information for the user. You can also insert merge tags into the text widget to include the user's name or some other piece of custom data. See Personal Message above for more information on merge tags.\n\n\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ygunQUI4TIk8vh9d7f5v_Text%20Widget.gif\",\n        \"Text Widget.gif\",\n        \"1219\",\n        \"703\",\n        \"\",\n        \"\"\n      ],\n      \"caption\": \"Text Example\"\n    }\n  ]\n}\n[/block]\n**Call to Action**\n\nThe front of card call to action widget is mandatory for all campaigns. It allows you to specify a destination for your card and also to specify whether or not you want to allow users to reply to that campaign. Finally, the call to action widget also allows you to setup an In-App event to record which users click on the call to action event that you specify. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7mt0wmPaRzWYxCYIZvQy_Screen%20Shot%202015-12-13%20at%2010.12.03%20a.m..png\",\n        \"Screen Shot 2015-12-13 at 10.12.03 a.m..png\",\n        \"468\",\n        \"476\",\n        \"#9f6c64\",\n        \"\"\n      ],\n      \"caption\": \"Call to o Action widget\"\n    }\n  ]\n}\n[/block]\n**Call to Action Parameters**\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"Campaign Reply\",\n    \"0-1\": \"This checkbox allows you to specify whether or not users can reply to this card. By default this option is checked so user's will be able to reply to the campaign and a Reply button will be added to the bottom of the card along with the other call to action button. \\n\\nWhen a user clicks on that reply button, they will be able to compose a reply to that card either with feedback about the campaign or any questions that they have about it. When a user replies to a card, their message will be available for you in the Messages section of the CMS and the campaign name will be listed so that you know which campaign they are replying to. For more information on Pulsate's messaging functionality, please see [Starting a Conversation](doc:step-3-starting-a-conversation) \\n\\nIf you do not wish to allow a user to reply to this campaign, uncheck this box and the Reply button will be removed from the campaign card.\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/SBnHYWEHSGSo97sAJmc4_Reply.gif\",\n        \"Reply.gif\",\n        \"1235\",\n        \"695\",\n        \"#af562d\",\n        \"\"\n      ],\n      \"caption\": \"Reply Checkbox\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"Button Text\",\n    \"0-1\": \"Every campaign that has a card must have a destination for that card. The destination can be the back of the card, somewhere else within the app or a URL outside the app (more info on these options below). \\n\\nThe Button Text field allows you to specify what text should appear on the Call to Action button. The default text is 'View More' but you can enter any text that you want into this field. \\n\\nHowever, please note that if you have allowed user's to reply to their campaign, any text that you enter into this field that is over 15 characters will truncate. If you have not enabled campaign reply, any text over 33 characters will be truncated.\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/VDcfQf0AQgKX2KMYO315_Button%20Text.gif\",\n        \"Button Text.gif\",\n        \"1235\",\n        \"695\",\n        \"#a34f2f\",\n        \"\"\n      ],\n      \"caption\": \"Button Text\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"Card (Back)\",\n    \"0-1\": \"If you select the Card (Back) option, you will be able to setup the destination of the card to an ancillary card that can provide more information and images for the user. \\n\\nThis option is useful if you have a lot of information that you want to send to the user that will not fit on the front of card alone or if you wish to add a table of information of such as store opening hours. \\n\\nWhen you select the Card (Back) option, another step will be added to the navigation bar at the bottom of the screen and you will be able to design the back of card when you press the Next button. \\n\\nCard (Back) is selected by default in the Call to Action section.\",\n    \"1-0\": \"Deeplink\",\n    \"1-1\": \"Instead of bringing users to an ancillary card, you can bring them to another location within your app that is outside of the Pulsate feed. You will need to first setup a deeplink for the view within your app that you want to route users to and you can find out more information about setting up deeplinks for [iOS](doc:supporting-deep-links) or [Android](doc:supporting-deep-links-1) by following those links. \\n\\nWhen you have setup deeplinks as per the instructions above, you will be able to select them in a dropdown when you select the deeplink call to action option.\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/0ESTyGcFQsGX6LP6Qeud_Deeplink.gif\",\n        \"Deeplink.gif\",\n        \"468\",\n        \"656\",\n        \"\",\n        \"\"\n      ],\n      \"caption\": \"Selecting a deeplink\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"URL\",\n    \"0-1\": \"You can also route the user directly to a web page. When you select the URL call to action option, you will be able to enter a web page and if users click on the call to action button, that web page will open on their mobile devices. \\n\\nPlease note that you have to enter the full URL address so if you wanted to send users to the Pulsate website you should enter *http://www.pulsatehq.com* as the URL and not just *www.pulsatehq.com*\\n\\nFinally, it is important to check that any website that you are directing users to is optimised for mobile devices so that your users have the best possible experience.\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/YkvqeDmQxCERt68lOEfw_URL.gif\",\n        \"URL.gif\",\n        \"468\",\n        \"656\",\n        \"\",\n        \"\"\n      ],\n      \"caption\": \"Adding a URL\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"In-App Events\",\n    \"0-1\": \"An In-App Event is any action that the user takes when they are within your app. Outside of the Pulsate Feed, you can setup In-App Events to record actions that users take. You can setup a campaign to be delivered when the user carries out that action or simply use the information for analytical purposes. \\n\\nFor information on setting up In-App Events outside of the Pulsate Feed, please consult our guides for [iOS](doc:creating-custom-events) and [Android](doc:setting-custom-events).\\n\\nWithin the Pulsate Feed, you can setup an in-app event to record when a user clicks on one of the call to action buttons that were specified above. This allows you to track the conversion rate for your campaign and to find out how many users have clicked on each call to action button. \\n\\nTo add an In-App Event to a call to action item, click on *In-App Event* and a text field will open. You can use this text field to enter the name of the in-app event. When you are naming these in-app events it is best to come up with a set naming protocol or else you will end up with lots of in-app events called did_click_buttonX or something along those lines. \\n\\nIt is useful to include the name of the campaign in the title of the In App Event so that you can quickly reference what campaign the event was recorded from.\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/upyX9eoBS4F8boaaJtqw_In%20App%20Event.gif\",\n        \"In App Event.gif\",\n        \"468\",\n        \"656\",\n        \"#49a6e2\",\n        \"\"\n      ],\n      \"caption\": \"Adding an In App Event\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"sending-a-campaign","type":"basic","title":"Campaign Cards - Front of Card"}

Campaign Cards - Front of Card


[block:embed] { "html": "<iframe class=\"embedly-embed\" src=\"//cdn.embedly.com/widgets/media.html?url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D0ZuQSXMjKQQ&src=https%3A%2F%2Fwww.youtube.com%2Fembed%2F0ZuQSXMjKQQ%3Ffeature%3Doembed&type=text%2Fhtml&key=02466f963b9b4bb8845a05b53d3235d7&schema=youtube\" width=\"640\" height=\"480\" scrolling=\"no\" frameborder=\"0\" allowfullscreen></iframe>", "url": "https://www.youtube.com/watch?v=0ZuQSXMjKQQ&feature=youtu.be", "title": "Creating the card for your campaign in Pulsate", "favicon": "https://s.ytimg.com/yts/img/favicon-vflz7uhzw.ico" } [/block] **Mandatory Front of Card Parameters** On the front of card, the following parameters are mandatory before a campaign can be sent: [block:parameters] { "data": { "0-0": "Campaign Name", "0-1": "Every campaign must be given a name in order to proceed. The naming modal becomes active as soon as a user presses Create Campaign and there are two options: \n\n- Enter a name for your campaign and press Save and a campaign with that name will be created and you will be able to begin configuring it. \n- Press Cancel and you will be taken back to the Campaign List screen and no campaign will be created.", "h-0": "Name", "h-1": "Description", "h-2": "Description", "0-2": "On the Front of the Card, one text field (Personal, Headline or Text) must be activated before a campaign can be sent.", "1-0": "Selected Widget", "1-1": "At least one widget from the following list must be activated on the front of card:\n\n- Personal Message\n- Image\n- Headline\n- Text \n\nAny combination of these paramaters can be selected but at least one must be activated on the front of card in order to proceed.", "2-0": "Call to Action", "2-1": "At least one of the following Call to Action button destinations must be selected before you can proceed to the next screen: \n\n- Card (Back)\n- Deeplink\n- URL" }, "cols": 2, "rows": 3 } [/block] **Front of Card Parameters** **Personal Message** The Personal Message widget allow you to send a card to a user as if it is directly from a member of your company. You can choose any Pulsate admin to send the campaign from and these campaigns work best when they are tailored to a very specific segment of users such as High Value Customers or Lapsed Customers. [block:image] { "images": [ { "image": [ "https://files.readme.io/uI78r60RTjWvSMDP4Ht0_Screen%20Shot%202015-11-30%20at%201.08.41%20p.m..png", "Screen Shot 2015-11-30 at 1.08.41 p.m..png", "369", "298", "#48587c", "" ], "caption": "Example of a Personal Message" } ] } [/block] The following are a list of all of the parameters that can be added to a Personal Message: [block:parameters] { "data": { "0-0": "Select Admin", "h-0": "Name", "h-1": "Description", "0-1": "You can choose the admin that you wish to send the card from. You can choose any admin that has been added to your account. To add an admin, please select Settings and then Account Settings. \n\nIf you have added a photo for the admin, it will also be send within each card that Personal Message is selected to build up personal rapport with the user who is receiving it. \n\nIf you choose to send a card with a Personal Message, it is mandatory to select an admin for the Personal Message." }, "cols": 2, "rows": 1 } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/1GE29UexS4OV2XcoVCrU_Select%20Admin.gif", "Select Admin.gif", "469", "316", "#4db2f1", "" ], "caption": "Select Admin" } ] } [/block] [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "0-0": "Personal Message Text", "0-1": "There is no limit to the amount of text that you can enter for a Personal Message. However, we advise that the optimum length for a personal message is less than 3 lines of text.", "1-0": "Select a Merge Tag", "1-1": "Merge tags insert a piece of data that you have sent us about your users. One example is First Name. \n\nIf you have supplied us with the [first name of the user](https://pulsate.readme.io/docs/passing-email-address-or-name), we will can programatically insert it into a message to personalise the experience for the user. In situations where we do not have the user's first name, we will not insert anything so those users will not be aware of the merge tag.\n\nAny piece of custom data can be used as a merge tag. In the Personal Message section, you can choose to add the label for the custom tag and we will programatically insert the value that was sent to us for that user. Again, if we do not have that custom tag for the user, we will not insert anything. \n\nWhen you click Insert to add a Merge tag, you can scroll through the list of available Merge tags or search directly for them. \n\nPlease note that if the value of the Merge Tag is quite long (such as a long first name) if will expand the length of this field for the user when it is inserted." }, "cols": 2, "rows": 2 } [/block] [block:image] { "images": [ { "caption": "Select Merge Tag", "image": [ "https://files.readme.io/GECg2p5jSOa3mSEGecH8_Select%20Merge%20Tag%202.gif", "Select Merge Tag 2.gif", "471", "601", "#925830", "" ] } ] } [/block] **Image** Great imagery can really improve your card and entice users to really take notice of it and take that next important stop of clicking on one of the Call To Action buttons to find out more. This is a list of the parameters that you need to be aware of when you decide to add an image to your card: [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "0-0": "Image Sizes", "0-1": "Images must be be a minimum width of 300px", "1-0": "Image File Size", "1-1": "The image file must not be more than 10MB", "2-0": "Supported Image Types", "2-1": "The following image types are supported by Pulsate: \n\nJPEG\nPNG", "3-0": "Drag and Drop Image Builder", "3-1": "To Add an Image you should enable and open the Image Widget by clicking anywhere on the widget and then either drag and drop an image or press Click Here to manually locate the image on your machine. \n\nIf you wish to Remove an image that you have uploaded, press *Remove*." }, "cols": 2, "rows": 4 } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/d6bq0oFvR1qqC2IU4vQR_Add%20Image.gif", "Add Image.gif", "1495", "503", "#3a587e", "" ], "caption": "Add/ Remove Image" } ] } [/block] [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "0-0": "Crop Image", "0-1": "Pulsate also allows you to crop any image that you upload. To crop an image, select *Crop* and a new modal will appear. \n\nYou can then drag the cropping cropper around the image until you are happy with the new dimensions. When the image is satisfactorily cropped, press the *Crop* button. \n\nIf you wish to edit the image dimensions or return to the original dimensions, you can follow the same steps. \n\nPlease note that you cannot crop an image and" }, "cols": 2, "rows": 1 } [/block] [block:image] { "images": [ { "caption": "Cropping an Image", "image": [ "https://files.readme.io/T7hmMvzAQCyAm4b5OqW8_Crop.gif", "Crop.gif", "1495", "747", "", "" ] } ] } [/block] **Headline** The Headline widget is great for quickly getting a message across to users with bold text. It is much more direct than a Personal Message but also less tailored to individual users and/ or segments. Headlines should be short and snappy and only a few words long to make it as striking as possible. You can also add merge tags to the Headline widget by pressing the *Insert* button when you are in the widget. See Personal Message for more information on Merge Tags. [block:image] { "images": [ { "caption": "Headline Example", "image": [ "https://files.readme.io/IAiWuYfFTrqdhhmCnhgM_Screen%20Shot%202015-11-30%20at%203.31.02%20p.m..png", "Screen Shot 2015-11-30 at 3.31.02 p.m..png", "381", "432", "#785a47", "" ] } ] } [/block] **Text** The text widget can be used as a standalone widget to outline the message that you are trying to deliver with the camapign card. However, it can also be used in addition to the other widgets (Personal Message, Image and Headline) to add more information to the content within those widgets. It is a great way to add extra information about the campaign you are sending and the copy entered should be short, snappy and informative for the end user. Use the text widget to explain why somebody should be interested in the campaign that you are sending and to offer additional background information for the user. You can also insert merge tags into the text widget to include the user's name or some other piece of custom data. See Personal Message above for more information on merge tags. [block:image] { "images": [ { "image": [ "https://files.readme.io/ygunQUI4TIk8vh9d7f5v_Text%20Widget.gif", "Text Widget.gif", "1219", "703", "", "" ], "caption": "Text Example" } ] } [/block] **Call to Action** The front of card call to action widget is mandatory for all campaigns. It allows you to specify a destination for your card and also to specify whether or not you want to allow users to reply to that campaign. Finally, the call to action widget also allows you to setup an In-App event to record which users click on the call to action event that you specify. [block:image] { "images": [ { "image": [ "https://files.readme.io/7mt0wmPaRzWYxCYIZvQy_Screen%20Shot%202015-12-13%20at%2010.12.03%20a.m..png", "Screen Shot 2015-12-13 at 10.12.03 a.m..png", "468", "476", "#9f6c64", "" ], "caption": "Call to o Action widget" } ] } [/block] **Call to Action Parameters** [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "0-0": "Campaign Reply", "0-1": "This checkbox allows you to specify whether or not users can reply to this card. By default this option is checked so user's will be able to reply to the campaign and a Reply button will be added to the bottom of the card along with the other call to action button. \n\nWhen a user clicks on that reply button, they will be able to compose a reply to that card either with feedback about the campaign or any questions that they have about it. When a user replies to a card, their message will be available for you in the Messages section of the CMS and the campaign name will be listed so that you know which campaign they are replying to. For more information on Pulsate's messaging functionality, please see [Starting a Conversation](doc:step-3-starting-a-conversation) \n\nIf you do not wish to allow a user to reply to this campaign, uncheck this box and the Reply button will be removed from the campaign card." }, "cols": 2, "rows": 1 } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/SBnHYWEHSGSo97sAJmc4_Reply.gif", "Reply.gif", "1235", "695", "#af562d", "" ], "caption": "Reply Checkbox" } ] } [/block] [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "0-0": "Button Text", "0-1": "Every campaign that has a card must have a destination for that card. The destination can be the back of the card, somewhere else within the app or a URL outside the app (more info on these options below). \n\nThe Button Text field allows you to specify what text should appear on the Call to Action button. The default text is 'View More' but you can enter any text that you want into this field. \n\nHowever, please note that if you have allowed user's to reply to their campaign, any text that you enter into this field that is over 15 characters will truncate. If you have not enabled campaign reply, any text over 33 characters will be truncated." }, "cols": 2, "rows": 1 } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/VDcfQf0AQgKX2KMYO315_Button%20Text.gif", "Button Text.gif", "1235", "695", "#a34f2f", "" ], "caption": "Button Text" } ] } [/block] [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "0-0": "Card (Back)", "0-1": "If you select the Card (Back) option, you will be able to setup the destination of the card to an ancillary card that can provide more information and images for the user. \n\nThis option is useful if you have a lot of information that you want to send to the user that will not fit on the front of card alone or if you wish to add a table of information of such as store opening hours. \n\nWhen you select the Card (Back) option, another step will be added to the navigation bar at the bottom of the screen and you will be able to design the back of card when you press the Next button. \n\nCard (Back) is selected by default in the Call to Action section.", "1-0": "Deeplink", "1-1": "Instead of bringing users to an ancillary card, you can bring them to another location within your app that is outside of the Pulsate feed. You will need to first setup a deeplink for the view within your app that you want to route users to and you can find out more information about setting up deeplinks for [iOS](doc:supporting-deep-links) or [Android](doc:supporting-deep-links-1) by following those links. \n\nWhen you have setup deeplinks as per the instructions above, you will be able to select them in a dropdown when you select the deeplink call to action option." }, "cols": 2, "rows": 2 } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/0ESTyGcFQsGX6LP6Qeud_Deeplink.gif", "Deeplink.gif", "468", "656", "", "" ], "caption": "Selecting a deeplink" } ] } [/block] [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "0-0": "URL", "0-1": "You can also route the user directly to a web page. When you select the URL call to action option, you will be able to enter a web page and if users click on the call to action button, that web page will open on their mobile devices. \n\nPlease note that you have to enter the full URL address so if you wanted to send users to the Pulsate website you should enter *http://www.pulsatehq.com* as the URL and not just *www.pulsatehq.com*\n\nFinally, it is important to check that any website that you are directing users to is optimised for mobile devices so that your users have the best possible experience." }, "cols": 2, "rows": 1 } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/YkvqeDmQxCERt68lOEfw_URL.gif", "URL.gif", "468", "656", "", "" ], "caption": "Adding a URL" } ] } [/block] [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "0-0": "In-App Events", "0-1": "An In-App Event is any action that the user takes when they are within your app. Outside of the Pulsate Feed, you can setup In-App Events to record actions that users take. You can setup a campaign to be delivered when the user carries out that action or simply use the information for analytical purposes. \n\nFor information on setting up In-App Events outside of the Pulsate Feed, please consult our guides for [iOS](doc:creating-custom-events) and [Android](doc:setting-custom-events).\n\nWithin the Pulsate Feed, you can setup an in-app event to record when a user clicks on one of the call to action buttons that were specified above. This allows you to track the conversion rate for your campaign and to find out how many users have clicked on each call to action button. \n\nTo add an In-App Event to a call to action item, click on *In-App Event* and a text field will open. You can use this text field to enter the name of the in-app event. When you are naming these in-app events it is best to come up with a set naming protocol or else you will end up with lots of in-app events called did_click_buttonX or something along those lines. \n\nIt is useful to include the name of the campaign in the title of the In App Event so that you can quickly reference what campaign the event was recorded from." }, "cols": 2, "rows": 1 } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/upyX9eoBS4F8boaaJtqw_In%20App%20Event.gif", "In App Event.gif", "468", "656", "#49a6e2", "" ], "caption": "Adding an In App Event" } ] } [/block]