1. xConnectモデル

相互 作用

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

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

インタラクションは、コンタクトがブランドとインターフェースする任意のポイント(オンラインまたはオフライン)を表します。インタラクションの例は次のとおりです。

  • 実店舗で何かを購入する

  • アプリの使用

  • Webサイトの閲覧

  • 電話での会話

インタラクションはSitecore.XConnect.Interactionクラスで表され、少なくとも1つのイベントが必要です。次の例では、1つの目標を持つインタラクションが新しいコンタクトに追加されます。

using Sitecore.XConnect.Collection.Model;
using Sitecore.XConnect.Model;
using Sitecore.XConnect;
using System;

namespace Documentation
{
    public class AddInteraction
    {
        public async void GoalExample()
        {
            using (Sitecore.XConnect.Client.XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient())
            {
                try
                {
                    var newContact = new Sitecore.XConnect.Contact();
                    client.AddContact(newContact);

                    // Create new interaction for this contact
                    Guid channelId = Guid.NewGuid(); // Replace with channel ID from Sitecore
                    string userAgent = "Mozilla/5.0 (Nintendo Switch; ShareApplet) AppleWebKit/601.6 (KHTML, like Gecko) NF/4.0.0.5.9 NintendoBrowser/5.1.0.13341";
                    var interaction = new Sitecore.XConnect.Interaction(newContact, InteractionInitiator.Brand, channelId, userAgent);

                    // Get goal ID - this is the ID of the item in Sitecore
                    var fakeGoalId = Guid.Parse("2a413310-b086-12e6-9598-0800200c9a66");

                    // Create new instance of goal
                    Sitecore.XConnect.Model.Goal goal = new Goal(fakeGoalId, DateTime.UtcNow);
                    {
                    };

                    // Add goal to interaction
                    interaction.Events.Add(goal);

                    // Add interaction operation to client
                    client.AddInteraction(interaction);

                    // Submit interaction
                    await client.SubmitAsync();
                }
                catch (Exception ex)
                {
                    // Handle exception
                }
            }
        }
    }
}

次の表では、コンストラクターに渡す必要がある必須のインタラクション プロパティについて説明します。

財産

形容

ChannelId

チャネルとは、ウェビナー、電子メール キャンペーン、展示会での対面での会話など、連絡先がブランドと対話するために使用するパスです。チャネルは、/sitecore/system/Marketing Control Panel/Taxonomies/Channelで定義アイテムとして表されます。

システムによって作成されたインタラクションは、システム チャネル /sitecore/system/Marketing Control Panel/Taxonomies/Channel/Online/System/Systemを使用します。例としては、自動化アクティビティの副産物として作成されるインタラクションがあります。

Initiator

コンタクトがブランドのウェブサイトにアクセスした場合、インタラクションはコンタクトによって開始されました。ブランドが配達や電話をかけた場合、インタラクションはブランドによって開始されました。

UserAgent

xConnectはWebサービスであり、すべてのインタラクションはインターネット対応デバイスを介して作成されます。すべてのデバイスにはユーザーエージェントがあります。ユーザーエージェントは 、RFCに定められた形式に従う必要があります。例えば、Nintendo SwitchのユーザーエージェントはMozilla/5.0 (Nintendo Switch;ShareApplet) AppleWebKit/601.6 (KHTML, like Gecko) NF/4.0.0.5.9 NintendoBrowser/5.1.0.13341.

メモ

マーケティングオートメーションなどの内部システムによって作成されたインタラクションには、Sitecore/9.0 (マーケティングオートメーション) などのユーザーエージェントがあります。

次の表では、オプションのインタラクション プロパティについて説明します。

財産

形容

VenueId

インタラクションが発生したオフライン施設のID (該当する場合)。会場は、/sitecore/system/Marketing Control Panel/Taxonomies/Venuesの下に定義アイテムとして表示されます。

CampaignId

インタラクションを引き起こしたキャンペーンのID。CampaignId GUIDで表されるキャンペーンは、Eventsコレクションで重複しません。

トラッキング コンテキストでは、キャンペーンがセッションの最初のページでトリガーされた場合 (たとえば、FacebookでキャンペーンURLをクリックした結果として) にCampaignIdが設定されます。最初のページ表示後にトリガーされる追加のキャンペーンは、CampaignEventオブジェクトとして追加されます。

インタラクションにはタイプがありません

インタラクションには明示的なタイプはありません。たとえば、インタラクションを「オフライン」または「オンライン」に分類するプロパティはありません。これは仕様です。インタラクションのタイプは、ファセットとプロパティに基づいて推測する必要があります。例えば:

  • インタラクションにWebVisitファセットが存在することは、インタラクションがWebサイトのコンテキストで発生したことを示します

  • VenueIdの存在は、店舗などの物理的な場所でインタラクションが発生したことを示します

インタラクションエンゲージメントの価値

インタラクションのEngagementValueは、そのインタラクションのイベントのエンゲージメント値の合計です。

インタラクション時間

インタラクションのStartDateTimeEndDateTimeDurationは、インタラクションのイベントタイムスタンプと期間を使用して計算されます。

  • インタラクション .StartDateTimeは最小のイベントに対応します Timestamp

  • インタラクション .EndDateTimeは、最大イベントTimestampの値とイベント期間(期間が存在する場合)として計算されます

  • インタラクション .Duration.EndDateTimeです - .StartDateTime

すべてのインタラクションに期間があるわけではありません。たとえば、搭乗券のスキャンは、1つのイベントとの瞬時のインタラクションです。

対話式操作モデルの拡張

ファセットを使用して、対話モデルを拡張します。詳細については、次のセクションを参照してください。

手記

CustomValuesInteractionオブジェクトから削除されている - 代わりにファセットを使用する必要があります。

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