1. 連絡先の追跡

連絡先の特定

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

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

連絡先の識別は、現在のセッション、デバイス、および連絡先セッションを 識別子に接続するプロセスです。 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
    }
メモ

<name of a service> はSitecore.Context.Siteに依存し、使用可能なコンテキストで解決する必要があります。

匿名連絡先のセッション中にIdentifyAs() が呼び出されると、次のいずれかが発生します。

  • 識別子が存在しない場合は、作成されます。現在の連絡先が既知になります。

  • 識別子が存在する場合は、既存の既知のコンタクトがxConnectからロードされ、匿名コンタクトとマージされます。

  • 明示的な同意が必要であるにもかかわらず、連絡先から同意が得られない場合、または連絡先によって同意が取り消された場合、識別は失敗します。

IdentifyAsメソッドは、次のプロパティを含むSitecore.Analytics.Tracking.Identification.IdentificationResultオブジェクトを返します。

  • ブール型のSuccessプロパティ。識別に失敗した場合、プロパティはfalseに設定されます。

  • 失敗した結果のエラー コードを含むErrorCodeプロパティ (文字列)。

  • 失敗した結果に関するメッセージを含むErrorMessageプロパティ。

識別子は、識別子とソースで構成されます。識別子は、ユーザー名など、連絡先に関する一意の情報であり、識別子のソースは識別子の出所を示します。連絡先は複数の識別子を持つことができます。次の表に、既知の識別子とソースの例をいくつか示します。

識別子

源

マートルサイトコア

囀る

m_McSitecore

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

ABC10769150

フェイスブック認証

大事な

匿名の識別子を使用して連絡先を識別することはできません。このルールの唯一の例外は、エイリアス識別子です。

トラッカー識別子

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

いつ特定するか

識別は認証とは別のものであり、通常は同時に行われます。ただし、デバイス上で連絡先が識別されると、トラッカーは 分析Cookieを使用して、ASP.NETセッションCookieが削除されても、その連絡先を自動的に再識別します (再認証ではありません)。

要件に応じて、デバイス全体で連絡先を識別するために実装できるさまざまな識別戦略があります。例えば：

シナリオ

識別

連絡先がログインします。

ユーザー名は識別子として使用できます - ログインが成功した場合は、IdentifyAs("usernamesource", "username") を呼び出します。

連絡先は、電子メールExperience Managerによって送信された電子メールリンクを開きます。

メールリンクには、クエリ文字列に連絡先のエイリアス識別子が含まれます。このデータは、連絡先を識別するために使用されます。

次の例では、連絡先の識別は、連絡先が正常にログインした後に行われます。

Contact identification using username

識別子ソース

連絡先を特定する際に使用するソースを決定するのは、お客様の責任です。ソースの中央リポジトリはありません。連絡先がすべてのシステムで同じ詳細を使用してログインする場合は、すべてのログインコードと登録コードでソースが一貫していることを確認してください。

識別シナリオ

次の表では、IdentifyAs() が呼び出されたときの動作について説明します。

セッション中の連絡先

IdentifyAs() パラメータ

識別

  • セッションの連絡先は匿名です。

  • セッション内のコンタクトは、匿名コンタクトとしてxConnectに存在します。

識別子は、xConnectの既存の既知の連絡先と一致します。

匿名連絡先の情報は既知の連絡先とマージされ、匿名連絡先レコードは廃止され、既知の連絡先レコードへのポインターに置き換えられます。マージ後、コンテキスト連絡先はセッション状態から削除されます。マージされたコンタクトには、カスタムコンタクトファセットとインタラクション履歴が含まれます。

  • セッションの連絡先は匿名です。

  • セッション内のコンタクトがxConnectに存在しません。

識別子は、xConnectの既存の既知の連絡先と一致します。

トラッカーは、既知の連絡先に代わって現在のインタラクションを続行します。匿名の連絡先がxConnectに存在しなかったため、マージは行われません。

  • セッション中の連絡先がわかっています。

  • セッション内のコンタクトは、既知のコンタクトとしてxConnectに存在します。

識別子は、xConnectの別の既知の連絡先と一致します。

現在のインタラクションが終了し、既知のコンタクトの新しいインタラクションが開始されます。新しいインタラクションは、終了したインタラクションの最後のページから開始され、現在のデバイスと既知の連絡先との間のリンクが更新されます。

  • セッションの連絡先は匿名です。

  • セッション内のコンタクトがxConnectに存在しません。

識別子がxConnectにまだ存在しません。

現在のコンタクトは、新しい既知の識別子とともにxConnectに保存され、セッションが続行されます。

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