{"_id":"57ea5183f468b7200047953b","user":"54aa7f3f9bb00c0b00cb899b","__v":0,"githubsync":"","project":"54aa7f773b56130b0056c86e","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"},"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"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-09-27T11:01:23.179Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Please note that sending Action Buttons to iOS users will only work for SDK 2.8.7 and above.\"\n}\n[/block]\nAction buttons allow you to add more options to your push notifications. They allow you to add buttons to your push notification and to add a custom destination for each of those buttons. Users can interact with these action buttons right on their lockscreen so they are a great way of increasing customer engagement. \n\nTo add Action Butttons to your notification, click on the Action Button widget when you are building your push notification. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d73c372-Screenshot_2016-09-27_12.14.52.png\",\n        \"Screenshot 2016-09-27 12.14.52.png\",\n        1440,\n        798,\n        \"#446564\"\n      ],\n      \"caption\": \"Enable Action Button Widget\"\n    }\n  ]\n}\n[/block]\nOnce the widget is switched on, you can click the dropdown and select which category of action buttons that you want to select.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/8bb4ee5-Screenshot_2016-09-27_12.19.18.png\",\n        \"Screenshot 2016-09-27 12.19.18.png\",\n        469,\n        624,\n        \"#f5f8fa\"\n      ],\n      \"caption\": \"Select Action Button Category\"\n    }\n  ]\n}\n[/block]\nThe following categories of Action Buttons are available:\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"1.\",\n    \"0-1\": \"Yes & No\",\n    \"h-0\": \"Number\",\n    \"h-1\": \"Category\",\n    \"2-0\": \"2.\",\n    \"2-1\": \"View More\",\n    \"3-0\": \"3.\",\n    \"3-1\": \"Learn More\",\n    \"4-0\": \"4.\",\n    \"4-1\": \"Buy Now\",\n    \"5-0\": \"6.\",\n    \"5-1\": \"Shop Now\",\n    \"1-0\": \"2.\",\n    \"1-1\": \"Accept & Decline\",\n    \"6-0\": \"7.\",\n    \"6-1\": \"Book Now\"\n  },\n  \"cols\": 2,\n  \"rows\": 7\n}\n[/block]\nMore categories will be added soon so please check back for further updates. When you select an action button, the phone simulator will update to show you what the selection will look like on a user device.\n\n\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/55c5e28-Screenshot_2016-09-27_12.33.05.png\",\n        \"Screenshot 2016-09-27 12.33.05.png\",\n        1440,\n        800,\n        \"#f2f8f8\"\n      ],\n      \"caption\": \"Action Button Simulators\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"iOS Compatability\",\n  \"body\": \"Please note that Action Buttons have been expanded in IOS 10 and you can now add more than two action buttons which was the maximum allowable in iOS 8 and 9. If you select a category of action buttons with more than two buttons, only the two buttons will be displayed for users who are on iOS 8 or 9. \\n\\nThe device simulator allows you to switch between iOS 10 and iOS 9 views so that you can see what will be displayed for each group of users.\"\n}\n[/block]\nOnce you have chosen a category of Action Buttons, you need to decide what should happen when a user clicks on one of those buttons. You can add one of the following custom destinations for each button: \n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"Deeplink\",\n    \"0-1\": \"Deeplinks enable you to link users directly to a specific section or page within your app. If you choose to send a deeplink, you will be presented with a choice of which deeplink to choose. \\n\\nTo find out more about deeplinks and how to upload them to Pulsate, please click [here](doc:using-deeplinks).\",\n    \"1-1\": \"Selecting URL allows you to link users directly to a web page. When you select this option you will be asked to enter a web page in the format of 'https://www.webpage.com'\",\n    \"1-0\": \"URL\",\n    \"2-0\": \"Open App\",\n    \"2-1\": \"Selecting this option will result in your app home page being opened when the user clicks on the action button.\",\n    \"3-0\": \"Dismiss\",\n    \"3-1\": \"If you select Dismiss as the notification destination, the push notification will be removed from the user's lockscreen when they press this Action Button.\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\nAs well as selecting the Notification Destination, you should also add an in app event tag to each of the Action Button destinations so that you can track how many users clicked each Action Button. To add an in app event tag, click on the Record as In-App Event and fill in the name of the in app event that you want to add. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d6c96ed-Clicked_Accept.gif\",\n        \"Clicked Accept.gif\",\n        1440,\n        795,\n        \"#f3f8f8\"\n      ],\n      \"caption\": \"Add In App Event Tag\"\n    }\n  ]\n}\n[/block]\nWhen you have typed out the in app event tag, don't forget to press Enter to save it. Now whenever anyone clicks on this buttton, Pulsate will track it and you can use the segments to group users based on which action buttons they clicked. \n\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"In App Event Tags\",\n  \"body\": \"Remember to add an In App Event tag to every Action Button that you add to your push notification so that you can accurately track which users have clicked each button.\"\n}\n[/block]","excerpt":"","slug":"push-notification-action-buttons","type":"basic","title":"Push Notification: Action Buttons"}

