接触者の特定

接触者識別とは、現在のセッション、デバイス、連絡先セッションを 識別子に接続するプロセスです。 IContactIdentificationManager.IdentifyAs() 方法を使って連絡先を特定します。例えば:

!重要Sitecore.Analytics.Tracking.Identification.IContactIdentificationManager一時的なサービスです。

var identificationManager = Sitecore.DependencyInjection.ServiceLocator.ServiceProvider.GetRequiredService<Sitecore.Analytics.Tracking.Identification.IContactIdentificationManager>(); Sitecore.Analytics.Tracking.Identification.IdentificationResult result = identificationManager.IdentifyAs(new Sitecore.Analytics.Tracking.Identification.KnownContactIdentifier("twitter", "myidentifier"));

if(!result.Success) {   //check result.ErrorCode and result.ErrorMessage for more details }

!注Sitecore.Context.Siteによって異なり、利用可能な文脈で解決しなければなりません。

匿名の連絡先のセッション中にIdentifyAs() が呼ばれた場合、以下のいずれかが発生します。

• 識別子が存在しない場合は、識別子が作成されます。現在の連絡先が知られてしまいます。
• 識別子が存在する場合、既存の既知連絡先がxConnectから読み込まれ、匿名連絡先と統合されます。
• 明示的な同意が必要であっても連絡先から同意が提供されない場合、または連絡先が同意を取り消した場合、身分証明は失敗します。

IdentifyAsメソッドは以下の性質を含むSitecore.Analytics.Tracking.Identification.IdentificationResultオブジェクトを返します。

• ブール Success プロパティです。識別が失敗した場合、プロパティは false に設定されます。
• 失敗した結果のエラーコードを含む ErrorCode プロパティ(文字列)。
• 失敗した結果に関するメッセージを含む ErrorMessage プロパティです。

識別子は識別子と送信元から成ります。識別子はユーザー名のような連絡先に関する一意情報であり、識別子の出所は識別子の出所を示します。連絡先は複数の識別子を持つことがあります。以下の表は、既知の識別子と情報源のいくつかの例を示します。

識別子

出典

マートルサイトコア

ツイッター

m_McSitecore

ブランドエクストラネット

ABC10769150

Facebookauth

!重要匿名の識別子を使って連絡先を特定することはできません。このルールの唯一の例外は、エイリアズ識別子です。

トラッカー識別子

あなたのウェブサイトを訪れたすべての連絡先には匿名のトラッカー識別子があります。そのトラッカー識別子はSitecore.Analytics.Tracker.Current.Contact.ContactIdプロパティに一致し、xConnectの連絡先のIDとは異なります。詳細については「 Set連絡先の側面 」トピックをご参照ください。

識別するタイミング

識別は認証とは別物で、通常同時に行われます。しかし、一度デバイス上で連絡先が特定されると、トラッカーは 分析クッキー を使って、ASP.NETセッションクッキーが削除されても自動的にその連絡先を再識別(再認証せず)します。

ご要望に応じて、デバイス間で連絡先を特定するための異なる識別戦略を実装できます。例えば:

シナリオ

識別

連絡先ログイン。

ユーザー名は識別子として使えます。ログインが成功すればIdentifyAs("usernamesource", "username")を呼び出します。

メールを開くメールリンクはメール Experience Manager から送信されます。

メールリンクにはクエリ文字列に連絡先の別名識別子が含まれています。このデータは連絡先を特定するために使用されます。

以下の例では、連絡先の識別は連絡先がログインに成功した後に行われます: