{"_id":"57ea7d95802e4a170091819d","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"},"project":"54aa7f773b56130b0056c86e","user":"54aa7f3f9bb00c0b00cb899b","__v":1,"parentDoc":null,"githubsync":"","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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-09-27T14:09:25.278Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Please note that sending Rich Media to iOS users will only work for SDK 2.9.1 and above.\"\n}\n[/block]\nPulsate allows you to add Rich Media to your push notifications. Users can access these Media Attachments on iOS by using force touch or sliding the notification to the left and pressing the View button. On Android, users can pull down on the notification to see a media attachment. \n\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Media Attachment Compatability\",\n  \"body\": \"Please note that Media Attachments are only compatible with Apple devices running iOS 10 and above. Android devices running 4.1 and above are able to display an image as an push notification extension but Android does not support video, audio or gifs. For the best result use images with a 2:1 ratio, Android will crop images that are not 2:1.\\n\\nIf a user who receives a rich media notification and is not on a compatible device, they will receive the push notification without the media attachment.\"\n}\n[/block]\nThe following Rich Media can be sent as a push notification media attachment: \n\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Supported Formats\",\n    \"0-0\": \"Video Files\",\n    \"h-2\": \"Maximum Size\",\n    \"0-1\": \"MPEG\\nMPEG2 Video\\nMPEG4\\nAVI Movie\",\n    \"0-2\": \"50MB\",\n    \"1-0\": \"Image\",\n    \"1-1\": \"JPEG\\nGIF\\nPNG\",\n    \"1-2\": \"10MB\",\n    \"2-0\": \"Audio\",\n    \"2-1\": \"AIFF\\nWav\\nMP3\\nMPEG4 Audio\",\n    \"2-2\": \"5MB\"\n  },\n  \"cols\": 3,\n  \"rows\": 3\n}\n[/block]\nFor more information on supported file types and file sizes, please see the Apple documentation [here](https://developer.apple.com/reference/usernotifications/unnotificationattachment).\n\nTo send a Media Attachment with your push notification, first turn on the Rich Media widget as you are building the push notification. This will reveal our simple drag and drop builder that allow you to drag any supported media file into your campaign in one simple step. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/177901d-Add_Movie.gif\",\n        \"Add Movie.gif\",\n        2180,\n        1230,\n        \"#f3fafa\"\n      ],\n      \"caption\": \"Add a Media Attachment\"\n    }\n  ]\n}\n[/block]\nWhen the attachment has been uploaded to Pulsate, the phone simulator will update to show you what it will look like for the user when they receive the notification and view the attachment. You can also preview the attachment by pressing the play button on the simulator screen. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c54075a-Play_Movie.gif\",\n        \"Play Movie.gif\",\n        663,\n        760,\n        \"#385643\"\n      ],\n      \"caption\": \"Play Attachment\"\n    }\n  ]\n}\n[/block]\nTo remove a media attachment, click on the X button beside the file name in the drag and drop builder. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5f0ac85-Screenshot_2016-09-27_17.53.31.png\",\n        \"Screenshot 2016-09-27 17.53.31.png\",\n        472,\n        326,\n        \"#ecf2f8\"\n      ],\n      \"caption\": \"Remove Attachment\"\n    }\n  ]\n}\n[/block]\nAs well as dragging and dropping media attachments, you can also add a URL that links directly to where the file is hosted. \n\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Media Attachment URLs\",\n  \"body\": \"Please note that the URL must link directly to where the file is hosted and youtube and links to other streaming sites are not compatible.\"\n}\n[/block]\nPulsate also allows you to search for GIFs that can be automatically added to your push notification as a media attachment. To search for  GIF, click on the Search for a GIF text field and type out the term that you would like to search for. Pulsate uses GIPHY to return a selection of GIFs based on your search term and you can choose the most suitable GIF and it will be automatically added as a media attachment for your push notification. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3d82bbb-Add_GIF.gif\",\n        \"Add GIF.gif\",\n        1672,\n        1159,\n        \"#f3fafa\"\n      ],\n      \"caption\": \"Add GIF\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"push-notifications-rich-media","type":"basic","title":"Push Notifications: Rich Media"}

Push Notifications: Rich Media


[block:callout] { "type": "info", "body": "Please note that sending Rich Media to iOS users will only work for SDK 2.9.1 and above." } [/block] Pulsate allows you to add Rich Media to your push notifications. Users can access these Media Attachments on iOS by using force touch or sliding the notification to the left and pressing the View button. On Android, users can pull down on the notification to see a media attachment. [block:callout] { "type": "info", "title": "Media Attachment Compatability", "body": "Please note that Media Attachments are only compatible with Apple devices running iOS 10 and above. Android devices running 4.1 and above are able to display an image as an push notification extension but Android does not support video, audio or gifs. For the best result use images with a 2:1 ratio, Android will crop images that are not 2:1.\n\nIf a user who receives a rich media notification and is not on a compatible device, they will receive the push notification without the media attachment." } [/block] The following Rich Media can be sent as a push notification media attachment: [block:parameters] { "data": { "h-0": "Name", "h-1": "Supported Formats", "0-0": "Video Files", "h-2": "Maximum Size", "0-1": "MPEG\nMPEG2 Video\nMPEG4\nAVI Movie", "0-2": "50MB", "1-0": "Image", "1-1": "JPEG\nGIF\nPNG", "1-2": "10MB", "2-0": "Audio", "2-1": "AIFF\nWav\nMP3\nMPEG4 Audio", "2-2": "5MB" }, "cols": 3, "rows": 3 } [/block] For more information on supported file types and file sizes, please see the Apple documentation [here](https://developer.apple.com/reference/usernotifications/unnotificationattachment). To send a Media Attachment with your push notification, first turn on the Rich Media widget as you are building the push notification. This will reveal our simple drag and drop builder that allow you to drag any supported media file into your campaign in one simple step. [block:image] { "images": [ { "image": [ "https://files.readme.io/177901d-Add_Movie.gif", "Add Movie.gif", 2180, 1230, "#f3fafa" ], "caption": "Add a Media Attachment" } ] } [/block] When the attachment has been uploaded to Pulsate, the phone simulator will update to show you what it will look like for the user when they receive the notification and view the attachment. You can also preview the attachment by pressing the play button on the simulator screen. [block:image] { "images": [ { "image": [ "https://files.readme.io/c54075a-Play_Movie.gif", "Play Movie.gif", 663, 760, "#385643" ], "caption": "Play Attachment" } ] } [/block] To remove a media attachment, click on the X button beside the file name in the drag and drop builder. [block:image] { "images": [ { "image": [ "https://files.readme.io/5f0ac85-Screenshot_2016-09-27_17.53.31.png", "Screenshot 2016-09-27 17.53.31.png", 472, 326, "#ecf2f8" ], "caption": "Remove Attachment" } ] } [/block] As well as dragging and dropping media attachments, you can also add a URL that links directly to where the file is hosted. [block:callout] { "type": "warning", "title": "Media Attachment URLs", "body": "Please note that the URL must link directly to where the file is hosted and youtube and links to other streaming sites are not compatible." } [/block] Pulsate also allows you to search for GIFs that can be automatically added to your push notification as a media attachment. To search for GIF, click on the Search for a GIF text field and type out the term that you would like to search for. Pulsate uses GIPHY to return a selection of GIFs based on your search term and you can choose the most suitable GIF and it will be automatically added as a media attachment for your push notification. [block:image] { "images": [ { "image": [ "https://files.readme.io/3d82bbb-Add_GIF.gif", "Add GIF.gif", 1672, 1159, "#f3fafa" ], "caption": "Add GIF" } ] } [/block]