1. Data Exchange Frameworkの使用

チュートリアル: Data Exchange Frameworkでのマーケティング オートメーション アクションの設定

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

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

このチュートリアルでは、マーケティング オートメーション (MA) アクションを設定する方法の例を示します。次の方法について説明します。

  • Data Exchange Frameworkテナントを作成する

  • 値アクセサーを作成する

  • パイプラインを作成する

  • 価値ある読者を作成する

  • パイプライン コンテキスト ビルダーを作成する

  • テナント サービス エンドポイントの作成

  • エンゲージメントプランへのトリガー DEF同期プロセスの追加

Data Exchange Frameworkテナントを作成する

テナントは、サービスに対して構成する必要がある設定のコンテナーです。

テナントを作成するには:

  1. Sitecoreでコンテンツ エディターを開き、/sitecore/system/Data Exchangeに移動します。

  2. Folderタブで、Empty Data Exchange Tenantをクリックして新しいテナントを作成します。

  3. 作成したテナントを選択します。リボンのData Exchange SDKタブの テナント グループで、Upgrade Tenantをクリックします。

  4. テナントのアップグレード ダイアログのInstruction Setフィールドで、Tenant Serviceを選択します。

  5. テナントIDをメモします。テナントID、ホスト、およびクレデンシャルを <tenant service>\App_Config\ConnectionStrings.configファイルのSitecoreという接続文字列に追加します。例えば：

    <connectionStrings>
    <add name="sitecore" connectionString="database=master;tenant id={841B0E94-4348-494D-B32D-CA5E94F26ACC};host=my-sitecore;password=b;user name=sitecore\admin;timeout=20" />
</connectionStrings>

  6. Sitecore Content ManagementおよびMarketing Automation ServiceサーバーのApp_Config\connectionstring.configファイルで、テナントに関連付けられたテナントWebサービスの接続文字列があることを確認します。例えば：

    <xmlversion="1.0" encoding="utf-8">
<connectionStrings>
    <add name="my-tenant" connectionString="https://my-tenant.service"/>
</connectionStrings>

    次の表は、接続文字列を追加する必要がある場所を示しています。

    サーバー

    位相幾何学

    ファイル

    コンテンツ管理

    すべての

    App_Config\connectionstrings.config

    マーケティングオートメーション

    XP0

    <SC_xConnect>\App_Data\jobs\continuous\AutomationEngine\App_config\connectionstrings.config

    マーケティングオートメーション

    XP1の

    <SC_marketingAutomation>\App_Data\jobs\continuous\AutomationEngine\App_config\connectionstrings.config

  7. Sitecoreスケーリング デプロイメント (XP1) の場合、MA connectionstring.configファイルにxconnect.searchとxconnect.search.certificateの文字列を追加します。CM connectionstrings.configファイルから値をコピーできます。

値アクセサーを作成する

MAイベントがMAのData Exchange Framework Actionプラグインをトリガーすると、テナント サービスに要求が送信され、テナント サービスは要求からメッセージ本文を抽出します。連絡先はJSONオブジェクトとしてシリアル化されます。

シリアル化されたxConnectコンタクトの最初の識別子にアクセスできる値アクセサーを作成する必要があります。

値アクセサを作成するには:

  1. <tenant>/Data Access/Value Readers/Commonに移動します。

  2. Folderタブで、JToken Value from JObject Value Readerをクリックして項目を作成します。 Identifier JToken from Contact JObjectという名前を付けます。

  3. Convertible Typeフィールドで、「String」を選択します。Json Pathフィールドに$.Identifiers[1].Identifierと入力します。

    Settings for Identifier JToken from Contact JObject.

  4. 変更を保存します。

  5. <tenant>/Data Access/Value Accessors/Commonに移動します。

  6. Folderタブで、「Value Accessor」をクリックしてIdentifier Value Accessorを作成します。

  7. Value Readerフィールドで、作成したIdentifier JToken from Contact JObjectオブジェクトをクリックします。

  8. 変更を保存します。

パイプラインを作成する

パイプラインを作成するには:

  1. に移動します <tenant>/Pipelines.

  2. Folderタブで、Pipelineをクリックして新しいアイテムを作成します。たとえば、MA Action Testing Pipelineという名前を付けます。

  3. パイプラインを選択します。 Folderタブで、Write to Log Pipeline Stepをクリックして新しいパイプライン ステップを作成します。

  4. 新しいパイプライン ステップを選択し、前に作成したIdentifier Value Accesor値アクセサーを構成します。

    Accessors for pipeline step.

  5. 変更を保存します。

価値ある読者を作成する

