countly.carriers

Follow

Collection carriers contains break down of new, total and unique carriers 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 { "14": { "Tele2": { "t": 1, "u": 1 }, "Turkcell": { "t": 1, "u": 1 }, "Vodafone": { "t": 1, "u": 1 } }
m {year}:{month} for which data is provided 2014:10
meta Information about all carrier values. Note it exists only for Zero documents of each year "carriers": [ "Vodafone", "Tele2", "Turkcell", "O2", "Sprint", "Rogers Wireless", "T-mobile", "Verizon", "Cricket Communications", "Metro Pcs", "Bell Canada", "Orange", "Telus", "\tAt&t" ]
meta_v2 New way to store meta info, much faster writes than using sets "carriers": { "Vodafone":true, "Tele2":true }

 

Here are examples of both document types:

Zero document Month document
{
    "_id": "542e95d747f0be510c000004_2014:0",
    "a": "542e95d747f0be510c000004",
    "d": {
        "10": {
            "\tAt&t": {
                "u": 23
            },
            "Bell Canada": {
                "u": 19
            },
            "Cricket Communications": {
                "u": 26
            },
            "Metro Pcs": {
                "u": 23
            },
            "O2": {
                "u": 30
            },
            "Orange": {
                "u": 26
            },
            "Rogers Wireless": {
                "u": 21
            },
            "Sprint": {
                "u": 25
            },
            "T-mobile": {
                "u": 22
            },
            "Tele2": {
                "u": 33
            },
            "Telus": {
                "u": 22
            },
            "Turkcell": {
                "u": 28
            },
            "Verizon": {
                "u": 21
            },
            "Vodafone": {
                "u": 23
            }
        },
        "\tAt&t": {
            "u": 23
        },
        "Bell Canada": {
            "u": 19
        },
        "Cricket Communications": {
            "u": 26
        },
        "Metro Pcs": {
            "u": 23
        },
        "O2": {
            "u": 30
        },
        "Orange": {
            "u": 26
        },
        "Rogers Wireless": {
            "u": 21
        },
        "Sprint": {
            "u": 25
        },
        "T-mobile": {
            "u": 22
        },
        "Tele2": {
            "u": 33
        },
        "Telus": {
            "u": 22
        },
        "Turkcell": {
            "u": 28
        },
        "Verizon": {
            "u": 21
        },
        "Vodafone": {
            "u": 23
        },
        "w41": {
            "Tele2": {
                "u": 1
            },
            "Turkcell": {
                "u": 1
            },
            "Vodafone": {
                "u": 1
            }
        },
        "w42": {
            "\tAt&t": {
                "u": 23
            },
            "Bell Canada": {
                "u": 19
            },
            "Cricket Communications": {
                "u": 26
            },
            "Metro Pcs": {
                "u": 23
            },
            "O2": {
                "u": 30
            },
            "Orange": {
                "u": 26
            },
            "Rogers Wireless": {
                "u": 21
            },
            "Sprint": {
                "u": 25
            },
            "T-mobile": {
                "u": 22
            },
            "Tele2": {
                "u": 32
            },
            "Telus": {
                "u": 22
            },
            "Turkcell": {
                "u": 27
            },
            "Verizon": {
                "u": 21
            },
            "Vodafone": {
                "u": 22
            }
        }
    },
    "m": "2014:0",
    "meta": {
        "carriers": [
            "Vodafone",
            "Tele2",
            "Turkcell",
            "O2",
            "Sprint",
            "Rogers Wireless",
            "T-mobile",
            "Verizon",
            "Cricket Communications",
            "Metro Pcs",
            "Bell Canada",
            "Orange",
            "Telus",
            "\tAt&t"
        ]
    }
}

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?