マージコンタクト

マージロジック

マージプロセスは2つの別々の通話に分かれています。最初の通話では以下のことが起こります。

• すべての値面は、ファセットがすでにターゲットコンタクト上に存在する場合を除き、ソースコンタクトからターゲットコンタクトへコピーされます。例えば、ターゲットコンタクトにすでに PersonalInformation ファセットがある場合、それはソースコンタクトの PersonalInformation ファセットによって上書きされません。

!注Experience OptimizationのTestCombinationsファセットは異なる挙動をします。匿名の接触者がテストの組み合わせに触れ、セッションの途中で自己を特定した場合、既知の接触者のテストの組み合わせの側面は上書きされます。

• 計算されたファセットマージハンドラが実行されます。
• 匿名連絡先の登録は放棄されます。つまり:
  • AutomationPlanEnrollmentCache面は統合されていません
  • AutomationPlanExit面は統合されていません
• すべてのファセット値はソースの接点から削除されます。
• 既知の識別子はすべて送信元連絡先からターゲット接触者へ移動され、匿名識別子は移動されません。既知の識別子がなければ、送信元連絡先は匿名になります。
• 相互作用の側面を含むすべての相互作用は、ソース接触からターゲット接触へコピーされます。相互作用はソース接触から削除 されません 。
• ソース接触には以下のプロパティ値を持つ MergeInfo 面が追加されます:
  • MergeDate - 合併運転の日時
  • Obsolete - これから true
  • SuccessorContactId - ターゲット接触者のID
• 匿名の識別子がターゲットコンタクトに追加されます。識別子は送信元コンタクトの ID であり、送信元は次のように定義されます。 Sitecore.XConnect.Constants.MergeIdentifierSource
• 操作が正常に完了すると、ターゲットおよびソースの接触点のファスレットや識別子がメモリ上で更新されます。

この時点で、すべての変更が保存され、リポジトリからコピーされた新しいインタラクションにIDが割り当てられます。2回目の呼び出しでは以下のことが起こります。

• InteractionMergeInfo面は、ソース連絡先に属するすべてのやり取りに追加され、以下の重要な情報が含まれます。

  • SuccessorInteractionId - この相互作用を置き換える相互作用のID。

  • SuccessorContactId - 後継者の相互作用を所有するコンタクトのID。

  !注InteractionMergeInfo面はSitecore.XConnect.Collection.ContactMerge.Modelという別のマージモデルの一部です。このモデルはコアモデルの一部ではなく、Content DeliveryやContent Managementのようなクライアントにはデフォルトで存在しません。

カスタムマージハンドラ

計算されたファセットには計算されたファセットマー ジハンドラを作成する 必要があります。カスタムマージロジックが必要な場合もあります。バリューファセットは自動的にマージされます。ただし、そのファセットがカスタムマージロジックを必要とする場合は、そのファセットのマージハンドラを作成できます。

情報源とターゲットの連絡先を入手してください

ソースコンタクトとターゲットコンタクトは、ターゲットコンタクトの識別子とソースコンタクトのファセットでリンクされます。マージ中にソースコンタクトは削除されません。

以下の例は、ソースコンタクトが統合されたコンタクトを取得する方法を示しています。

using Sitecore.XConnect.Collection.Model; using System; using System.Threading.Tasks; using Sitecore.XConnect; using Sitecore.XConnect.Client;

