{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Beacons","type":"basic","slug":"beacons-1","excerpt":"A beacon management tool","body":"**What is a beacon?**\n\n A beacon is a simple device that transmits a Bluetooth signal. The Bluetooth signal typically includes the following data: \n*Major\n*Minor\n*UUID\n\n\n\n\nMobile devices can monitor for beacons, and this allows us to track various metrics, including customer footfall and visit frequency. Users within a beacon zone can also be sent individually targeted marketing communications based on their location. These are much more granular than geofences which can only send content to users when they are within 100m of a location. \n\nBeacons, on the other hand, can target users within a couple of metres or less of a specified location. \n\n**What type of beacons does Pulsate support?**\n\niBeacon is the most stable and widely used beacon protocol and it is fully compatible with both iOS and Android devices. Pulsate is compatible with and supports all beacons that follow [iBeacon protocol](https://developer.apple.com/ibeacon/). \n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Please note!\",\n  \"body\": \"Some manufactures sell beacons with the software. No additional software required to work Beacons on Pulsate.\"\n}\n[/block]\n**Adding a beacon to your Pulsate account using CSV file**\n\nTo add a beacon to your Pulsate account click the ‘Add Beacon’ button. This gives you the option to upload a.CSV file or add a beacon manually. Click 'Upload .CSV File'. The file should include the Beacon ID, Nickname, Major, Minor and UUID. Select a file and upload it. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/6c18a6a-Screenshot_2020-07-17_at_11.18.05.png\",\n        \"Screenshot 2020-07-17 at 11.18.05.png\",\n        1182,\n        532,\n        \"#3c3c3c\"\n      ]\n    }\n  ]\n}\n[/block]\n**Adding beacons manually:**\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3f6416e-adding_beacon.gif\",\n        \"adding beacon.gif\",\n        600,\n        262,\n        \"#f2f3fa\"\n      ]\n    }\n  ]\n}\n[/block]\nClick 'Add Manually' and fill out the following fields for each beacon: \n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Parameter Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"Beacon Nickname\",\n    \"0-1\": \"A custom Pulsate identifier for each beacon that is typically the location of the beacon\",\n    \"1-0\": \"Beacon ID\",\n    \"1-1\": \"A custom Pulsate identifier for each beacon that is typically a unique identifier for the beacon added by Pulsate clients\",\n    \"2-0\": \"Major\",\n    \"3-0\": \"Minor\",\n    \"4-0\": \"UUID\",\n    \"4-1\": \"A unique identifier for each beacon, provided by the manufacturer.\",\n    \"2-1\": \"A custom identifier that is typically used to determine the macro-location of the beacon (ie \\nwhich store in a retail use case)\",\n    \"3-1\": \"A custom identifier that is typically used to determine the micro-location of the beacon \\n(ie where the beacon is located within the store for a retail use case)\"\n  },\n  \"cols\": 2,\n  \"rows\": 5\n}\n[/block]\nWhen all of the fields have been filled in click 'Save' to add the beacon to Pulsate. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ba1bc9f-mUrgFtTxTMWDlsRNXbwi_Screen_Shot_2016-06-22_at_11.58.26.png\",\n        \"mUrgFtTxTMWDlsRNXbwi_Screen Shot 2016-06-22 at 11.58.26.png\",\n        985,\n        423,\n        \"#7a7a7a\"\n      ]\n    }\n  ]\n}\n[/block]\n\n**How to edit a beacon?**\n\nHover over the edit button of the beacon you wish to edit and from the drop-down menu select 'Edit Beacon’. A new modal window will open with the current parameters. Edit and save.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3e2dc9d-edit_beacons.gif\",\n        \"edit beacons.gif\",\n        600,\n        328,\n        \"#f2f2fa\"\n      ]\n    }\n  ]\n}\n[/block]\n**How to delete a beacon?** \n\n    To delete multiple beacons, click all checkboxes on the left-hand side of the beacons you wish to delete. The dotted button will appear in the navigation bar, click on it. From the drop-dow menu select 'Delete beacons'. You will be asked to confirm if you would still like to remove them. If so, choose 'Delete'. If not click 'Cancel'. All selected beacons will be deleted. \n\n   To delete single beacon, hover over the beacon with the mouse. An 'Edit' drop-down button will appear.\nSelect 'Delete'. A confirmation window will appear and you will be asked to confirm if you would still like to remove it. If so, choose 'Delete'. If not click 'Cancel'.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d094b60-deleate_beacon.gif\",\n        \"deleate beacon.gif\",\n        600,\n        328,\n        \"#f2f2fa\"\n      ]\n    }\n  ]\n}\n[/block]\n**Check the status**\n\nSometimes beacons run out of battery or need to be replaced for a host of reasons. To help identify when a beacon might need to be checked, Pulsate operates a traffic light system. If Pulsate has received an event for the beacon within the last week, a green traffic light symbol will be visible for that beacon. If no event has been received for a beacon within the last two weeks, that symbol will be changed to amber and if no event has been recorded for a beacon for over two weeks the traffic light symbol will change to red. \n\nIt is good to keep an eye on the status of individual beacons and to proactively check any beacons that have an amber or red traffic light symbol. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/203b2ce-Screenshot_2020-07-22_at_14.00.51.png\",\n        \"Screenshot 2020-07-22 at 14.00.51.png\",\n        2328,\n        808,\n        \"#eaeff1\"\n      ]\n    }\n  ]\n}\n[/block]\n**Exporting beacon data**\n\nPulsate has a number of different methods for exporting beacon data to help you measure footfall and visitor frequency. To export beacon data from the Pulsate CMS, go to the beacon section and click 'Export All'\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2794c0f-Export_beacons.gif\",\n        \"Export beacons.gif\",\n        600,\n        328,\n        \"#f2f2fa\"\n      ]\n    }\n  ]\n}\n[/block]\nYou will be prompted to choose a timeframe for the beacon export (the default period is 1 month), then select 'Export'. Pulsate will compile the necessary data and send an email to the admin who is currently logged in with a csv attachment that includes all of the beacon events for the time period that was specified. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/423bcce-Beacon_-_Export_started.png\",\n        \"Beacon - Export started.png\",\n        282,\n        111,\n        \"#d9ebf2\"\n      ]\n    }\n  ]\n}\n[/block]\nIn addition, Pulsate can also automatically send any recorded beacon events to a URL of your choice via webhook. When a 'Beacon enter' or 'Beacon exit' event has been recorded by Pulsate, it will be automatically sent to the specified webhook. To enable this feature, click 'Settings', then 'App Settings' in Pulsate and scroll down to the Webhooks section. \n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4ae12b4-Webhooks__Save.png\",\n        \"Webhooks & Save.png\",\n        1147,\n        428,\n        \"#e6e6e5\"\n      ]\n    }\n  ]\n}\n[/block]\nSwitch the toggle to ON and then enter a URL where you would like Pulsate to send beacon events. \nThen scroll down to the bottom of the App Settings page and press Save.\n\n**Beacon Impressions**\n\nEach time a user's phone detects the beacon it is counted as one beacon impression.\n\nIf a campaign is set to trigger on that impression, the campaign will send however an impression may not trigger a campaign if no campaign is setup for that beacon. \n\nThe beacon impression totals is a count of all devices which were detected by that beacon over time. If a users device exits the beacon and enters again, this will be recorded as another beacon impression.","updates":[],"order":4,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5f58c9ac42683f019c302b1a","createdAt":"2020-08-31T13:35:56.549Z","user":"54aa7f3f9bb00c0b00cb899b","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Targeting","slug":"engage","order":2,"from_sync":false,"reference":false,"_id":"5f58c9ac42683f019c302abd","createdAt":"2020-08-19T12:18:32.061Z","version":"5f58c9ac42683f019c302b1f","project":"54aa7f773b56130b0056c86e","__v":0},"version":{"version":"4.1","version_clean":"4.1.0","codename":"For Marketers","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5f58c9ac42683f019c302ab5","5f58c9ac42683f019c302ab6","576a656c6f15260e001f893b","576a656c6f15260e001f893c","576a656c6f15260e001f893d","5f58c9ac42683f019c302ab7","5f58c9ac42683f019c302ab8","5f58c9ac42683f019c302ab9","5f58c9ac42683f019c302aba","5f0dcc9ac6cae402ffef097e","5f58c9ac42683f019c302abb","5f58c9ac42683f019c302abc","5f58c9ac42683f019c302abd","5f58c9ac42683f019c302abe","5f58c9ac42683f019c302abf","5f58c9ac42683f019c302ac0","5f58c9ac42683f019c302ac1","5f3d2cc209dce706808729bd","5f58c9ac42683f019c302ac2","5f58c9ac42683f019c302ac3","5f58cab1ab8ee10056fe22a7","5f58ebe66e59f30073a5b81a","5f69c35f16803d0065b24502","5f69c36f95979600656d1977"],"_id":"5f58c9ac42683f019c302b1f","createdAt":"2016-06-22T10:16:12.661Z","__v":4,"project":"54aa7f773b56130b0056c86e","releaseDate":"2016-06-22T10:16:12.661Z","forked_from":"576a656c6f15260e001f8938"},"project":"54aa7f773b56130b0056c86e","__v":0,"parentDoc":null}

Beacons

A beacon management tool

**What is a beacon?** A beacon is a simple device that transmits a Bluetooth signal. The Bluetooth signal typically includes the following data: *Major *Minor *UUID Mobile devices can monitor for beacons, and this allows us to track various metrics, including customer footfall and visit frequency. Users within a beacon zone can also be sent individually targeted marketing communications based on their location. These are much more granular than geofences which can only send content to users when they are within 100m of a location. Beacons, on the other hand, can target users within a couple of metres or less of a specified location. **What type of beacons does Pulsate support?** iBeacon is the most stable and widely used beacon protocol and it is fully compatible with both iOS and Android devices. Pulsate is compatible with and supports all beacons that follow [iBeacon protocol](https://developer.apple.com/ibeacon/). [block:callout] { "type": "warning", "title": "Please note!", "body": "Some manufactures sell beacons with the software. No additional software required to work Beacons on Pulsate." } [/block] **Adding a beacon to your Pulsate account using CSV file** To add a beacon to your Pulsate account click the ‘Add Beacon’ button. This gives you the option to upload a.CSV file or add a beacon manually. Click 'Upload .CSV File'. The file should include the Beacon ID, Nickname, Major, Minor and UUID. Select a file and upload it. [block:image] { "images": [ { "image": [ "https://files.readme.io/6c18a6a-Screenshot_2020-07-17_at_11.18.05.png", "Screenshot 2020-07-17 at 11.18.05.png", 1182, 532, "#3c3c3c" ] } ] } [/block] **Adding beacons manually:** [block:image] { "images": [ { "image": [ "https://files.readme.io/3f6416e-adding_beacon.gif", "adding beacon.gif", 600, 262, "#f2f3fa" ] } ] } [/block] Click 'Add Manually' and fill out the following fields for each beacon: [block:parameters] { "data": { "h-0": "Parameter Name", "h-1": "Description", "0-0": "Beacon Nickname", "0-1": "A custom Pulsate identifier for each beacon that is typically the location of the beacon", "1-0": "Beacon ID", "1-1": "A custom Pulsate identifier for each beacon that is typically a unique identifier for the beacon added by Pulsate clients", "2-0": "Major", "3-0": "Minor", "4-0": "UUID", "4-1": "A unique identifier for each beacon, provided by the manufacturer.", "2-1": "A custom identifier that is typically used to determine the macro-location of the beacon (ie \nwhich store in a retail use case)", "3-1": "A custom identifier that is typically used to determine the micro-location of the beacon \n(ie where the beacon is located within the store for a retail use case)" }, "cols": 2, "rows": 5 } [/block] When all of the fields have been filled in click 'Save' to add the beacon to Pulsate. [block:image] { "images": [ { "image": [ "https://files.readme.io/ba1bc9f-mUrgFtTxTMWDlsRNXbwi_Screen_Shot_2016-06-22_at_11.58.26.png", "mUrgFtTxTMWDlsRNXbwi_Screen Shot 2016-06-22 at 11.58.26.png", 985, 423, "#7a7a7a" ] } ] } [/block] **How to edit a beacon?** Hover over the edit button of the beacon you wish to edit and from the drop-down menu select 'Edit Beacon’. A new modal window will open with the current parameters. Edit and save. [block:image] { "images": [ { "image": [ "https://files.readme.io/3e2dc9d-edit_beacons.gif", "edit beacons.gif", 600, 328, "#f2f2fa" ] } ] } [/block] **How to delete a beacon?** To delete multiple beacons, click all checkboxes on the left-hand side of the beacons you wish to delete. The dotted button will appear in the navigation bar, click on it. From the drop-dow menu select 'Delete beacons'. You will be asked to confirm if you would still like to remove them. If so, choose 'Delete'. If not click 'Cancel'. All selected beacons will be deleted. To delete single beacon, hover over the beacon with the mouse. An 'Edit' drop-down button will appear. Select 'Delete'. A confirmation window will appear and you will be asked to confirm if you would still like to remove it. If so, choose 'Delete'. If not click 'Cancel'. [block:image] { "images": [ { "image": [ "https://files.readme.io/d094b60-deleate_beacon.gif", "deleate beacon.gif", 600, 328, "#f2f2fa" ] } ] } [/block] **Check the status** Sometimes beacons run out of battery or need to be replaced for a host of reasons. To help identify when a beacon might need to be checked, Pulsate operates a traffic light system. If Pulsate has received an event for the beacon within the last week, a green traffic light symbol will be visible for that beacon. If no event has been received for a beacon within the last two weeks, that symbol will be changed to amber and if no event has been recorded for a beacon for over two weeks the traffic light symbol will change to red. It is good to keep an eye on the status of individual beacons and to proactively check any beacons that have an amber or red traffic light symbol. [block:image] { "images": [ { "image": [ "https://files.readme.io/203b2ce-Screenshot_2020-07-22_at_14.00.51.png", "Screenshot 2020-07-22 at 14.00.51.png", 2328, 808, "#eaeff1" ] } ] } [/block] **Exporting beacon data** Pulsate has a number of different methods for exporting beacon data to help you measure footfall and visitor frequency. To export beacon data from the Pulsate CMS, go to the beacon section and click 'Export All' [block:image] { "images": [ { "image": [ "https://files.readme.io/2794c0f-Export_beacons.gif", "Export beacons.gif", 600, 328, "#f2f2fa" ] } ] } [/block] You will be prompted to choose a timeframe for the beacon export (the default period is 1 month), then select 'Export'. Pulsate will compile the necessary data and send an email to the admin who is currently logged in with a csv attachment that includes all of the beacon events for the time period that was specified. [block:image] { "images": [ { "image": [ "https://files.readme.io/423bcce-Beacon_-_Export_started.png", "Beacon - Export started.png", 282, 111, "#d9ebf2" ] } ] } [/block] In addition, Pulsate can also automatically send any recorded beacon events to a URL of your choice via webhook. When a 'Beacon enter' or 'Beacon exit' event has been recorded by Pulsate, it will be automatically sent to the specified webhook. To enable this feature, click 'Settings', then 'App Settings' in Pulsate and scroll down to the Webhooks section. [block:image] { "images": [ { "image": [ "https://files.readme.io/4ae12b4-Webhooks__Save.png", "Webhooks & Save.png", 1147, 428, "#e6e6e5" ] } ] } [/block] Switch the toggle to ON and then enter a URL where you would like Pulsate to send beacon events. Then scroll down to the bottom of the App Settings page and press Save. **Beacon Impressions** Each time a user's phone detects the beacon it is counted as one beacon impression. If a campaign is set to trigger on that impression, the campaign will send however an impression may not trigger a campaign if no campaign is setup for that beacon. The beacon impression totals is a count of all devices which were detected by that beacon over time. If a users device exits the beacon and enters again, this will be recorded as another beacon impression.