countly.langs

Follow

Device locale plugin required

This collection might not appear if you don't have device locale plugin enabled

Collection langs contains break down of new, total and unique languages provided in the metrics by time periods.

For shorter representation, these stats are abbreviated as:

  • n - new
  • t - total
  • u - unique

There are 4 types of documents available:

  1. Zero document, which id is formed from {appID}_{year}:0 And it contains stats breakdown by months and weeks for the specified year
  2. Month document, which id is formed from {appID}_{year}:{month} And it contains stats breakdown by days of the month
  3. Splitted zero document which id is formed from {appID}{year}:0{shardname}
  4. Splitted month document which id is formed from {appID}{year}:{month}{shardname}

Here is the list of possible fields

Field Description Example
_id ID formed as {appID}{year}:0 or {appID}{year}:{month} or {appID}{year}:0{shardname} or {appID}{year}:{month}{shardname} 542e95d747f0be510c000004_2014:10
a App ID 542e95d747f0be510c000004
d Data for specific document {       "1": {          "zh_hans": {             "u": 1          }       },       "7": {          "zh_hans": {             "u": 1          }       },       "10": {          "en": {             "u": 1          }       } }
m {year}:{month} for which data is provided 2014:10
meta Information about all language values. Note it exists only for Zero documents of each year "langs": [          "zh_hans",          "en"       ]
meta_v2 New way to store meta info, much faster writes than using sets "langs": {          "zh_hans":true,          "en":true       }


Here are examples of both document types:

Zero document Month document
{
   "_id": "56e53eae4a359b2f5057c8bb_2012:0",
   "m": "2012:0",
   "a": "56e53eae4a359b2f5057c8bb",
   "d": {
      "1": {
         "zh_hans": {
            "u": 1
         }
      },
      "7": {
         "zh_hans": {
            "u": 1
         }
      },
      "10": {
         "en": {
            "u": 1
         }
      },
      "zh_hans": {
         "u": 2
      },
      "w1": {
         "zh_hans": {
            "u": 1
         }
      },
      "w27": {
         "zh_hans": {
            "u": 1
         }
      },
      "en": {
         "u": 1
      },
      "w41": {
         "en": {
            "u": 1
         }
      }
   },
   "meta": {
      "langs": [
         "zh_hans",
         "en"
      ]
   }
}

Custom Countly metrics

Same collection data pattern is also used in other custom Countly metrics you might want to use in your Countly installation

Looking for help?