Push Notification: Action Buttons


[block:callout] { "type": "info", "body": "Please note that sending Action Buttons to iOS users will only work for SDK 2.8.7 and above." } [/block] Action buttons allow you to add more options to your push notifications. They allow you to add buttons to your push notification and to add a custom destination for each of those buttons. Users can interact with these action buttons right on their lockscreen so they are a great way of increasing customer engagement. To add Action Butttons to your notification, click on the Action Button widget when you are building your push notification. [block:image] { "images": [ { "image": [ "https://files.readme.io/d73c372-Screenshot_2016-09-27_12.14.52.png", "Screenshot 2016-09-27 12.14.52.png", 1440, 798, "#446564" ], "caption": "Enable Action Button Widget" } ] } [/block] Once the widget is switched on, you can click the dropdown and select which category of action buttons that you want to select. [block:image] { "images": [ { "image": [ "https://files.readme.io/8bb4ee5-Screenshot_2016-09-27_12.19.18.png", "Screenshot 2016-09-27 12.19.18.png", 469, 624, "#f5f8fa" ], "caption": "Select Action Button Category" } ] } [/block] The following categories of Action Buttons are available: [block:parameters] { "data": { "0-0": "1.", "0-1": "Yes & No", "h-0": "Number", "h-1": "Category", "2-0": "2.", "2-1": "View More", "3-0": "3.", "3-1": "Learn More", "4-0": "4.", "4-1": "Buy Now", "5-0": "6.", "5-1": "Shop Now", "1-0": "2.", "1-1": "Accept & Decline", "6-0": "7.", "6-1": "Book Now" }, "cols": 2, "rows": 7 } [/block] More categories will be added soon so please check back for further updates. When you select an action button, the phone simulator will update to show you what the selection will look like on a user device. [block:image] { "images": [ { "image": [ "https://files.readme.io/55c5e28-Screenshot_2016-09-27_12.33.05.png", "Screenshot 2016-09-27 12.33.05.png", 1440, 800, "#f2f8f8" ], "caption": "Action Button Simulators" } ] } [/block] [block:callout] { "type": "info", "title": "iOS Compatability", "body": "Please note that Action Buttons have been expanded in IOS 10 and you can now add more than two action buttons which was the maximum allowable in iOS 8 and 9. If you select a category of action buttons with more than two buttons, only the two buttons will be displayed for users who are on iOS 8 or 9. \n\nThe device simulator allows you to switch between iOS 10 and iOS 9 views so that you can see what will be displayed for each group of users." } [/block] Once you have chosen a category of Action Buttons, you need to decide what should happen when a user clicks on one of those buttons. You can add one of the following custom destinations for each button: [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "0-0": "Deeplink", "0-1": "Deeplinks enable you to link users directly to a specific section or page within your app. If you choose to send a deeplink, you will be presented with a choice of which deeplink to choose. \n\nTo find out more about deeplinks and how to upload them to Pulsate, please click [here](doc:using-deeplinks).", "1-1": "Selecting URL allows you to link users directly to a web page. When you select this option you will be asked to enter a web page in the format of 'https://www.webpage.com'", "1-0": "URL", "2-0": "Open App", "2-1": "Selecting this option will result in your app home page being opened when the user clicks on the action button.", "3-0": "Dismiss", "3-1": "If you select Dismiss as the notification destination, the push notification will be removed from the user's lockscreen when they press this Action Button." }, "cols": 2, "rows": 4 } [/block] As well as selecting the Notification Destination, you should also add an in app event tag to each of the Action Button destinations so that you can track how many users clicked each Action Button. To add an in app event tag, click on the Record as In-App Event and fill in the name of the in app event that you want to add. [block:image] { "images": [ { "image": [ "https://files.readme.io/d6c96ed-Clicked_Accept.gif", "Clicked Accept.gif", 1440, 795, "#f3f8f8" ], "caption": "Add In App Event Tag" } ] } [/block] When you have typed out the in app event tag, don't forget to press Enter to save it. Now whenever anyone clicks on this buttton, Pulsate will track it and you can use the segments to group users based on which action buttons they clicked. [block:callout] { "type": "info", "title": "In App Event Tags", "body": "Remember to add an In App Event tag to every Action Button that you add to your push notification so that you can accurately track which users have clicked each button." } [/block]