namespace Documentation { public class GetTargetContacts { // Async example public async void ExampleAsync() { using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient()) { try { var sourceContactId = Guid.Parse("77f75056-5d96-4155-93e5-d206214d6a40");

// Get source contact - this is an obsolete contact that has been used // in a merge operation Task contactTask = client.GetAsync(new ContactReference(sourceContactId), new ContactExecutionOptions(new ContactExpandOptions()));

Contact contact = await contactTask;

// Get the merge facet - you do not need to request this facet as part of the expand options var mergeFacet = contact.GetFacet(MergeInfo.DefaultFacetKey);

if (mergeFacet != null) { // If the merge facet exists, use the SuccessorContactId to retrieve the target contact that // the source contact was merged into var targetContactTask = client.GetAsync(new ContactReference(mergeFacet.SuccessorContactId), new ContactExecutionOptions(new ContactExpandOptions()));

var targetContact = await targetContactTask; } } catch (XdbExecutionException ex) { // Manage exceptions } } }

// Sync example public void ExampleSync() { using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient()) { try { var sourceContactId = Guid.Parse("77f75056-5d96-4155-93e5-d206214d6a40");

// Get source contact - this is an obsolete contact that has been used // in a merge operation Contact contact = client.Get(new ContactReference(sourceContactId), new ContactExecutionOptions(new ContactExpandOptions()));

// Get the merge facet - you do not need to request this facet as part of the expand options var mergeFacet = contact.GetFacet(MergeInfo.DefaultFacetKey);

if (mergeFacet != null) { // If the merge facet exists, use the SuccessorContactId to retrieve the target contact that // the source contact was merged into var targetContact = client.GetAsync(new ContactReference(mergeFacet.SuccessorContactId), new ContactExecutionOptions(new ContactExpandOptions())); } } catch (XdbExecutionException ex) { // Manage exceptions } } } } }

以下の例は、特定の接点のマージ操作で以前にソース接点として使用された接点の取得方法を示しています。

using Sitecore.XConnect.Collection.Model; using Sitecore.XConnect.Operations; using System; using System.Threading.Tasks; using Sitecore.XConnect; using Sitecore.XConnect.Client; using System.Linq; using System.Collections.Generic;

namespace Documentation { public class GetMergedContacts { // Async example public async void ExampleAsync() { using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient()) { try { // Get contact Task contactTask = client.GetAsync(new IdentifiedContactReference("twitter", "myrtlesitecore"), new ContactExecutionOptions(new ContactExpandOptions()));

Contact contact = await contactTask;

// Get all identifiers pointing to source contacts that were merged into this contact var mergeIdentifiers = contact.Identifiers.Where(x => x.Source == Sitecore.XConnect.Constants.MergeIdentifierSource);

if (mergeIdentifiers.Any()) { // Build a list of ContactReference objects from the merge identifiers - the identifier // string is the ID of a source contact var mergedContactReferences = new List();

foreach (var mergeIdentifier in mergeIdentifiers) { Guid id = Guid.Empty;

if (Guid.TryParse(mergeIdentifier.Identifier, out id)) { ContactReference reference = new ContactReference(id);

mergedContactReferences.Add(reference); } }

// Get all contacts that were previously merged into this contact var contactsTask = client.GetAsync(mergedContactReferences.ToArray(), new ContactExecutionOptions(new ContactExpandOptions()));

var contacts = await contactsTask; }

} catch (XdbExecutionException ex) { // Manage exceptions } } }

// Sync example public void ExampleSync() { using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient()) {

try { // Get contact Contact contact = client.Get(new IdentifiedContactReference("twitter", "myrtlesitecore"), new ContactExecutionOptions(new ContactExpandOptions()));

// Get all identifiers pointing to source contacts that were merged into this contact var mergeIdentifiers = contact.Identifiers.Where(x => x.Source == Sitecore.XConnect.Constants.MergeIdentifierSource);

if (mergeIdentifiers.Any()) { // Build a list of ContactReference objects from the merge identifiers - the identifier // string is the ID of a source contact var mergedContactReferences = new List();

foreach (var mergeIdentifier in mergeIdentifiers) { Guid id = Guid.Empty;

if (Guid.TryParse(mergeIdentifier.Identifier, out id)) { ContactReference reference = new ContactReference(id);

mergedContactReferences.Add(reference); } }

// Get all contacts that were previously merged into this contact var contacts = client.Get(mergedContactReferences.ToArray(), new ContactExecutionOptions(new ContactExpandOptions())); }

} catch (XdbExecutionException ex) { // Manage exceptions } } } } }

制限事項と推奨される慣行

接触マージ操作には以下の制限が適用されます:

• もし連絡先がすでにソースとして使われている場合、つまり匿名で MergeInfo 的な側面がある場合、別のマージ操作でソース連絡先として使うことはできません。例外が付与されます。
• 両方の連絡先をxConnectに保存しておく必要があります。つまり、マージを試みる前に client.SubmitAsync() に連絡しなければならないということです。 AddContact と Merge を同じバッチで混ぜることはできません。
• マージを行う同じバッチ内でソースコンタクトに識別子を追加することはできません。もしソースコンタクトに識別子を追加する必要がある場合は、そのバッチを提出し、次のバッチでマージを行う必要があります。
• 既知の接触者(情報源)を匿名の接触者(ターゲット)に統合することはできません。既知の接触者がターゲットでなければなりません。ただし、既知の連絡先を既知のものに、匿名のものを匿名に統合することは可能です。

!重要コンタクトマージ操作はバッチごとに1回の操作として実行することを強く推奨します。このプロセスにより、マージ操作で使われた接触を取得または変更する他の操作がなくなります。

長い連結された連絡先を作ることに注意してください。これは、既知から既知に、匿名から匿名に繰り返し合併すると起こり得ます: