{"_id":"584ac992d1ce5b0f00438273","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"},"project":"54aa7f773b56130b0056c86e","user":"577cf7765fd4de0e00cc3d50","__v":0,"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"},"parentDoc":null,"githubsync":"","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-12-09T15:11:14.467Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ad14314-1020_x_1080_1.png\",\n        \"1020 x 1080 (1).png\",\n        1920,\n        1080,\n        \"#70cddd\"\n      ]\n    }\n  ]\n}\n[/block]\nPulsate enables you to track users when they enter or exit a geofence (for more information see our main [Geofences](doc:geofences) documentation) and now we also allow you to target users when they dwell in a geofence for a specified period of time. This gives you much more control over when a user should receive a geofence campaign and helps to eliminate users who may be only passing through the geofence. \n\n**Setting Dwell Time for a Campaign**\n\nTo set a campaign to trigger when the user dwells in that location, first set up the campaign content (push notification, campaign etc) and when you get to the Targeting section, turn on the geofences widget and select the geofence that you wish to target. \n\n\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3fd4246-Geofence_Select.gif\",\n        \"Geofence Select.gif\",\n        1440,\n        693,\n        \"#eefbfb\"\n      ],\n      \"caption\": \"Selecting a Geofence\"\n    }\n  ]\n}\n[/block]\nBy default, all geofences are set to target users when they ender the geofence. To change this, click the Entry dropdown to the right of the geofence that you selected. You will know be able to select whether the geofence is triggered when the user enters or exits the area or when they dwell in that area for a specified amount of time. If you wish the notification to be triggered when after the user dwells in that location, select Dwell Time and fill in how long you want the user to dwell in that location before they receive this campaign. Dwell time is set in minutes, up to a maximum of 60 minutes.\n\n\n\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4ac4901-Set_Dwell_Time.gif\",\n        \"Set Dwell Time.gif\",\n        467,\n        652,\n        \"#42618f\"\n      ],\n      \"caption\": \"Set Dwell Time\"\n    }\n  ]\n}\n[/block]\nWhen you set dwell time, the simulator screen will update and to show you that the campaign is now being triggered when the user spends the amount of time that you specified in the geofence. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/70738c7-Screenshot_2016-12-09_15.34.03.png\",\n        \"Screenshot 2016-12-09 15.34.03.png\",\n        1435,\n        755,\n        \"#f2fafa\"\n      ],\n      \"caption\": \"Dwell Time Set\"\n    }\n  ]\n}\n[/block]\nThe geofence and dwell time that you specified will also be displayed on the campaign Review screen and if you wish to change it, you can press the Edit button in the Targeting block on the Review screen. \n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3bae9f7-Screenshot_2016-12-21_16.40.33.png\",\n        \"Screenshot 2016-12-21 16.40.33.png\",\n        1401,\n        358,\n        \"#f2f9fa\"\n      ],\n      \"caption\": \"Review\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Please note that users may not dwell in great numbers in a geofence region, especially if the geofence area is relatively small. For that reason we recommend that your geofence should be at least 300-400m in size and that you should not set dwell time for more than 15 minutes unless your geofence is quite large (at keast over 1000m).\",\n  \"title\": \"Dwell Time\"\n}\n[/block]","excerpt":"","slug":"geofence-dwell-time","type":"basic","title":"Geofence Dwell Time"}

Geofence Dwell Time


[block:image] { "images": [ { "image": [ "https://files.readme.io/ad14314-1020_x_1080_1.png", "1020 x 1080 (1).png", 1920, 1080, "#70cddd" ] } ] } [/block] Pulsate enables you to track users when they enter or exit a geofence (for more information see our main [Geofences](doc:geofences) documentation) and now we also allow you to target users when they dwell in a geofence for a specified period of time. This gives you much more control over when a user should receive a geofence campaign and helps to eliminate users who may be only passing through the geofence. **Setting Dwell Time for a Campaign** To set a campaign to trigger when the user dwells in that location, first set up the campaign content (push notification, campaign etc) and when you get to the Targeting section, turn on the geofences widget and select the geofence that you wish to target. [block:image] { "images": [ { "image": [ "https://files.readme.io/3fd4246-Geofence_Select.gif", "Geofence Select.gif", 1440, 693, "#eefbfb" ], "caption": "Selecting a Geofence" } ] } [/block] By default, all geofences are set to target users when they ender the geofence. To change this, click the Entry dropdown to the right of the geofence that you selected. You will know be able to select whether the geofence is triggered when the user enters or exits the area or when they dwell in that area for a specified amount of time. If you wish the notification to be triggered when after the user dwells in that location, select Dwell Time and fill in how long you want the user to dwell in that location before they receive this campaign. Dwell time is set in minutes, up to a maximum of 60 minutes. [block:image] { "images": [ { "image": [ "https://files.readme.io/4ac4901-Set_Dwell_Time.gif", "Set Dwell Time.gif", 467, 652, "#42618f" ], "caption": "Set Dwell Time" } ] } [/block] When you set dwell time, the simulator screen will update and to show you that the campaign is now being triggered when the user spends the amount of time that you specified in the geofence. [block:image] { "images": [ { "image": [ "https://files.readme.io/70738c7-Screenshot_2016-12-09_15.34.03.png", "Screenshot 2016-12-09 15.34.03.png", 1435, 755, "#f2fafa" ], "caption": "Dwell Time Set" } ] } [/block] The geofence and dwell time that you specified will also be displayed on the campaign Review screen and if you wish to change it, you can press the Edit button in the Targeting block on the Review screen. [block:image] { "images": [ { "image": [ "https://files.readme.io/3bae9f7-Screenshot_2016-12-21_16.40.33.png", "Screenshot 2016-12-21 16.40.33.png", 1401, 358, "#f2f9fa" ], "caption": "Review" } ] } [/block] [block:callout] { "type": "warning", "body": "Please note that users may not dwell in great numbers in a geofence region, especially if the geofence area is relatively small. For that reason we recommend that your geofence should be at least 300-400m in size and that you should not set dwell time for more than 15 minutes unless your geofence is quite large (at keast over 1000m).", "title": "Dwell Time" } [/block]