README

注意：是 Snowplow Referer Parser 的分支

referer-parser

referer-parser 是一个用于从 referer URL 中提取营销归因数据（如搜索词）的数据库，受 ua-parser 项目（用户代理解析的等效库）的启发。

referer-parser 项目还包含多个库，用于在不同语言中与 referer-parser 数据库协同工作。

referer-parser 是开源的基于 Hadoop 和 Redshift 的 Web 规模分析平台 Snowplow 的核心组件。

请注意，我们在此项目中始终使用原始的 HTTP 错别字“referer”（以及“referal”），而不是“referrer”。

数据库

最新数据库始终可在以下 URL 上获得

https://s3-eu-west-1.amazonaws.com/snowplow-hosted-assets/third-party/referer-parser/referers-latest.yml

数据库最多每月更新一次。每个新版本的数据库也会附带时间戳上传

https://s3-eu-west-1.amazonaws.com/snowplow-hosted-assets/third-party/referer-parser/referers-YYYY-MM.yml

如果在一个月内需要重新发布数据库以解决问题，相应的文件将被覆盖。

维护者

• PHP: Lars Strojny
• referers.yml: Snowplow Analytics

使用方法

此库的 PHP 版本使用更新后的 API，并识别搜索、社交、网络邮件、内部和未知引用者

use Snowplow\RefererParser\Parser;

$parser = new Parser();
$referer = $parser->parse(
    'http://www.google.com/search?q=gateway+oracle+cards+denise+linn&hl=en&client=safari',
    'http://www.psychicbazaar.com/shop'
);

if ($referer->isKnown()) {
    echo $referer->getMedium(); // "Search"
    echo $referer->getSource(); // "Google"
    echo $referer->getSearchTerm();   // "gateway oracle cards denise linn"
}

有关更多信息，请参阅 PHP README。

贡献

我们欢迎对 referer-parser 的贡献

1. 新的搜索引擎和其他引用者 - 如果您注意到 referers.yml 中缺少搜索引擎、社交网络或其他网站，请分支仓库，添加缺少的条目并提交拉取请求
2. 将 referer-parser 端口移植到其他语言 - 我们欢迎将 referer-parser 移植到新的编程语言（例如 Lua、Go、Haskell、C）
3. 错误修复、功能请求等 - 非常感谢！

在提交拉取请求之前，请签署 Snowplow CLA。

支持

referer-parser 的一般支持由 Snowplow Analytics Ltd. 的团队处理。

您可以通过他们维基上列出的任何 渠道 联系 Snowplow Analytics 团队。

版权和许可

referers.yml 基于 Piwik 的 SearchEngines.php 和 Socials.php，版权 2012 Matthieu Aubry，可在 GNU General Public License v3 下使用。

PHP 端口版权所有 2013-2014 Lars Strojny，可在 MIT License 下使用。