{"_id":"58595ba4e342f919009320c3","parentDoc":null,"category":{"_id":"561c7271d2fb350d004bf89a","pages":["561c80a3a2cc000d00e9a861","564de2b5b5bea52b00c3457b"],"project":"561c70aabe5fb20d00077758","version":"561c70aabe5fb20d0007775b","__v":2,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-13T02:54:41.501Z","from_sync":false,"order":4,"slug":"settings-other","title":"Settings & Other"},"user":"5825dece55b1060f00ec4134","version":{"_id":"561c70aabe5fb20d0007775b","__v":6,"project":"561c70aabe5fb20d00077758","createdAt":"2015-10-13T02:47:06.824Z","releaseDate":"2015-10-13T02:47:06.824Z","categories":["561c70abbe5fb20d0007775c","561c725c4b0a9b0d00c0f515","561c7260cd5e7b0d00eb48c6","561c726bf0e0580d00ddd9a4","561c7271d2fb350d004bf89a","564de219b5bea52b00c3457a"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":0,"project":"561c70aabe5fb20d00077758","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-12-20T16:26:12.621Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"Carnival has the ability limit the pace at which push notification are sent.\n\n## How throttling works\nOur platform is optimized to send notifications in the fastest way possible. When you use throttling, you can specify a value indicating the number of pushes you want to send per second.\n\n**Carnival will always send the first batch of pushes (up to 1,000)**. We then use a value you specify to calculate (on average) how long we have to wait until we send the next batch. The lower the value you specify, the longer the wait.\n\n## Setting up throttling\nGo to **Settings** -> **General**, then head over to **Push Throttle**. Click **Throttle** and use the scroller or the input field to specify a value.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Only Admins can make changes to the Push Throttling settings. Authors, Developers and Viewers will receive an error and no change will be performed.\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/dc57730-Screen_Shot_2016-12-20_at_11.04.06_AM.png\",\n        \"Screen Shot 2016-12-20 at 11.04.06 AM.png\",\n        1187,\n        374,\n        \"#16181d\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"\",\n  \"body\": \"Throttling is global per app. If you have both iOS and Android configured, throttling will not take the device platform into account.\\n\\nIf you want to throttle only one platform, create a platform based audience, enable throttling, then disable it after the send if complete.\"\n}\n[/block]\nWhen you set up throttling, notifications will start sending in a staggered way based on the criteria described above. For each push, you will now see a progress indicator with the status of the current send (the possible statuses are Sending, Pausing, Paused, Complete).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/80ae0bc-Screen_Shot_2016-12-20_at_11.42.35_AM.png\",\n        \"Screen Shot 2016-12-20 at 11.42.35 AM.png\",\n        571,\n        127,\n        \"#d3d9da\"\n      ]\n    }\n  ]\n}\n[/block]\n## Changing throttling limits for a current push\nBecause throttling can work in tandem with [pausing](doc:push-pausing), you can use a combination of the two to speed up or slow down the rate at which notifications are being sent.\nAssuming throttling is already enabled:\n\n1. Go to **Messages** -> **Push**\n2. Select the push you want to speed up or slow down. The notification's status must be **Sending**.\n3. Click on the pause icon to temporarily suspend the send. The notification status will change to **Pausing…**, then **Paused**.\n4. Go to **Settings** -> **General** -> **Push Throttle** and change the settings. You can choose to change the throttle rate or to disable Throttling entirely.\n5. Go back to the push notification you selected on step 2, and click on the play icon to resume sending the notification to the remaining users.","excerpt":"","slug":"push-throttling","type":"basic","title":"Throttling Push Notifications"}

Throttling Push Notifications


Carnival has the ability limit the pace at which push notification are sent. ## How throttling works Our platform is optimized to send notifications in the fastest way possible. When you use throttling, you can specify a value indicating the number of pushes you want to send per second. **Carnival will always send the first batch of pushes (up to 1,000)**. We then use a value you specify to calculate (on average) how long we have to wait until we send the next batch. The lower the value you specify, the longer the wait. ## Setting up throttling Go to **Settings** -> **General**, then head over to **Push Throttle**. Click **Throttle** and use the scroller or the input field to specify a value. [block:callout] { "type": "info", "body": "Only Admins can make changes to the Push Throttling settings. Authors, Developers and Viewers will receive an error and no change will be performed." } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/dc57730-Screen_Shot_2016-12-20_at_11.04.06_AM.png", "Screen Shot 2016-12-20 at 11.04.06 AM.png", 1187, 374, "#16181d" ] } ] } [/block] [block:callout] { "type": "info", "title": "", "body": "Throttling is global per app. If you have both iOS and Android configured, throttling will not take the device platform into account.\n\nIf you want to throttle only one platform, create a platform based audience, enable throttling, then disable it after the send if complete." } [/block] When you set up throttling, notifications will start sending in a staggered way based on the criteria described above. For each push, you will now see a progress indicator with the status of the current send (the possible statuses are Sending, Pausing, Paused, Complete). [block:image] { "images": [ { "image": [ "https://files.readme.io/80ae0bc-Screen_Shot_2016-12-20_at_11.42.35_AM.png", "Screen Shot 2016-12-20 at 11.42.35 AM.png", 571, 127, "#d3d9da" ] } ] } [/block] ## Changing throttling limits for a current push Because throttling can work in tandem with [pausing](doc:push-pausing), you can use a combination of the two to speed up or slow down the rate at which notifications are being sent. Assuming throttling is already enabled: 1. Go to **Messages** -> **Push** 2. Select the push you want to speed up or slow down. The notification's status must be **Sending**. 3. Click on the pause icon to temporarily suspend the send. The notification status will change to **Pausing…**, then **Paused**. 4. Go to **Settings** -> **General** -> **Push Throttle** and change the settings. You can choose to change the throttle rate or to disable Throttling entirely. 5. Go back to the push notification you selected on step 2, and click on the play icon to resume sending the notification to the remaining users.