Actions32
- Analytics Actions
- Moderation Actions
- Backup Actions
- Automation Actions
- Insights Actions
Overview
This node provides advanced analytics and insights for Discord servers (guilds), focusing on the 'Retention Analysis' operation under the 'Insights' resource. It analyzes member retention rates over a specified time range, considering various options such as including bot activity, minimum message counts, attachment inclusion, spam thresholds, inactivity days, and maximum processing limits. This node is useful for server administrators and community managers who want to understand member engagement and retention trends to improve community health and activity.
Use Case Examples
- Analyzing member retention over the past 7 days to identify active and inactive users.
- Including or excluding bot activity in retention metrics to get accurate human user insights.
- Setting minimum message thresholds to focus on engaged members only.
Properties
| Name | Meaning |
|---|---|
| Guild ID | The ID of the Discord server (guild) to analyze. |
| Time Range (Days) | Number of days to analyze for retention, ranging from 1 to 30. |
| Additional Options | Collection of optional parameters to customize the retention analysis, including: whether to include bots, minimum messages for analysis, whether to include attachments, spam threshold for flagging messages, days of inactivity to flag users, and maximum items to process. |
Output
JSON
guildId- The ID of the Discord server analyzed.timeRange- The number of days over which the retention analysis was performed.retentionData- Detailed data on member retention rates and related metrics.
Dependencies
- Discord API with bot token authentication
Troubleshooting
- Ensure the provided Guild ID is correct and the bot has access to the guild.
- Verify the bot token credential is valid and has necessary permissions to fetch guild data.
- If the channel or guild data is not found, check the bot's permissions and presence in the server.
- Errors related to message fetching may occur if the bot lacks message reading permissions in channels.