> For the complete documentation index, see [llms.txt](https://eirin-ai.gitbook.io/eirin-ai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eirin-ai.gitbook.io/eirin-ai-docs/reference/what-we-track.md). # What we track All the data Eirin collects on each platform, what each field means, and what makes each source different. This page lists all the data Eirin collects on each platform, what each field means, and what makes each source different. All eight sources below are **live**. ## Platform comparison | | Play Store | App Store | Reddit | Steam | Discord | YouTube | Instagram | Support email | | ------------------------- | --------------------------------- | ------------------------- | ------------------------- | ------------------------------------------- | ----------------------------- | ----------------------------------- | ---------------------------------------- | ---------------------------------------------- | | **Content** | App reviews | App reviews | Posts and comment threads | Game reviews | Server messages | Videos and comments | Your posts and reels, and their comments | Mail players send to your support address | | **Rating or signal** | โ˜… 1 to 5 stars | โ˜… 1 to 5 stars | Upvote score | ๐Ÿ‘ Thumbs up or down | Emoji reactions | Views and likes | Likes on comments | None, it is correspondence | | **Reply threads** | No | No | โœ“ Full thread | No | โœ“ Threaded replies | โœ“ Comments and replies | โœ“ Comment replies | โœ“ Full email thread | | **Developer replies** | โœ“ Collected | No | No | No | No | No | โœ“ Your own replies, marked as yours | โœ“ Your own replies, in the thread | | **Regions** | 25 regions (language and country) | 25 countries | Worldwide | Worldwide | Your server | Worldwide | Your connected account | Your connected mailbox | | **Engagement** | Helpful votes | Vote count and direction | Score and upvote ratio | Helpful and funny votes, quality score | Count for each emoji reaction | Views, likes and comment count | Likes per comment | Thread length | | **Only on this platform** | App version, developer reply | Review title, edited flag | Flair or tags, link | Hours played, bought on Steam, Early Access | Channel name, bot filter | Transcript, relevance check, length | Caption, media type, hidden comments | Subject ยท attachments by name ยท thread history | | **How often** | Every 6 hours | Every 6 hours | Every 6 hours | Every 6 hours | As messages are posted (bot) | Channel feeds and YouTube search | Every hour, last 7 days of posts | Hourly, new mail since the last check | ## What you need to track each platform | | Play Store | App Store | Reddit | Steam | Discord | YouTube | Instagram | Support email | | --------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------- | ------------------------- | --------------------------- | ----------------------------------------------------------- | --------------------------------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | **To start tracking** | Paste your Play Store link | Paste your App Store link | Paste your subreddit link | Paste your Steam store link | Click Connect Discord and pick your server on Discord | Enter keywords, and channel links if you want | Click Connect Instagram and sign in to your business or creator account | OAuth, click Connect Support Email and sign in to the mailbox with Google | | **Extra setup** | Not needed | Not needed | Not needed | Not needed | Run `/setup-channels` in your server to choose the channels | Not needed | Not needed | โ€” | | **To turn on replies** (optional) | Invite our service account email, then paste the Cloud Storage URI from Play Console | Key ID, Issuer ID and .p8 file, from App Store Connect โ†’ Keys | Not yet | Not yet | Switch replies on under Reply setup โ†’ Social connections | Not yet | Switch replies on under Reply setup โ†’ Social connections | Switch replies on under Reply setup โ†’ Social connections; every reply still needs your approval | ## Field details by platform {% tabs %} {% tab title="Play Store" %} **Source:** Google Play reviews ยท 25 markets | Section | Field | Key | What it means | | ------------------- | --------------- | ------------------- | ------------------------------------------------------------------ | | Reviewer | Author | `author_name` | The reviewer's display name | | | Language | `language` | The language of the review (for example en, de, ja) | | | App version | `app_version` | The version of the app the reviewer had when they wrote the review | | | Market | `market` | The region the review came from (for example en-us, de-de) | | Rating and feedback | Star rating | `rating` | 1 to 5 stars | | | Review text | `content` | The full review | | | Helpful votes | `thumbs_up_count` | How many people found the review helpful | | | Developer reply | `reply_content` | The developer's public reply, if there is one | | Dates | Posted | `review_created_at` | When the review was first written | | | Last updated | `review_updated_at` | When the reviewer last edited it | {% hint style="info" %} โ˜… **Only on Play Store:** the developer's reply, and the app version when the review was written. This helps you link complaints to a specific release. {% endhint %} **25 markets:** en-us, en-gb, en-ca, en-au, hi-in, de-de, fr-fr, it-it, es-es, es-mx, pt-br, ja-jp, ko-kr, zh-tw, zh-hk, ru-ru, tr-tr, ar-sa, ar-ae, th-th, id-id, nl-nl, pl-pl, sv-se, vi-vn {% endtab %} {% tab title="App Store" %} **Source:** App Store reviews ยท 25 countries | Section | Field | Key | What it means | | ------------------- | -------------- | ------------------- | -------------------------------------------------------------------------- | | Reviewer | Author | `author_name` | The reviewer's display name | | | Language | `language` | The language of the review | | | Country | `market` | The App Store country the review came from (for example us, gb, jp) | | | Edited | `is_edited` | Whether the reviewer changed their review after posting | | Rating and feedback | Star rating | `rating` | 1 to 5 stars | | | Review title | `title` | The short headline the reviewer added. Only the App Store has this | | | Review text | `content` | The full review | | | Helpful votes | `vote_count` | How many people voted on whether the review was helpful | | | Vote direction | `vote_sum` | The net result of those votes. Positive means more people found it helpful | | Dates | Posted | `review_created_at` | When the review was first written | {% hint style="info" %} โ˜… **Only on App Store:** the review title, a short headline separate from the review. It lets you scan the mood quickly without reading every full review. {% endhint %} **25 countries:** us, gb, ca, au, in, de, fr, it, es, mx, br, jp, kr, tw, hk, ru, tr, sa, ae, th, id, nl, pl, se, vn {% endtab %} {% tab title="Reddit" %} **Source:** Reddit posts and comments | Section | Field | Key | What it means | | -------- | ------------- | -------------------- | ------------------------------------------------------------------------------------ | | Post | Title | `title` | The post's headline | | | Body text | `body` | The post's text (empty for link and image posts) | | | Flair or tag | `flair` | The label on the post, for example "Bug Report", "Feedback" or "Discussion" | | | Author | `author` | The poster's Reddit username | | | Upvote score | `score` | Net upvotes when Eirin collected it | | | Upvote ratio | `upvote_ratio` | The share of votes that are upvotes, from 0 to 1. A low number means people disagree | | | Comment count | `num_comments` | How many replies the post has | | | Post link | `url` | A direct link to the post | | | Posted | `post_created_at` | When the post was made | | Comments | Comment text | `body` | The full comment | | | Author | `author` | The commenter's Reddit username | | | Score | `score` | Net upvotes on the comment | | | Thread depth | `depth` | 0 means a direct reply to the post, 1 means a reply to a comment, and so on | | | Parent | `parent_id` | The comment or post it replies to, so Eirin can rebuild the whole thread | | | Posted | `comment_created_at` | When the comment was written | {% hint style="info" %} โ˜… **Only on Reddit:** the full thread, showing which comment replies to which. Eirin can follow how a conversation develops, and use flair to group posts by topic (for example all "Bug Report" posts). {% endhint %} {% endtab %} {% tab title="Steam" %} **Source:** Steam store reviews ยท Worldwide | Section | Field | Key | What it means | | ----------------- | --------------- | -------------------- | --------------------------------------------------------------------------------------------------------- | | Reviewer | Display name | `author_name` | The reviewer's Steam name when Eirin collected it | | | Steam ID | `author_steam_id` | The account's permanent ID, which stays the same even if the name changes | | | Language | `language` | The language of the review | | Rating and review | Recommendation | `voted_up` | Thumbs up or thumbs down. Steam doesn't use stars | | | Review text | `content` | The full review | | | Helpful votes | `votes_up` | How many people found the review helpful | | | Funny votes | `votes_funny` | How many people marked it as funny | | | Quality score | `weighted_score` | Steam's own helpfulness score, based on the votes | | Purchase | Hours played | `playtime_at_review` | Minutes played on this account when the review was written, which shows how much time the reviewer put in | | | Bought on Steam | `steam_purchase` | Whether they bought it on Steam or used a key from somewhere else | | | Received free | `received_for_free` | Whether the game was a gift, a giveaway or a press copy | | | Early Access | `written_during_ea` | Whether the review was written during Early Access | | Dates | Posted | `review_created_at` | When the review was written | | | Last updated | `review_updated_at` | When the review was last edited | {% hint style="info" %} โ˜… **Only on Steam:** hours played, how the game was bought, and the Early Access flag. You can see how much time a reviewer actually put in, and compare Early Access reviews with reviews after launch. {% endhint %} {% endtab %} {% tab title="Discord" %} **Source:** Lysto Discord bot ยท Messages as they're posted in your server | Section | Field | Key | What it means | | --------------- | ------------- | -------------------- | -------------------------------------------------------------------------------------- | | Message details | Author | `author_tag` | The username and tag (for example alice#1234) | | | Channel | `channel_name` | The channel the message was posted in, for example #feedback, #bug-reports or #general | | | Is a bot | `author_is_bot` | Bot messages are collected but left out of the analysis | | Message content | Message text | `content` | The full message | | | Emojis used | `emojis` | Emojis in the message text, both custom and standard (for example ๐Ÿ”ฅ, ๐Ÿ’€) | | | Reactions | `reactions` | Each reaction emoji and how many people used it (for example ๐Ÿ‘ ร— 52) | | Threads | Thread parent | `parent_id` | The message a reply belongs to, so Eirin can rebuild the conversation | | Dates | Sent | `message_created_at` | When the message was posted | {% hint style="info" %} โ˜… **Only on Discord:** reaction counts for each emoji show how your community feels as it happens. The channel shows whether a message came from a support channel, a casual chat or a feedback space. {% endhint %} {% endtab %} {% tab title="YouTube" %} **Source:** YouTube videos, channel feeds and transcripts ยท Videos and comments | Section | Field | Key | What it means | | ------------- | ------------ | -------------------- | -------------------------------------------------------------------------------------- | | Your settings | Search query | `search_query` | The keyword Eirin uses to find videos on YouTube (for example "Clash of Clans review") | | | Channel IDs | `channel_ids` | Specific YouTube channels to follow directly. Eirin collects everything they post | | Video | Title | `title` | The video title | | | Description | `description` | The video description | | | Channel | `channel_title` | The channel that posted it | | | Duration | `duration_seconds` | The length of the video in seconds | | | View count | `view_count` | Total views when Eirin collected it | | | Like count | `like_count` | Total likes when Eirin collected it | | | Transcript | `transcript` | Everything said in the video, collected automatically where available | | | Relevant? | `is_relevant` | An AI check. Only videos about your game are used in the analysis | | | Published | `published_at` | When the video was posted | | Comments | Comment text | `body` | The full comment | | | Author | `author` | The commenter's YouTube name | | | Like count | `like_count` | Likes on the comment | | | Parent | `parent_id` | The comment a reply belongs to. Top-level comments have none | | | Posted | `comment_created_at` | When the comment was written | {% hint style="info" %} โ˜… **Only on YouTube:** full video transcripts, so Eirin knows what people say out loud as well as what they write. A relevance check also removes videos that aren't about your game before analysis. {% endhint %} {% endtab %} {% tab title="Instagram" %} **Source:** Instagram, through your connected business or creator account ยท Your own posts and reels, and their comments | Section | Field | Key | What it means | | ------------ | ------------ | -------------------- | --------------------------------------------------------------------------- | | Post or reel | Account | `author_name` | Your account's handle | | | Caption | `content` | The post or reel caption, so comments are read in context | | | Media type | `media_type` | Image, video or carousel | | | Post link | `url` | A link to the post | | | Posted | `post_created_at` | When the post was published | | Comments | Comment text | `content` | The full comment | | | Author | `author_name` | The commenter's Instagram handle | | | Author role | `author_role` | `owner` when the comment is from your own account, otherwise `community` | | | Likes | `like_count` | Likes on the comment | | | Parent | `parent_id` | For a reply, the comment it answers. Otherwise, the post | | | Hidden | `hidden` | Whether Instagram has hidden the comment, for example because it has a link | | | Posted | `comment_created_at` | When the comment was written | {% hint style="info" %} โ˜… **Only on Instagram:** content from your own account, read with your permission, not from a public feed. Eirin reads posts from the last 7 days every hour, so comments on posts older than a week aren't collected and don't get a reply. Mentions, story replies and direct messages aren't collected. {% endhint %} {% endtab %} {% tab title="Support email" %} **Source:** Gmail, through your connected support mailbox ยท Every message in the mailbox, read and unread | Section | Field | Key | What it means | | ---------------- | ----------- | -------------------- | ------------------------------------------------------------------------------------------------- | | Message identity | Sender | `author_name` | The player's name and address as they appear on the email | | | Role | `author_role` | `owner` when the message is one of your team's own replies, otherwise `community` | | | Thread | `thread_id` | The conversation this message belongs to, so a draft is written with the earlier messages in view | | | Position | `depth` | Where the message sits in its thread | | Message content | Subject | `title` | The email subject | | | Body | `content` | The message text | | | Attachments | `attachments` | Filename, type and size of anything attached. The files themselves are never downloaded | | Timestamps | Received | `message_created_at` | When the email arrived | {% hint style="info" %} โ˜… **Only on support email:** private correspondence rather than a public feed, read with your permission. Your team's own replies are collected too, because they are what Eirin learns your support voice from. Eirin checks the mailbox every hour, and because one address often serves several games, each agent drafts only for mail that names its game. {% endhint %} {% endtab %} {% endtabs %} Most sources update every 6 hours. Discord messages are collected as they're posted, by the Lysto Discord bot. Instagram is checked every hour for posts from the last 7 days, and the support mailbox every hour for new mail. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://eirin-ai.gitbook.io/eirin-ai-docs/reference/what-we-track.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.