一个简单的分段安装

实现段时,将段代码添加到您的网站,应用程序或服务器。此代码基于您定义的特定触发生成消息。

在最简单的实现中,代码可以是一段Javascript代码,您可以将其复制并粘贴到网站的HTML中,以跟踪页面视图。当应用打开或关闭时,当用户执行不同的操作时,或当基于时间的条件满足时(例如“机票预订过期”或“2小时后购物车被抛弃”),它也可以像React手机应用中嵌入的Segment调用一样复杂。

了解Segment如何运作的最好方法就是看看它的实际情况。本教程指导您使用我们的库之一安装:我们的Javascript, PHP,或iOS库。

在你开始之前

在开始之前,您需要一个Segment用户帐户和一个工作区。如果你不是一个有分部工作空间的组织的一部分,你可以这样做注册一个免费的帐户和工作空间

对于下面的快速入门部分,您还需要访问基本网站、PHP网站或iOS应用程序的代码。

提示!如果你没有这些东西,你可以考虑创建一个简单的GitHub页面的网站

关于开发和产品资源的说明

开发和测试时,您应该为每个环境(生产,开发,分期等)创建和使用单独的来源,以防止使用无效数据填充生产系统的测试和开发活动。

你可以给每个来源环境我们强烈建议您使用这些标签来对您的资源进行分类。在以下步骤中创建源时,请确保输入了环境标签。

警告!当您为开发和生产环境输入写入键时,请仔细检查,以确保将正确的数据发送到正确的位置!

创建一个段源

转到Segment工作空间,并导航到源目录

选择的Javascript源,PHP源码,或iOS资源,然后单击添加源

在下一个屏幕上,给出源是一个名称。(我们建议您包含这个词演示,测试,或快速开始以姓名为止,因此您可以轻松查找和稍后删除此源。)

我们还建议您添加环境标签开发到源代码,这样您就知道这个演示源代码不是生产安装的一部分。

找到写作的关键

写键是源的唯一标识符,它告诉Segment数据来自哪个源,属于哪个工作空间,以及哪个目的地应该接收数据。

创建新的库源时,可以在设置用于源的选项卡API密钥。当你在分段应用程序中改变库的设置时,写键就会重新生成。

Cloud-sources没有写键,因为它们使用您的帐户与该服务的令牌或密钥。云源有其他考虑因素,而不是本教程的一部分。

记下或写下你的写作关键,因为你将在接下来的步骤中需要它。

安装段

单击下面的选项卡以查看所选特定库的教程内容。

步骤1:复制Snippet

安装Segment很容易,只需将Javascript Source概述页面中的代码片段粘贴到你网站的标签。

该代码段将Analytics.js加载到页面上异步,所以它不会影响页面加载速度。一旦代码片段在您的站点上运行,您就可以从工作空间中的目的地页面打开目的地,它们就会自动开始在您的站点上加载!

有趣的事实:如果你只想要最基本的谷歌分析设置,你可以立即停止阅读。你已经完成了!只需打开Segment App中的谷歌Analytics。

然而,大量的分析和营销工具需要记录WHO每个用户都在您的网站上。如果要使用处理用户身份的任何工具,请阅读识别方法。

步骤2:识别用户

识别方法是如何告诉Segment当前用户是谁。它包括一个惟一的用户ID,以及您所知道的关于它们的任何可选特征。你可以在识别方法引用

注意:你不需要打电话识别为匿名访客到您的网站。分段自动分配它们anonymousId,所以只是打个电话页面追踪没有工作就没有识别

这是一个基本的呼叫识别的样子:

分析识别(f4ca124298,{的名字:迈克尔·布朗,电子邮件:mbrown@example.com});

通过Michael的唯一用户ID(在本例中,f4ca124298,这就是你在数据库中认识他的),并标记他的名字电子邮件特征。

尽管举起!当您实际将代码放到站点上时,您需要用表示当前登录用户详细信息的变量替换那些硬编码的特征值。

为此,我们建议您使用后端模板注入识别调用到的页脚每页用户登录的站点。这样,无论用户第一次登陆的是哪个页面,他们都会被识别出来。你不需要打电话识别如果您的唯一标识符(用户标识)是未知的。

根据你的模板语言,你实际的identify调用可能看起来像这样:

