1. 連絡先

連絡先識別子

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

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

コンタクト識別子は、xDBの外部にあるシステムに対してコンタクトを一意に識別します。有効な識別子の例としては、Webサイトのログイン、ソーシャル メディアのハンドル、広告ネットワークIDなどがあります。識別子はSitecore.XConnect.ContactIdentifierクラスによって表されます。各識別子は、次のもので構成されます。

  • ユーザー名などのIdentifier

  • 識別子Sourceは、識別子の出所を示します (「twitter」など)

  • 識別子ContactIdentifierType( ContactIdentifierType.Anonymousまたは ContactIdentifierType.Known

Sitecore.XConnect.ContactIsKnownプロパティは、連絡先に既知の識別子がある場合にtrueを返します。

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

  • IdentifierプロパティとSourceプロパティは大文字と小文字を区別し、比較はバイト レベルで行われます。

  • 識別子とソースはVARBINARYとして格納されます。識別子は700 バイトに制限され、ソースは50 文字に制限されています。

メモ

アポストロフィや水平タブはサポートされていないため、識別子に使用しないでください。

識別子の一意性

連絡先は、IdentifierSourceの組み合わせによって一意に識別されます。この要件は、次のシナリオをサポートします。

  • 複数のシステムで同じユーザー名を使用している連絡先 (たとえば、TwitterやSlackでmyrtlesitecoreを使用している場合)

  • 同じユーザー名を使用する2つの異なる連絡先 - たとえば、Instagramでsitecoreを使用している連絡先1とTwitterでsitecoreを使用している連絡先2

連絡先は複数の識別子を持つことができます

1つの連絡先に複数の識別子を設定できます。連絡先の識別子は、ContactクラスのIdentifiersプロパティで表されます。識別子の使用方法については、次のトピックを参照してください。

トラッカー識別子

あなたのウェブサイトと対話したコンタクトには、コンタクトが初めてあなたのウェブサイトにアクセスしたときに作成されるトラッカー識別子があります。これは、既知の連絡先と匿名の連絡先に適用されます。トラッカー識別子は、次のもので構成されます。

  • トラッカーによって排他的に使用され、xDBのコンタクトのIDとは異なるID。このIDは、セッションの開始時にトラッカーによって生成されます。

  • Sitecore.Analytics.XConnect.DataAccess.Constants.IdentifierSource定数で表されるソース ("xDBを使用します。Tracker" 9.0.0の - プロパティは内部としてマークされています)。

大事な

トラッカー識別子を持つすべての連絡先に依存しないでください。あなたのウェブサイトを訪問した連絡先のみがトラッカー識別子を持ちます。

エイリアス識別子

すべての連絡先には、AddContactOperation.エイリアス識別子を使用すると、連絡先は常に少なくとも1つの予測可能な識別子を持ち、List Managerなどの製品で使用されます。エイリアス識別子は、次のもので構成されます。

  • xConnectサービス レイヤーによって生成され、xDBのコンタクトのIDとは異なるID。

  • Sitecore.XConnect.Constants.AliasIdentifierSource定数で表されるソース ("xDBを使用します。Tracker" 9.0.0の - プロパティは内部としてマークされています)。

大事な

連絡先は、エイリアス識別子を1つだけ持つことができます。 Sitecore.XConnect.Constants.AliasIdentifierSourceソースを使用する識別子を追加しようとすると、例外が発生します。

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