1. 連絡先

連絡先識別子

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

連絡先識別子は、xDB外のシステムに対して連絡先を一意に識別します。有効な識別子の例としては、ウェブサイトのログイン情報、ソーシャルメディアのハンドル名、広告ネットワークIDなどがあります。識別子はSitecore.XConnect.ContactIdentifierクラスで表されます。各識別子は以下のもので構成されています:

  • ユーザー名のようなIdentifier
  • 識別子 Sourceは、識別子の出所を表すもので、例えば「twitter」など
  • 識別子 ContactIdentifierType、 ContactIdentifierType.Anonymous またはのいずれかです ContactIdentifierType.Known

Sitecore.XConnect.Contact上のIsKnownプロパティは、接触に既知の識別子がある場合に真を返します。

データストレージレベルでは、接触識別子は別のテーブルまたはコレクションに保存されます。以下の制限が適用されます:

  • IdentifierおよびSourceの性質は大文字大文字に区別されており、比較はバイトレベルで行われます。
  • 識別子とソースは VARBINARYとして格納されます。識別子は 700バイトに制限され、ソース は50文字に制限されています。

!注識別子にアポストロフィや横タブは使わないでください。これらはサポートされていません。

識別子の一意性

接触はIdentifierとSourceの組み合わせで一意に識別されます。この要件は以下のシナリオをサポートします。

  • 同じユーザー名を複数のシステムで使う連絡先―例えば、TwitterやSlackでmyrtlesitecoreを使っている場合など
  • 同じユーザー名を使う2人の異なる連絡先 - 例えば、Instagramの サイトコア を使っている連絡先1と、Twitterの サイトコア を使う連絡先2

1つの連絡先には複数の識別子が存在します

単一の連絡先に複数の識別子を持つことができます。連絡先の識別子はContactクラスのIdentifiersプロパティで表されます。識別子の扱い方については以下のトピックを参照してください。

トラッカー識別子

あなたのウェブサイトとやり取りした連絡先には、初めて訪問者した際に作成されるトラッカー識別子があります。これは既知の連絡先や匿名の連絡先に適用されます。追跡識別子は以下のもので構成されています:

  • トラッカー専用のIDであり、xDB内の連絡先のIDとは異なるものです。このIDはセッション開始時にトラッカーによって生成されます。
  • Sitecore.Analytics.XConnect.DataAccess.Constants.IdentifierSource定数で表されるソース(9.0.0の「xDB」を使用。「トラッカー」 - プロパティは内部としてマークされています)。

!重要すべての連絡先にトラッカー識別子があるとは期待しないでください。あなたのウェブサイトを訪れた連絡先だけがトラッカー識別子を持ちます。

エイリアス識別子

すべての連絡先には、AddContactOperation中に割り当てられる匿名のエイリアス識別子が付与されます。エイリアス識別子は、常に少なくとも1つの予測可能な識別子を持つことを確保し、List Managerのような製品で利用されます。エイリアス識別子は以下で構成されます:

  • xConnectサービス層によって生成され、xDB内の接点のIDとは異なるIDです。
  • Sitecore.XConnect.Constants.AliasIdentifierSource定数で表されるソース(9.0.0の「xDB」を使用。「トラッカー」 - プロパティは内部としてマークされています)。

!重要連絡先はエイリアス識別子を1つしか持てません。 Sitecore.XConnect.Constants.AliasIdentifierSourceソースを使う追加の識別子を追加しようとすると例外が出ます。

この記事を改善するための提案がある場合は、 お知らせください!