分析识别({{user.id}},{的名字:{{user.fullname}},电子邮件:{{user.email}}});

使用您的页面页脚中的呼叫,您成功识别访问您网站的每个用户。

第二个有趣的事实:如果您只想使用基本的CRM设置,您可以在这里停止。只需启用Salesforce,对讲机,或任何其他CRM系统从您的段工作空间,段开始发送您的所有用户数据到它!

当然,很多分析工具记录不仅仅是身份他们也会记录每个用户执行的动作!如果你正在寻找一个完整的事件跟踪分析设置,请继续阅读……

步骤3:跟踪行动

追踪方法是如何告诉分段关于您的用户正在您的网站上执行的行动。每个动作都会触发我们所说的“事件”,它也可以有相关的属性。你可以阅读更多追踪在里面跟踪方法引用

这是打电话给你的追踪当用户注册时可能看起来像:

分析追踪(签约,{计划:企业});

这只是告诉我们,用户刚刚触发了签约事件和选择你的假设“企业”计划。属性可以是你想要记录的任何东西,例如:

分析追踪(文章书签,{标题:下雪,副标题:隧道溪的雪崩,作者:约翰分支});

如果您刚刚入门,您应该跟踪的一些事件是指示您网站成功的事件,如签约,物品购买文章书签

为了开始,我们建议您只跟踪几个重要的事件。您可以随时添加更多!

一旦你增加了一些追踪电话,您已经完成了本教程!你成功安装了Analytics.js跟踪。现在你可以在片段应用中打开任何你喜欢的目的地了。

步骤1:安装SDK

iOS上安装Analytics的推荐方法是使用Cocoapods.,因为它意味着您可以创建带有特定绑定目的地的构建,而且它使安装和升级变得简单。

首先,添加分析依赖你的Podfile通过添加以下行:

圆荚体“分析”,~ > 3.0的

然后在你的应用委托中-应用程序:didFinishLaunchingWithOptions:方法,像这样设置SDK:

SEGAnalyticsConfiguration*配置=(SEGAnalyticsConfigurationconfigurationWithWriteKey:@“your_write_key”];配置TrackApplicationLifecycleEvents.=是的;//自动记录特定的应用程序事件配置recordScreenViews=是的;//启用这个记录屏幕视图自动!(SEGAnalyticssetupWithConfiguration:配置];

提示:你不需要要使用初始化配置参数来跟踪生命周期事件(申请已打开,应用程序安装,应用程序更新)和屏幕视图,但我们强烈建议你这样做,你可以开始跟踪一些重要的核心事件。

当然,通过添加下面这行代码,将SDK导入到你使用的文件中:

# <分析/进口SEGAnalytics.h >

捆绑客户端SDK

为了保持Segment SDK的轻量级分析pod只安装Segment库。这意味着所有的数据首先到Segment的服务器,然后转发到任何接收数据的目标工具从细分市场

有些目的地不接受来自Segment服务器的数据,而是要求您从设备收集数据。在这些情况下,您必须将一些额外的目标代码与Segment SDK捆绑在一起。

我们暂时跳过这一部分,但你可以看到上面的说明如何捆绑目标工具

现在SDK安装并设置,您可以开始拨打电话!

步骤2:识别用户

识别方法是如何告诉Segment当前用户是谁。它需要一个唯一的用户ID,以及您了解它们的任何可选特征。你可以在确定参考

这是一个基本的呼叫识别的样子:

[[SEGAnalyticssharedAnalytics]识别:@“f4ca124298”特征:@ {@“名称”:@“迈克尔·布朗”,@“电子邮件”:@“mbrown@example.com”});

该调用通过他唯一的用户ID识别Michael(f4ca124298这是你在数据库中认识他的名字),并给他贴上标签的名字电子邮件特征。

尽管举起!当你把代码放到iOS应用中时,你需要用代表当前登录用户细节的变量替换那些硬编码的特征值。

一旦你添加了识别打电话,你已经准备好继续跟踪!

步骤3:跟踪行动

追踪方法是您如何介绍您在应用程序中执行的操作的段。每个动作都会触发我们所说的“事件”,它也可以有相关的属性。你可以阅读更多追踪在里面跟踪方法引用

