{"_id":"57c95290412eb50e0096bd7d","project":"54aa7f773b56130b0056c86e","user":"577cf7765fd4de0e00cc3d50","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":0,"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"},"parentDoc":null,"githubsync":"","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-09-02T10:21:04.775Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":10,"body":"The purpose of this guide is to show you how to use Personalisation Tags with your Pulsate campaigns. To find out what a personalization tag is and how they can help you dynamically personalise your content and insert unique content for each user, please click here.XXX\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"What data can be inserted using Personalisation Tags?\"\n}\n[/block]\npersonalization tags can be used to programatically insert unique pieces of data for each user into the content that you send them. This could be a first or last name of the user that you send us using our guides for [Android](https://pulsate.readme.io/docs/passing-email-address-or-name) or [iOS](https://pulsate.readme.io/docs/passing-user-information-to-pulsate). This is a great way of personalising the content that you send users and increasing your engagement and open rates. \n\nHowever, you can also programatically insert any other custom parameters that you have sent to Pulsate using our guides for [Android](https://pulsate.readme.io/docs/passing-custom-parameters) or [iOS](https://pulsate.readme.io/docs/passing-custom-parameters-to-pulsate). This opens up a world of possibilities and allows you to dynamically insert a range of content into the content that you send with Pulsate. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Where can I insert a Personalization Tag?\"\n}\n[/block]\nPersonalization tags can be inserted in push notifications, in app notifications and within some card fields. The full list of where a personalization Tag can be inserted is: \n\n*Push Notification*\n\n*In-App Notification*\n- Small In App Notification\n- Large In App Notification\n\n*Front of Card*\n- Personal Message\n- Headline\n- Text\n\n*Back of Card*\n- Headline\n- Text\n\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"How do I insert a Personalization Tag?\"\n}\n[/block]\nOnce you have decided what type of campaign that you would like to send, a Personalization tag can be added in just a few clicks. First open the text widget that you would like to insert the personalization tag and you will see a button called `Insert`. Begin by adding the text that you wish to enter and when you want to insert the personalization tag, press `Insert`. \n\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f701f4f-Merge_Tag_3.gif\",\n        \"Merge Tag 3.gif\",\n        468,\n        701,\n        \"#fafafa\"\n      ]\n    }\n  ]\n}\n[/block]\nWhen you click on that button, you will shown a list of available Personalization tags. You can either scroll through the list to find the tag that you want to insert or search for it by entering text into the search box at the top of the list of tags. Once you have found the tag that you want to use, click on it and it will be inserted into the message. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3f407c2-Merge_tag_insert.gif\",\n        \"Merge tag insert.gif\",\n        468,\n        701,\n        \"#485c7a\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Inserting a Fallback Personalization Tag\"\n}\n[/block]\nIt is possible that you will not have a valid tag for every user so Pulsate allows you to insert a Fallback Personalization Tag which will be displayed if there is no value for any user for that tag. By default, Pulsate will leave the space blank if a user has no value for a personalization tag. However, it is a good idea to add a Fallback Personalization tag to ensure that there are no blank spaces when the user receives the content.\n\nTo insert a Fallback Personalization Tag, click on the settings widget on any of the tags that you have entered and follow instructions for entering the fallback value and then press Save.\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d8314c3-Fallback_Merge_Tag_2.gif\",\n        \"Fallback Merge Tag 2.gif\",\n        633,\n        701,\n        \"#f5f8f9\"\n      ]\n    }\n  ]\n}\n[/block]\nIf you wish to edit the Fallback Personalization tag, open the fallback modal again and you can press X on the existing tag and enter a new fallback value.","excerpt":"","slug":"personalisation-tags","type":"basic","title":"Personalization Tags"}

Personalization Tags


The purpose of this guide is to show you how to use Personalisation Tags with your Pulsate campaigns. To find out what a personalization tag is and how they can help you dynamically personalise your content and insert unique content for each user, please click here.XXX [block:api-header] { "type": "basic", "title": "What data can be inserted using Personalisation Tags?" } [/block] personalization tags can be used to programatically insert unique pieces of data for each user into the content that you send them. This could be a first or last name of the user that you send us using our guides for [Android](https://pulsate.readme.io/docs/passing-email-address-or-name) or [iOS](https://pulsate.readme.io/docs/passing-user-information-to-pulsate). This is a great way of personalising the content that you send users and increasing your engagement and open rates. However, you can also programatically insert any other custom parameters that you have sent to Pulsate using our guides for [Android](https://pulsate.readme.io/docs/passing-custom-parameters) or [iOS](https://pulsate.readme.io/docs/passing-custom-parameters-to-pulsate). This opens up a world of possibilities and allows you to dynamically insert a range of content into the content that you send with Pulsate. [block:api-header] { "type": "basic", "title": "Where can I insert a Personalization Tag?" } [/block] Personalization tags can be inserted in push notifications, in app notifications and within some card fields. The full list of where a personalization Tag can be inserted is: *Push Notification* *In-App Notification* - Small In App Notification - Large In App Notification *Front of Card* - Personal Message - Headline - Text *Back of Card* - Headline - Text [block:api-header] { "type": "basic", "title": "How do I insert a Personalization Tag?" } [/block] Once you have decided what type of campaign that you would like to send, a Personalization tag can be added in just a few clicks. First open the text widget that you would like to insert the personalization tag and you will see a button called `Insert`. Begin by adding the text that you wish to enter and when you want to insert the personalization tag, press `Insert`. [block:image] { "images": [ { "image": [ "https://files.readme.io/f701f4f-Merge_Tag_3.gif", "Merge Tag 3.gif", 468, 701, "#fafafa" ] } ] } [/block] When you click on that button, you will shown a list of available Personalization tags. You can either scroll through the list to find the tag that you want to insert or search for it by entering text into the search box at the top of the list of tags. Once you have found the tag that you want to use, click on it and it will be inserted into the message. [block:image] { "images": [ { "image": [ "https://files.readme.io/3f407c2-Merge_tag_insert.gif", "Merge tag insert.gif", 468, 701, "#485c7a" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "Inserting a Fallback Personalization Tag" } [/block] It is possible that you will not have a valid tag for every user so Pulsate allows you to insert a Fallback Personalization Tag which will be displayed if there is no value for any user for that tag. By default, Pulsate will leave the space blank if a user has no value for a personalization tag. However, it is a good idea to add a Fallback Personalization tag to ensure that there are no blank spaces when the user receives the content. To insert a Fallback Personalization Tag, click on the settings widget on any of the tags that you have entered and follow instructions for entering the fallback value and then press Save. [block:image] { "images": [ { "image": [ "https://files.readme.io/d8314c3-Fallback_Merge_Tag_2.gif", "Fallback Merge Tag 2.gif", 633, 701, "#f5f8f9" ] } ] } [/block] If you wish to edit the Fallback Personalization tag, open the fallback modal again and you can press X on the existing tag and enter a new fallback value.