必要な値リーダーを作成するには:

  1. <tenant>/Data Access/Value Readers/Common/に移動します。

  2. Folderタブで、JObject from HttpRequest Content Value Readerをクリックして新しいアイテムを作成します。たとえば、JObject from HttpRequest Contentという名前を付けます。

  3. <tenant>/Data Access/Value Readers/Common/で、FolderタブでRaw Value Readerをクリックして新しいアイテムを作成します。たとえば、Raw Value Readerという名前を付けます。

  4. <tenant>/Data Access/Value Readers/Common/で、FolderタブでSynchronization Settings Plugin Value Readerをクリックして新しいアイテムを作成します。たとえば、Synchronization Settings Plugin Value Readerという名前を付けます。

  5. Storage Locationフィールドで、Sourceをクリックします。変更を保存します。

    Settings for Value Reader.

パイプライン コンテキスト ビルダーを作成する

コンテキストビルダーを作成するには:

  1. <your tenant>/Tenant Service Settings/Pipeline Context Buildersに移動します。

  2. Folderタブで、Pipeline Context Plugin Builderをクリックして新しいアイテムを作成します。

  3. Value TransformerフィールドをJObject from HttpRequest Contentに設定します。

  4. Plugin ReadersフィールドをSynchronization Settings Plugin Value Readerに設定します。

  5. 変更を保存します。

テナント サービス エンドポイントの作成

エンドポイントを作成するには:

  1. <your tenant>/Tenant Service Endpointsに移動します。

  2. Folderタブで、Pipeline Tenant Service Endpointをクリックして新しいアイテムを作成します。たとえば、MA Action Endpointという名前を付けます。

  3. エンドポイントを次のパラメータで設定します。

    パラメーター

    コンテンツ

    リクエスト値リーダー

    Value Readers/Common/Raw Value Reader

    パイプライン コンテキスト ビルダー

    Pipeline Context Builders/Pipeline Context Plugin Builder

    パイプライン

    Pipelines/MA Action Testing Pipeline

  4. Enabledチェック ボックスをオンにします。変更を保存します。

エンゲージメントプランへのトリガー DEF同期プロセスの追加

マーケティングオートメーションをアクティブ化するには、テナントサービスをエンゲージメントプランに接続する必要があります。

メモ

このトピックは、マーケティングオートメーションとエンゲージメントプランに精通していることを前提としています。

接続を作成するには:

  1. CMインスタンスで、<sitename>\App_Config\Sitecore\MarketingAutomation\Sitecore.DataExchange.MarketingAutomation.Client.configファイルを開きます。 <tenantServiceConnectionRepository>/<tenantServices> ノードにテナントサービスの名前を追加します。例えば：

    <dataExchange>
    <tenantServices>
        <marketingAutomation>
            <tenantServiceConnectionRepository type="Sitecore.DataExchange.MarketingAutomation.Activity.Repositories.TenantServiceConnectionRepository, Sitecore.DataExchange.MarketingAutomation.Activity">
                <tenantServices hint="list:AddService">
                   <tenantService>my-sitecore</tenantService>            
                </tenantServices>
            </tenantServiceConnectionRepository>
        </marketingAutomation>
    </tenantServices>
</dataExchange>

  2. Sitecoreスタート画面で、マーケティング オートメーション アプリケーションを開きます。

  3. 創造する。既存のキャンペーンをすでにお持ちの場合は、既存のキャンペーンを使用することもできます。ユーザーが特定のページにアクセスしたとき、または一般的なPageViewイベントが発生したときにキャンペーンをトリガーするように開始点を設定します。

  4. ツールボックスから、Trigger DEF Sync Processマーケティングアクションをキャンペーンにドラッグします。

    Add marketing action to campaign.

  5. Trigger DEF Sync Processアクションをクリックします。Select a tenant serviceドロップダウンメニューで、利用可能なサービスのリストからテナントサービスを選択します。Select a tenant service endpointドロップダウンメニューで、MA Action Endpointをクリックします。

    Configure Trigger DEF Sync Process action.
    手記

    使用可能なテナント サービスのリストは、Sitecore.DataExchange.MarketingAutomation.Client.config設定ファイルで設定できます。

  6. サービスをテストするには、ブラウザーでパブリッシュされたSitecoreサイトに移動し、新しいキャンペーンにコンタクトを登録して、クライアント セッションが終了するまで待ちます。最新のテナント サービス ログ ファイルを開きます。サービスが動作している場合は、次のような連絡先識別子を含むメッセージが含まれます。

    2019-09-05 10:49:06.538 +08:00 [Information] 10:49 AM : 6638f579-5e10-47c9-bef6-3bf2d2a1a240
この記事を改善するための提案がある場合は、 お知らせください!