要开始,段IOS SDK可以自动跟踪一些重要的常见事件,例如应用程序安装,应用程序更新申请已打开。通过添加以下行,可以在初始化期间启用此选项。

SEGAnalyticsConfiguration*配置=(SEGAnalyticsConfigurationconfigurationWithWriteKey:@“your_write_key”];配置TrackApplicationLifecycleEvents.=是的;(SEGAnalyticssetupWithConfiguration:配置];

您还应该跟踪在您的移动应用程序中表明成功的事件,如签约,物品购买文章书签。我们建议只跟踪一些重要的事件。您可以随时添加更多!

这是一个追踪当用户注册时,呼叫可能看起来像:

[[SEGAnalyticssharedAnalytics]追踪:@“签约”属性:@ {@“计划”:@“企业”});

这告诉我们你的用户触发了签约事件,然后选择你的假设“企业”计划。属性可以是你想要记录的任何东西,例如:

[[SEGAnalyticssharedAnalytics]追踪:@“书签条”属性:@ {@“标题”:@“下雪”,@“字幕”:“隧道溪的雪崩”,@“作者”:@“约翰分支”});

一旦你添加了一些追踪电话,你设置!您成功地检测了您的应用程序,并可以从您的分段工作空间启用目的地。

步骤1:下载库

要安装这个库,请将这个库从GitHub克隆到你想要的应用程序目录中。(嘘,作曲家用户:我们已经也帮你搞定了!)

Git克隆https://github.com/segmentio/analytics-php /my/application/folders/

然后,在你的PHP脚本中添加以下内容,以加载代码中的Segment分析库:

Request_once.(“/道路/ / analytics-php / lib / Segment.php”);

现在,您已经准备好实际初始化模块了。在我们的例子中,我们首先将这个模块重命名为分析为了方便。在初始化脚本中,执行以下调用:

#设置我们的段跟踪和# alias to Analytics for convenienceclass_alias(“段”,“分析”);部分::初始化(“YOUR_WRITE_KEY”);

取代YOUR_WRITE_KEY你可以在项目设置下的分段中找到。否则所有有用的数据就会直接/ dev / null

你只需要打电话初始化当您的PHP文件被请求时。所有的文件都可以访问相同的分析客户端。

笔记:默认的PHP使用者是libcurl消费者。如果这对你来说不是很好,或者如果你有一个大容量的项目,你可以尝试Segment的其他消费者之一fork-curl消费者

都准备好了吗?很好,图书馆已经完全安装好了!现在我们已经准备好开始记录关于用户的第一次分析电话。

步骤2:识别用户

识别方法是如何告诉Segment当前用户是谁。它包括一个惟一的用户ID和任何您可能知道的可选特征。

这是一个基本的呼叫识别的样子:

部分::识别(大批(“用户身份”=>“f4ca124298”,“特征”=>大批(“名称”=>“迈克尔·布朗”,“电子邮件”=>“mbrown@example.com”)));

通过Michael的唯一用户ID(在本例中,f4ca124298,这就是你在数据库中认识他的),并标记他的名字电子邮件特征。

尽管举起!当您实际将代码放到站点上时,您需要用表示当前登录用户详细信息的变量替换那些硬编码的特征值。PHP中最简单的方法是保存一个$用户记忆中的变量。

部分::识别(大批(“用户身份”=>$用户->id,“特征”=>大批(“名称”=>$用户->全名,“电子邮件”=>$用户->电子邮件)));

使用该页面上的呼叫,您现在已成功识别访问您网站的每个用户。

如果您只想使用基本的CRM设置,您可以在这里停止。只需启用Salesforce,对讲机,或任何其他CRM系统从您的段工作空间,段开始发送您的所有用户数据到它!

当然,很多分析工具记录不仅仅是身份他们也会记录每个用户执行的动作!如果你正在寻找一个完整的事件跟踪分析设置,请继续阅读……

步骤3:跟踪行动

追踪方法是如何告诉分段关于您的用户正在您的网站上执行的行动。每个动作都会触发我们所说的“事件”,它也可以有相关的属性。

这是打电话给你的追踪当用户注册时可能看起来像:

部分::追踪(大批(“用户身份”=>“f4ca124298”,“事件”=>“注册”,“属性”=>大批(“计划”=>“企业”)));

