Create and configure XDB Custom Facet

In this post I am describing the required steps to create a custom facet on XDB and how to use it to personalize the experience…

  • Create your Interface extending IFacet
using System;
using System.Linq;
using Sitecore.Analytics.Model.Framework;

namespace Testing.ContactFacets.Model
{
    public interface ICRMSegment : IFacet
    {
        string CRMSegmentId { get; set; }
    }
}
  • Implement your Custom Facet
namespace Testing.ContactFacets.Model
{
    public class CrmSegment : Facet, ICRMSegment
    {
        private const string FIELD_CRMSegmentId = "CRMSegmentId";
        public CrmSegment()
        {
            base.EnsureAttribute< string>(FIELD_EMPLOYEE_ID);
        }
        public string CRMSegmentId
        {
            get { return base.GetAttribute< string>(FIELD_CRMSegmentId ); }
            set { base.SetAttribute< string>(FIELD_CRMSegmentId , value); }
        }
    }
}
  • Register your Facet via config file
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
  <sitecore>
    <model>
      <elements>
        <element interface="Testing.ContactFacets.Model.ICRMSegment,XXX.AssemblyName " implementation="Testing.ContactFacets.Model.CrmSegment, XXX.AssemblyName" />
      </elements>
      <entities>
        <contact>
          <facets>
            <facet name="CRMSegment" contract="Testing.ContactFacets.Model.ICRMSegment, XXX.AssemblyName" />
          </facets>
        </contact>
      </entities>
    </model>
  </sitecore>
</configuration>

  • Create a new XDB Contact
@using Sitecore.Web;
@using Testing.ContactFacets.Model;
@using Sitecore.Analytics.Model.Entities;
@{
 Sitecore.Analytics.Tracker.Current.Session.Identify("stelio.dibello@xxxxx.com");
 var contact =  Sitecore.Analytics.Tracker.Current.Contact;
 var data = contact.GetFacet<ICRMSegment>("CRMSegment");
 data.CRMSegmentId = "BargainHunter";

var personalInfo = Sitecore.Analytics.Tracker.Current.Contact.GetFacet<Sitecore.Analytics.Model.Entities.IContactPersonalInfo>("Personal");

personalInfo.FirstName = "Stelio";
personalInfo.Surname = "Di Bello";
personalInfo.Gender="M";

var contactEmail =  Sitecore.Analytics.Tracker.Current.Contact.GetFacet<IContactEmailAddresses>("Emails");

            // this email to show in the Experience Profiles backend.
 if (!contactEmail.Entries.Contains("Home"))
    {
      contactEmail.Entries.Create("Home");
    }
            // set the email
  var email = contactEmail.Entries["Home"];
  email.SmtpAddress = "stelio.dibello@xxxxx.com";
 contactEmail.Preferred = "Home";
}

CRM data contact facet updated.

Contact ID: @contact.ContactId.ToString() /b>

Employee #: <b> @data.CRMSegmentId </b>

  • Personalize based on CRMSegmentId rule

 

  • crmsegmentpersonalisation
Advertisements

One thought on “Create and configure XDB Custom Facet

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s