{"__v":1,"_id":"570fa3cd986c040e008f7b7b","category":{"__v":3,"_id":"56af6d6ecc4cbd0d00ce2c88","pages":["56af6e8460a37a0d00ed87ac","56af71e58be2ea0d00b48887","56af73a08be2ea0d00b48890"],"project":"56abbf55f25f160d00e17f4e","version":"56abbf55f25f160d00e17f51","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-02-01T14:36:30.275Z","from_sync":false,"order":2,"slug":"concepts","title":"Kongregate APIs & Concepts"},"parentDoc":null,"project":"56abbf55f25f160d00e17f4e","user":"56abbec30b9e0b0d00616274","version":{"__v":12,"_id":"56abbf55f25f160d00e17f51","project":"56abbf55f25f160d00e17f4e","createdAt":"2016-01-29T19:36:53.665Z","releaseDate":"2016-01-29T19:36:53.665Z","categories":["56abbf56f25f160d00e17f52","56abca6bf9757e0d007c6650","56acddfa0ab3c00d00ce3332","56af65da9d32e30d0006d30f","56af66cab34d210d003d9ad0","56af6afcd21e9c0d00b628d1","56af6d6ecc4cbd0d00ce2c88","5705b12221cfed0e00e8c580","570a5676ade45d0e00c1ad33","570d7d25d1e4b82000d9e385","570eac3c3160d10e0041df0e","575709000fd6a3200010dded"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-04-14T14:06:05.394Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":11,"body":"## Mass Message Communications\n\n## Communicating With Your Players\n\nThe Kongregate platform enables developers with popular and highly-rated games (minimum 10,000 gameplays, with at least a 3.75 rating) to communicate with their players to let them know about new updates, events, promotions, and content. These communications can be sent out to current players (anyone who has played the game 3 or more times ever and at least once in the last 10 days) and inactive players (anyone with 5 or more gameplays but who has not played in the last 10 days). You can send out an active mass message at most once every 7 days, while inactive mass messages can be sent at most once every 30 days. Players will receive these messages through the Kongregate messaging system.\n\nTo access this tool, look for the \"send message to active players\" and \"send message to inactive players\" links below your game on your main game page. Once you click on one of those, you'll be taken to a simple UI where you can fill in the text to be sent, preview it before sending, and then finally send it out. Once you send the message, it will go to our message queue and be processed over the next hour or so.\n\nThese messages are only to be used for promoting the game for which they are associated or related sequels/betas. The messages cannot refer to other games or any off-Kongregate content, and of course should not be offensive or vulgar. Messages will be subject to admin approval - we attempt to approve these quickly and they should generally be sent within 48 hours, if not much quicker (usually much faster).\n\nOnce the message gets sent, it will look something like this:\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ObJebybTSGVzptND2Q25_Screen_shot_2012-03-14_at_4.36.48_PM.png\",\n        \"Screen_shot_2012-03-14_at_4.36.48_PM.png\",\n        \"467\",\n        \"85\",\n        \"#9b2230\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n## Communication Tips & Best Practices\n\n*   There are <span style=\"font-style:italic\">no take-backs</span> when sending out a mass message. Be sure you look at the preview carefully, proofread your message, and check your links before sending. You should also double-check the URL parameters on the message page to ensure you are on \"active\" or \"inactive\" as expected (this will be shown in the UI in a future update).\n*   Players will have the ability to turn off messages from your game. As such, you should be careful to be moderate with the number of updates you send out. Keep them interesting and relevant, and don't use them to cross-promote, spam, or otherwise send information that is not directly relevant to players of your game.\n*   You may want to link to your game in the message, though the message will appear as coming from your game, and if the user clicks on the game name it will automatically take them to the game. If you do use a manual link as well, links early in the message get clicked more than ones at the end.\n*   This is a text-only tool, but two basic HTML formatting tags can be used: paragraphs `<p>` and line breaks `<br>`.\n*   Only the first 4 or 5 lines of the message will be shown in the message preview, with the remaining ones hidden under a \"show more\" link. If you send a long message with lots of details, make sure your most interesting and compelling information is near the top.","excerpt":"Keep in touch with your players","slug":"concepts-mass-communication","type":"basic","title":"Mass Communication"}

Mass Communication

Keep in touch with your players

## Mass Message Communications ## Communicating With Your Players The Kongregate platform enables developers with popular and highly-rated games (minimum 10,000 gameplays, with at least a 3.75 rating) to communicate with their players to let them know about new updates, events, promotions, and content. These communications can be sent out to current players (anyone who has played the game 3 or more times ever and at least once in the last 10 days) and inactive players (anyone with 5 or more gameplays but who has not played in the last 10 days). You can send out an active mass message at most once every 7 days, while inactive mass messages can be sent at most once every 30 days. Players will receive these messages through the Kongregate messaging system. To access this tool, look for the "send message to active players" and "send message to inactive players" links below your game on your main game page. Once you click on one of those, you'll be taken to a simple UI where you can fill in the text to be sent, preview it before sending, and then finally send it out. Once you send the message, it will go to our message queue and be processed over the next hour or so. These messages are only to be used for promoting the game for which they are associated or related sequels/betas. The messages cannot refer to other games or any off-Kongregate content, and of course should not be offensive or vulgar. Messages will be subject to admin approval - we attempt to approve these quickly and they should generally be sent within 48 hours, if not much quicker (usually much faster). Once the message gets sent, it will look something like this: [block:image] { "images": [ { "image": [ "https://files.readme.io/ObJebybTSGVzptND2Q25_Screen_shot_2012-03-14_at_4.36.48_PM.png", "Screen_shot_2012-03-14_at_4.36.48_PM.png", "467", "85", "#9b2230", "" ] } ] } [/block] ## Communication Tips & Best Practices * There are <span style="font-style:italic">no take-backs</span> when sending out a mass message. Be sure you look at the preview carefully, proofread your message, and check your links before sending. You should also double-check the URL parameters on the message page to ensure you are on "active" or "inactive" as expected (this will be shown in the UI in a future update). * Players will have the ability to turn off messages from your game. As such, you should be careful to be moderate with the number of updates you send out. Keep them interesting and relevant, and don't use them to cross-promote, spam, or otherwise send information that is not directly relevant to players of your game. * You may want to link to your game in the message, though the message will appear as coming from your game, and if the user clicks on the game name it will automatically take them to the game. If you do use a manual link as well, links early in the message get clicked more than ones at the end. * This is a text-only tool, but two basic HTML formatting tags can be used: paragraphs `<p>` and line breaks `<br>`. * Only the first 4 or 5 lines of the message will be shown in the message preview, with the remaining ones hidden under a "show more" link. If you send a long message with lots of details, make sure your most interesting and compelling information is near the top.