这告诉我们用户触发了签约事件,然后选择你的假设企业计划。属性可以是你想要记录的任何东西,例如:

部分::追踪(大批(“用户身份”=>“f4ca124298”,“事件”=>“书签文章”,“属性”=>大批(“标题”=>“雪落”,“字幕”=>《隧道溪的雪崩》,“作者”=>“约翰分支”)));

如果您刚刚入门,您应该跟踪的一些事件是指示您网站成功的事件,如签约,物品购买文章书签

为了开始,我们建议只跟踪几个重要的事件。您可以随时添加更多!

一旦你添加了一些追踪电话,你差不多做完了。

第4步:刷新数据

最后,叫细分冲洗()方法。这手动发送所有排队调用数据,以确保它使之到Segment服务器。这通常是由运行时自动完成的,但是一些PHP安装不会为您完成,所以为了安全起见,值得在脚本的最后调用它。

部分::冲洗();

转眼间,你已经完成了!您成功安装了PHP跟踪。现在,您已准备好打开您从段应用程序的任何目的地。

测试它是否有效

一旦您设置了段库,并且录制了至少一个呼叫,您可以查看调试器选项卡以获取源代码以检查它根据预期的数据产生数据。

源调试器是一个实时工具,可帮助您确认从您的网站,移动应用程序或服务器进行的API调用到达您的段源,因此您可以快速查看段源收到呼叫,因此您可以进行故障排除很快就不必等待数据处理。

调试器是独立于您的工作空间的数据管道,并且不是发送到您的段工作空间的所有事件的详尽视图。调试器只显示Source实时接收到的事件的一个示例,最多500个事件。调试器是测试实现的特定部分的好方法,以验证事件是否被成功触发并到达您的Source。

提示要查看所有事件的更完整的视图,你可以考虑设置一个仓库或者一个S3目的地

调试器显示了到达源的实时采样事件流,但您也可以从“Live”到“暂停”,以停止流并阻止它显示新事件。事件继续在您暂停流的同时到达您的来源,它们刚刚显示。

您可以在调试器中搜索事件有效负载中可用的任何信息,并只显示匹配的有效负载。您还可以使用高级搜索选项将结果限制到特定事件。

当查看有效负载时,有两个视图可用:

  • 漂亮的观点是您所做的API调用的娱乐,该呼叫被发送到段。
  • 原始视图是从发送的调用中收到的完整JSON对象段。这些调用包括有关正在跟踪的内容的所有详细信息:时间戳,属性,特征,ID和上下文信息段自动收集数据被发送的那一刻。

我们将更多地讨论调试和故障排除在后面的页面

设定你的第一个目的地

一旦您对新数据源的数据到达感到满意,就该设置您的第一个目的地了!和你一样久页面屏幕数据来自来源,您可以快速启用Google Analytics来查看页面视图统计信息。

如果您没有Google Analytics帐户,则可以设置一个免费帐户,或查看不同目标的目标目录以启用。

你需要谷歌Analytics的跟踪ID(一个“网站”或“服务器端”的跟踪ID),或者另一个API密钥,如果你要替换另一个目的地。记下这个ID或密钥,因为您需要它来连接您的目的地。

要设置第一个目的地:

  1. 转到您的分段工作区,单击目的地,然后单击添加目的地目录
  2. 搜索要添加的目标。在本例中,搜索谷歌分析
  3. 单击要目的地的图块以查看有关它的信息。
  4. 点击配置谷歌分析
  5. 选择您前面在快速入门中设置的源,然后单击确认来源
  6. 在设置页面上,找到要连接到目的地的跟踪ID或其他API键的设置行。
  7. 输入ID或API密钥,然后单击保存
  8. 点击回到目的地,然后单击切换以启用目标。

恭喜你!数据现在从您设置的源流向第一个目的地。在你的网站或应用上做一些浏览测试,然后登录到你的下游工具去查看数据。

你可以点击并加载页面来查看你的Segment调用,在调试器中查看它们到达,并在目标工具中查看它们到达。

笔记当你完成了这个测试源和目标,你可以删除它们。这可以防止以后在生产环境中获得计划外的“演示”数据。

最后更改:08年12月2020



开始分段

段是将网站和移动应用程序数据集成到超过300个分析和增长工具的最简单方法。
创建免费帐户