Skip to content

Commit be86377

Browse files
committed
Merge branch 'data-jun-2017'
2 parents 90d7ce7 + e78a652 commit be86377

File tree

3 files changed

+381
-52
lines changed

3 files changed

+381
-52
lines changed

CHANGELOG

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
Release June 2017 (2017-06-12)
2+
------------------------------
3+
Documentation: correct authors in README (#148)
4+
Documentation: add new section about hosted database (#150)
5+
Database: add preliminary list of paid sources
6+
Database: add some ANZ's largest ISPs' web mail domains and search engine domains (Dodo, Telstra, Optus, 2degrees, iiNet, Virgin, Vodafone etc)
7+
Database: add various other search engines (SosoDesk - unrelated to Soso)
8+
Database: add Ukrainian search providers ukr.net and i.ua
9+
Database: add belarusian search provider tut.by
10+
Database: add kununu
11+
Database: add outlook.live.com to list of Outlook.com email referrers
12+
Database: add t.umblr domain to Tumblr
13+
Database: merge Chinese Soso search engine under Sogou
14+
Database: fix for ITU as it was incorrectly indented
15+
Database: remove duplicated domains e.g. Comcast
16+
Database: move Taboola and Outbrain from "unknown" section to paid sources
17+
Database: move some domains into alphabetical order

README.md

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,31 @@
22

33
Java/Scala: [![Build Status](https://travis-ci.org/snowplow/referer-parser.png)](https://travis-ci.org/snowplow/referer-parser)
44

5-
referer-parser is a multi-language library for extracting marketing attribution data (such as search terms) from referer URLs, inspired by the [ua-parser] [ua-parser] project (an equivalent library for user agent parsing).
5+
referer-parser is a database for extracting marketing attribution data (such as search terms) from referer URLs, inspired by the [ua-parser] [ua-parser] project (an equivalent library for user agent parsing).
6+
7+
The referer-parser project also contains multiple libraries for working with the referer-parser database in different languages.
68

79
referer-parser is a core component of [Snowplow] [snowplow], the open-source web-scale analytics platform powered by Hadoop and Redshift.
810

911
_Note that we always use the original HTTP misspelling of 'referer' (and thus 'referal') in this project - never 'referrer'._
1012

13+
## Database
14+
15+
The latest database is always available on this URL:
16+
17+
https://s3-eu-west-1.amazonaws.com/snowplow-hosted-assets/third-party/referer-parser/referers-latest.yml
18+
19+
The database is updated at most once a month. Each new version of the database is also uploaded with a timestamp:
20+
21+
https://s3-eu-west-1.amazonaws.com/snowplow-hosted-assets/third-party/referer-parser/referers-YYYY-MM.yml
22+
23+
If there is an issue with the database necessitating a re-release within the month, the corresponding files will be overwritten.
24+
1125
## Maintainers
1226

1327
* Java/Scala: [Snowplow Analytics Ltd] [snowplow-analytics]
1428
* Ruby: [Kelley Reynolds] [kreynolds] at Inside Systems, Inc
15-
* Python: [Don Spaulding] [donspaulding]
29+
* Python: [Don Spaulding] [donspaulding]
1630
* node.js (JavaScript): [Martin Katrenik] [mkatrenik]
1731
* .NET (C#): [Sepp Wijnands] [swijnands] at [iPerform Software] [iperform]
1832
* PHP: [Lars Strojny] [lstrojny]
@@ -299,9 +313,9 @@ The node.js (JavaScript) port is copyright 2013-2014 [Martin Katrenik] [mkatreni
299313

300314
The .NET (C#) port is copyright 2013-2014 [iPerform Software] [iperform] and is available under the [Apache License, Version 2.0] [apache-license].
301315

302-
The PHP port is copyright 2013-2014 [Lars Strojny] [tsileo] and is available under the [MIT License] [mit-license].
316+
The PHP port is copyright 2013-2014 [Lars Strojny] [lstrojny] and is available under the [MIT License] [mit-license].
303317

304-
The Go port is copyright 2014 [Thomas Sileo] [lstrojny] and is available under the [MIT License] [mit-license].
318+
The Go port is copyright 2014 [Thomas Sileo] [tsileo] and is available under the [MIT License] [mit-license].
305319

306320
[ua-parser]: https://github.com/tobie/ua-parser
307321

0 commit comments

Comments
 (0)