{"_id":"5847583b41c89b0f00191b33","category":{"_id":"58474584889b6c2d00fb86e9","version":"5668fab608f90021008e8832","__v":0,"project":"5668fab608f90021008e882f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-12-06T23:11:00.646Z","from_sync":false,"order":13,"slug":"drilldowns","title":"Drilldowns"},"__v":0,"githubsync":"","parentDoc":null,"user":"5668fa9755e4b32100935d41","version":{"_id":"5668fab608f90021008e8832","__v":19,"project":"5668fab608f90021008e882f","createdAt":"2015-12-10T04:08:22.769Z","releaseDate":"2015-12-10T04:08:22.769Z","categories":["5668fab708f90021008e8833","569740f124490c3700170a64","569742b58560a60d00e2c25d","569742bd0b09a41900b2446c","569742cd69393517000c82b3","569742f459a6692d003fad8f","569743020b09a41900b2446d","5697430b69393517000c82b5","56a17776470ae00d00c30642","56a2c48a831e2a0d0069b1ad","56b535757bccae0d00e9a1cd","56e1ff6aa49fdc0e005746b5","57e1c88115bf6522002a5e4e","57fa65275ba65a17008b988f","57fbeea34002550e004c032e","58474584889b6c2d00fb86e9","58475dcc64157f0f002f1907","587e7b5158666c2700965d4e","58a349fc30852819007ba083"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.18.0","version":"1.18"},"project":"5668fab608f90021008e882f","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-12-07T00:30:51.415Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Both for the purposes of training our models and sharing analytics with customers, we track referrers for individual pageviews, sessions, and users.\n\nIf using our JavaScript beacon, referrer data collection is automatic.\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Session referrer and user referrer\"\n}\n[/block]\nThe session referrer is the referrer to the user's first activity in the given session.\n\nThe user referrer is the referrer to the user's first entry to the site.\n\nFor the [Analytics Panel](doc:analytics-panel) and [RealTime Panel](doc:realtime-panel), we display data based on the session referrer.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Referrer type and name classification\"\n}\n[/block]\nWe maintain a list of standard referrer names and types. When we examine the referrer URL, we compute `referrerName` and `referrerType` from the session referrer. The following are the current special values for `referrerName`:\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"referrerName\",\n    \"h-1\": \"referrerType\",\n    \"h-2\": \"sessionReferrer condition\",\n    \"0-0\": \"Google\",\n    \"0-1\": \"search\",\n    \"0-2\": \"All Google pages. Note that traffic from non-search Google domains may be misclassified as search traffic.\",\n    \"1-0\": \"Bing\",\n    \"1-1\": \"search\",\n    \"1-2\": \"All Bing pages\",\n    \"2-0\": \"Yahoo\",\n    \"2-1\": \"search\",\n    \"2-2\": \"All Yahoo pages. Note that traffic from non-search Yahoo domains may be misclassified as search traffic.\",\n    \"3-0\": \"goo\",\n    \"3-1\": \"search\",\n    \"3-2\": \"All goo.ne.jp domains. Relevant for websites that cater to a Japanese audience.\",\n    \"4-0\": \"Yandex\",\n    \"4-1\": \"search\",\n    \"4-2\": \"All Yandex domains. Relevant for websites that cater to a Russian audience.\",\n    \"5-0\": \"AOL\",\n    \"5-1\": \"search\",\n    \"5-2\": \"search.aol.com pages.\",\n    \"6-0\": \"Ask\",\n    \"6-1\": \"search\",\n    \"6-2\": \"All ask.com pages.\",\n    \"7-0\": \"WebCrawler\",\n    \"7-1\": \"search\",\n    \"7-2\": \"All webcrawler.com pages.\",\n    \"8-0\": \"DuckDuckGo\",\n    \"8-1\": \"search\",\n    \"8-2\": \"All DuckDuckGo pages.\",\n    \"9-0\": \"Facebook\",\n    \"9-1\": \"social\",\n    \"9-2\": \"All Facebook pages. To track app-driven traffic, see our [In-app browsing](doc:in-app-browsing) documentation.\",\n    \"10-0\": \"Twitter\",\n    \"10-1\": \"social\",\n    \"10-2\": \"All Twitter pages. To track app-driven traffic, see our [In-app browsing](doc:in-app-browsing) documentation.\",\n    \"11-0\": \"Pinterest\",\n    \"11-1\": \"social\",\n    \"11-2\": \"All Pinterest pages. This does not capture traffic driven through the Pinterest app, which is where the majority of Pinterest-driven traffic comes from. To track that, see our [In-app browsing](doc:in-app-browsing) documentation.\",\n    \"12-0\": \"Reddit\",\n    \"12-1\": \"social\",\n    \"12-2\": \"All Reddit pages.\",\n    \"13-0\": \"LinkedIn\",\n    \"13-1\": \"social\",\n    \"13-2\": \"All LinkedIn pages.\",\n    \"14-0\": \"StumbleUpon\",\n    \"14-1\": \"social\",\n    \"14-2\": \"All StumbleUpon pages.\",\n    \"15-0\": \"Taboola\",\n    \"15-1\": \"sponsored\",\n    \"15-2\": \"Taboola's external recirculation unit.\",\n    \"16-0\": \"Outbrain\",\n    \"16-1\": \"sponsored\",\n    \"16-2\": \"Outbrain's external recirculation unit.\",\n    \"17-0\": \"ZergNet\",\n    \"17-1\": \"sponsored\",\n    \"17-2\": \"ZergNet's external recirculation unit.\",\n    \"19-0\": \"RevContent\",\n    \"19-1\": \"sponsored\",\n    \"19-2\": \"RevContent's external recirculation unit.\",\n    \"18-0\": \"MGID\",\n    \"18-1\": \"sponsored\",\n    \"18-2\": \"MGID's external recirculation unit.\",\n    \"20-0\": \"AdBlade\",\n    \"20-1\": \"sponsored\",\n    \"20-2\": \"AdBlade's external recirculation unit.\",\n    \"21-0\": \"RadiumOne\",\n    \"21-1\": \"sponsored\",\n    \"21-2\": \"All qklnk.co traffic.\"\n  },\n  \"cols\": 3,\n  \"rows\": 22\n}\n[/block]\nIn addition to the list above, we maintain a list of \"media\" referrers which includes standard newspapers and magazines. Any traffic from one of these gets marked with `referrerType` media and `referrerName` equal to the publication's name.\n\nIf you'd like a specific referrer to be tracked (for instance, a search engine, social network, external recirculation unit, or publication) please contact [Support](doc:support) with your request. Any addition of referrers only applies to traffic from now onward and does not apply to historical traffic.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Direct and unknown referrerType and referrerName\"\n}\n[/block]\nThere are two special values of `referrerType` (which also match the associated `referrerName` values):\n\n* `direct`: This means that there was no referrer for the session start. This could happen if the user copy/pasted a link from somewhere, or directly typed it into the browser. Some HTTPS referrers may mask themselves and appear as direct traffic.\n* `unknown`: This means that there was a referrer for the session start, but the referrer did not fit into the classification above.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Places where referrer drilldown can be used\"\n}\n[/block]\n* [Analytics Panel](doc:analytics-panel): The referrer type can be used as a drilldown for the performance chart, so that you can get CTR and other metrics filtered to a specific referrer type. Referrer name is not available here. There is also a % of pageviews breakdown by referrer type on the top left.\n* [RealTime Panel](doc:realtime-panel): You can drill down by either `referrerType` or `referrerName` for the real-time chart as well as for the top clicked and top viewed data.\n* [Insights Panel](doc:insights-panel): You can drill down by `referrerName` to filter to activity data based on a specific referrer name.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Sharing referrer data if using the activity API\"\n}\n[/block]\nFor the activity API, you can include, in each activity, the following fields:\n\n* `referrer` to denote the referrer that led to the current pageview from which activity is being sent.\n* `sessionReferrer` to denote the referrer for the user's current session.\n* `userReferrer` to denote the referrer for the user's first entry to the website or app.","excerpt":"","slug":"referrer","type":"basic","title":"Referrer"}
Both for the purposes of training our models and sharing analytics with customers, we track referrers for individual pageviews, sessions, and users. If using our JavaScript beacon, referrer data collection is automatic. [block:api-header] { "type": "basic", "title": "Session referrer and user referrer" } [/block] The session referrer is the referrer to the user's first activity in the given session. The user referrer is the referrer to the user's first entry to the site. For the [Analytics Panel](doc:analytics-panel) and [RealTime Panel](doc:realtime-panel), we display data based on the session referrer. [block:api-header] { "type": "basic", "title": "Referrer type and name classification" } [/block] We maintain a list of standard referrer names and types. When we examine the referrer URL, we compute `referrerName` and `referrerType` from the session referrer. The following are the current special values for `referrerName`: [block:parameters] { "data": { "h-0": "referrerName", "h-1": "referrerType", "h-2": "sessionReferrer condition", "0-0": "Google", "0-1": "search", "0-2": "All Google pages. Note that traffic from non-search Google domains may be misclassified as search traffic.", "1-0": "Bing", "1-1": "search", "1-2": "All Bing pages", "2-0": "Yahoo", "2-1": "search", "2-2": "All Yahoo pages. Note that traffic from non-search Yahoo domains may be misclassified as search traffic.", "3-0": "goo", "3-1": "search", "3-2": "All goo.ne.jp domains. Relevant for websites that cater to a Japanese audience.", "4-0": "Yandex", "4-1": "search", "4-2": "All Yandex domains. Relevant for websites that cater to a Russian audience.", "5-0": "AOL", "5-1": "search", "5-2": "search.aol.com pages.", "6-0": "Ask", "6-1": "search", "6-2": "All ask.com pages.", "7-0": "WebCrawler", "7-1": "search", "7-2": "All webcrawler.com pages.", "8-0": "DuckDuckGo", "8-1": "search", "8-2": "All DuckDuckGo pages.", "9-0": "Facebook", "9-1": "social", "9-2": "All Facebook pages. To track app-driven traffic, see our [In-app browsing](doc:in-app-browsing) documentation.", "10-0": "Twitter", "10-1": "social", "10-2": "All Twitter pages. To track app-driven traffic, see our [In-app browsing](doc:in-app-browsing) documentation.", "11-0": "Pinterest", "11-1": "social", "11-2": "All Pinterest pages. This does not capture traffic driven through the Pinterest app, which is where the majority of Pinterest-driven traffic comes from. To track that, see our [In-app browsing](doc:in-app-browsing) documentation.", "12-0": "Reddit", "12-1": "social", "12-2": "All Reddit pages.", "13-0": "LinkedIn", "13-1": "social", "13-2": "All LinkedIn pages.", "14-0": "StumbleUpon", "14-1": "social", "14-2": "All StumbleUpon pages.", "15-0": "Taboola", "15-1": "sponsored", "15-2": "Taboola's external recirculation unit.", "16-0": "Outbrain", "16-1": "sponsored", "16-2": "Outbrain's external recirculation unit.", "17-0": "ZergNet", "17-1": "sponsored", "17-2": "ZergNet's external recirculation unit.", "19-0": "RevContent", "19-1": "sponsored", "19-2": "RevContent's external recirculation unit.", "18-0": "MGID", "18-1": "sponsored", "18-2": "MGID's external recirculation unit.", "20-0": "AdBlade", "20-1": "sponsored", "20-2": "AdBlade's external recirculation unit.", "21-0": "RadiumOne", "21-1": "sponsored", "21-2": "All qklnk.co traffic." }, "cols": 3, "rows": 22 } [/block] In addition to the list above, we maintain a list of "media" referrers which includes standard newspapers and magazines. Any traffic from one of these gets marked with `referrerType` media and `referrerName` equal to the publication's name. If you'd like a specific referrer to be tracked (for instance, a search engine, social network, external recirculation unit, or publication) please contact [Support](doc:support) with your request. Any addition of referrers only applies to traffic from now onward and does not apply to historical traffic. [block:api-header] { "type": "basic", "title": "Direct and unknown referrerType and referrerName" } [/block] There are two special values of `referrerType` (which also match the associated `referrerName` values): * `direct`: This means that there was no referrer for the session start. This could happen if the user copy/pasted a link from somewhere, or directly typed it into the browser. Some HTTPS referrers may mask themselves and appear as direct traffic. * `unknown`: This means that there was a referrer for the session start, but the referrer did not fit into the classification above. [block:api-header] { "type": "basic", "title": "Places where referrer drilldown can be used" } [/block] * [Analytics Panel](doc:analytics-panel): The referrer type can be used as a drilldown for the performance chart, so that you can get CTR and other metrics filtered to a specific referrer type. Referrer name is not available here. There is also a % of pageviews breakdown by referrer type on the top left. * [RealTime Panel](doc:realtime-panel): You can drill down by either `referrerType` or `referrerName` for the real-time chart as well as for the top clicked and top viewed data. * [Insights Panel](doc:insights-panel): You can drill down by `referrerName` to filter to activity data based on a specific referrer name. [block:api-header] { "type": "basic", "title": "Sharing referrer data if using the activity API" } [/block] For the activity API, you can include, in each activity, the following fields: * `referrer` to denote the referrer that led to the current pageview from which activity is being sent. * `sessionReferrer` to denote the referrer for the user's current session. * `userReferrer` to denote the referrer for the user's first entry to the website or app.