sitecore系列教程之如何以编程方式将访客数据关联到联系人卡片

​

在我之前关于Sitecore体验资料的帖子中，我们看到了我们如何了解访问者的一切，包括访问他们在访问期间触发的事件。在这篇博客文章中，我将引导您完成识别匿名用户并将用户访问与联系人记录联系起来的过程，这将使我们能够查看联系人的访问历史并了解有关我们联系人的更多信息。

Sitecore的API提供了各种方法来识别访问者并将有关访问者的各种详细信息与联系人记录联系起来。

如何识别匿名访客？

这是识别匿名访客过程中的主要要求之一，以下是我们可以尝试通过各种用户操作捕获有关访问者的信息的一些方法，其中一些列在下面

• 登录网站（注册，使用社交媒体，如Facebook，Twitter等）
• 在网站上提交表格（联系我们，反馈等）
• 使用他们的电子邮件地址订阅时事通讯，文章，白皮书

以上所有选项都需要用户至少向我们提供他们的电子邮件地址，从那里我们可以将唯一的电子邮件地址绑定到访问者。

Sitecore开箱即用，为我们提供了许多方面来存储有关联系人的其他信息。这些数据可以帮助我们填写Sitecore体验资料。

这些方面在此配置{root} \ Website \ App_Config \ Include \ Sitecore.Analytics.Model.config

sourcecode language =“xml”

<facets>

<facet name =“Personal”contract =“Sitecore.Analytics.Model.Entities.IContactPersonalInfo，Sitecore.Analytics.Model”/>

<facet name =“Addresses”contract =“Sitecore .Analytics.Model.Entities.IContactAddresses，Sitecore.Analytics.Model“/>

<facet name =”Emails“contract =”Sitecore.Analytics.Model.Entities.IContactEmailAddresses，Sitecore.Analytics.Model“/>

<facet name =”电话号码“contract =”Sitecore.Analytics.Model.Entities.IContactPhoneNumbers，Sitecore.Analytics.Model“/>

<facet name =”Picture“contract =”Sitecore.Analytics.Model.Entities。IContactPicture，Sitecore.Analytics.Model“/>

</ facets>

/ sourcecode

将访客的电子邮件地址存储到联系人记录中

我们将使用电子邮件方面 将当前访客的电子邮件地址存储到当前联系人记录中。在电子邮件方面，您可以通过为每个电子邮件地址提供密钥来指定任意数量的电子邮件地址，如下所示，我提供了名为Work Email的 密钥用于存储访问者工作电子邮件地址。您还可以将特定电子邮件地址关联为首选 电子邮件地址，然后将其用于使用电子邮件地址识别联系人。

Sitecore允许您使用电子邮件地址搜索体验资料中的联系人

sourcecode language =“csharp”

if（Sitecore.Analytics.Tracker.Current.Contact！= null）

{

var emailFacet = Tracker.Current.Contact.GetFacet <IContactEmailAddresses>（“Emails”）;

//检查联系人

是否已存在工作电子邮件地址if（！emailFacet.Entries.Contains（“工作电子邮件”））

{

IEmailAddress email = emailFacet.Entries.Create（“工作电子邮件”）;

email.SmtpAddress =“访客的电子邮件地址”;

emailFacet.Preferred =“工作电子邮件”;

}

}

/源代码

将访客的个人信息存储到联系人记录中

我们将使用Personal facet 将当前访问者的个人信息存储到当前联系人记录中.Sitecore允许您使用任何名称属性（如FirstName，LastName，Surname）搜索体验配置文件中的联系人。

sourcecode language =“csharp”

if（Sitecore.Analytics.Tracker.Current.Contact！= null）

{

var personalFacet = Tracker.Current.Contact.GetFacet <IContactPersonalInfo>（“Personal”）;

personalFacet.Title =“Name_Title”;

personalFacet.FirstName =“First_Name”;

personalFacet.MiddleName =“Middle_Name”;

personalFacet.Surname =“Last_Name”;

personalFacet.Gender =“性别”;

personalFacet.JobTitle =“Job_Title”;

personalFacet.BirthDate = new DateTime（1983,01,01）;

}

/源代码

将访客的电话号码存储到联系人记录中

我们将使用电话号码方面 将当前访客的电话号码存储到当前的联系人记录中。在电话号码 方面，您可以通过为每个电话号码提供密钥来指定任意数量的电话号码，如下所示我有提供称为手机 的密钥来存储访客的手机号码。您还可以将特定号码关联为首选 电话号码。

sourcecode language =“csharp”

if（Sitecore.Analytics.Tracker.Current.Contact！= null）

{

var phoneFacet = Tracker.Current.Contact.GetFacet <IContactPhoneNumbers>（“Phone Numbers”）;

if（！phoneFacet.Entries.Contains（“Cell Phone”））

{

IPhoneNumber cellPhone = phoneFacet.Entries.Create（“Cell Phone”）;

cellPhone.CountryCode =“001”;

cellPhone.Number =“612-000-0000”;

cellPhone.Extension =“8455”;

phoneFacet.Preferred =“手机”;

}

}

/源码

将访客的图像/图片存储到联系人记录中

我们将使用Picture facet 将当前访客的图片存储到当前的联系人记录中，

sourcecode language =“csharp”

if（Sitecore.Analytics.Tracker.Current.Contact！= null）

{

MediaItem mediaItem = Sitecore.Context.Database.GetItem（“媒体项目的指南”）;

var stream = mediaItem.GetMediaStream（）;

var memoryStream = new MemoryStream（）;

if（stream！= null）stream.CopyTo（memoryStream）;

var pictureFacet = Tracker.Current.Contact.GetFacet <IContactPicture>（“Picture”）;

pictureFacet.Picture = memoryStream.ToArray（）;

pictureFacet.MimeType = mediaItem.MimeType;

}

/源代码

如何识别已知访客？

一旦我们使用上述方法存储了有关访问者的信息，Sitecore就允许我们使用Sitecore.Analytics.Tracker.Current.Session.Identify方法识别已知访问者。此方法接受一个字符串变量，该变量是访问者的电子邮件地址。

sourcecode language =“csharp”

var identifiers = Sitecore.Analytics.Tracker.Current.Contact.Identifiers;

if（identifiers.IdentificationLevel == ContactIdentificationLevel.Anonymous）

{

Sitecore.Analytics.Tracker.Current.Session.Identify（“访客的电子邮件地址”）;

}

/ sourcecode

摘要

使用Sitecore的新API，开发人员现在可以更轻松地关联访问者的各种信息并将其与联系人卡片联系起来，这将极大地帮助营销人员更好地了解访问者。一旦我们能够使用电子邮件地址关联访问者，我们还可以使用来自CRM系统（如Salesforce或Dynamics）的信息更新记录。