---
title: "ウォークスルー:Data Exchange Frameworkでのマーケティングオートメーションアクションの設定"
slug: "walkthrough--setting-up-a-marketing-automation-action-in-data-exchange-framework"
abstract: "マーケティングオートメーション(MA)アクションの設定方法の例です。"
---
# ウォークスルー:Data Exchange Frameworkでのマーケティングオートメーションアクションの設定

このウォークスルーでは、マーケティングオートメーション(MA)アクションの設定方法の例を示します。以下の方法を説明しています:

-   データ交換フレームワークのテナントを作成する
-   値アクセスツールを作成する
-   パイプラインの作成
-   価値を創造する読者
-   パイプラインコンテキストビルダーの作成
-   テナントサービスエンドポイントの作成
-   エンゲージメントプランにトリガーDEF同期プロセスを追加する

## データ交換フレームワークのテナントを作成する

テナントはサービスのために設定しなければならない設定のコンテナです。

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

1.  Sitecoreでコンテンツエディターを開き、*/sitecore/system/Data Exchange*に移動します。
    
2.  **フォルダ**タブで「**空のデータ交換テナン**ト」をクリックして新しいテナントを作成します。
    
3.  作成したテナントを選択します。リボンのData **Exchange SDK**タブのテナントグループで「 **テナントをアップグレード**」をクリックします。
    
4.  テナントのアップグレードダイアログの命令 **セット** フィールドで「 **テナントサービス**」を選択してください。
    
5.  テナントのIDをメモしてください。 <tenant service>\\App\_Config\\ConnectionStrings.configファイルの接続文字列Sitecoreに、テナントID、ホスト、認証情報を追加します。例えば:
    
    <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およびマーケティング自動化サービスのサーバーの、App\_Config\\connectionstring.configファイルに、そのテナントのウェブサービスに関連付けられた接続文字列があることを確認してください。例えば:
    
    <xmlversion="1.0" encoding="utf-8">
    <connectionStrings>
     <add name="my-tenant" connectionString="https://my-tenant.service"/>
    </connectionStrings>
    
    この表は接続列をどこに追加すべきかを示しています:
    
    サーバー
    
    位相
    
    ファイル
    
    Content Management
    
    全員
    
    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 Pluginをトリガーすると、テナントサービスにリクエストを送信し、メッセージ本文がリクエストから抽出されます。このコンタクトはJSONオブジェクトとしてシリアライズされます。

シリアライズされたxConnect接触の最初の識別子にアクセスできる値アクセス器を作成する必要があります。

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

1.  <tenant>/Data Access/Value Readers/Commonへナビゲート。
    
2.  **フォルダ**タブで、*JObject値リーダーのJToken値*をクリックしてアイテムを作成します。Contact *JObjectから識別子(Identifier JToken*)と名付けてください。
    
3.  **Convertible Type**フィールドで*String*を選択します。**Json Path**フィールドで*$を入力します。Identifiers\[1\]。Identifier*。
    
    ![Settings for Identifier JToken from Contact JObject.](<https://doc.sitecore.com/api/markdown-image/xp/ja/developers/def/60/data-exchange-framework/images/settings%20for%20identifier%20jtoken%20from%20contact%20jobject%20object.png>)
    
4.  変更を保存してください。
    
5.  <tenant>/Data Access/Value Accessors/Commonへナビゲート。
    
6.  **フォルダ**タブで**「値アクセサ**ル」をクリックして*Identifier Value Accessor*を作成します。
    
7.  **Value Reader**フィールドで、作成したContact *JObjectオブジェクトの識別子JToken*をクリックしてください。
    
8.  変更を保存してください。
    

## パイプラインの作成

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

1.  あなたの <tenant>/Pipelines.
    
2.  **フォルダ**タブで「**パイプライン**」をクリックして新しいアイテムを作成します。例えば、*MA Action Testing Pipeline*と名付けてください。
    
3.  パイプラインを選択してください。 **フォルダ** タブで「 **パイプラインのログに書き込み」ステップ** をクリックして新しいパイプラインステップを作成します。
    
4.  新しいパイプラインステップを選択し、以前作成した*Identifier Value Accesor*値アクセクターを設定してください。
    
    ![Accessors for pipeline step.](<https://doc.sitecore.com/api/markdown-image/xp/ja/developers/def/60/data-exchange-framework/images/accessors%20for%20pipeline%20step.png>)
    
5.  変更を保存してください。
    

## 価値を創造する読者

必要な価値を生み出すために、読者:

1.  <tenant>/Data Access/Value Readers/Common/へナビゲート。
    
2.  **フォルダ**タブで、**HttpRequest Content Value ReaderからJObject**をクリックして新しいアイテムを作成します。例えば、*HttpRequest ContentからJObject*と名付けてください。
    
3.  <tenant>/Data Access/Value Readers/Common/の**フォルダ**タブで**「生の値リーダー**」をクリックして新しいアイテムを作成します。例えば、名前を*Raw Value Reader*。
    
4.  <tenant>/Data Access/Value Readers/Common/の**フォルダ**タブで「**同期設定プラグイン値リーダー**」をクリックして新しいアイテムを作成します。例えば「*同期設定プラグイン値リーダー*」と名付けてください。
    
5.  **ストレージロケーション**欄で*Source*をクリックします。変更を保存してください。
    
    ![Settings for Value Reader.](<https://doc.sitecore.com/api/markdown-image/xp/ja/developers/def/60/data-exchange-framework/images/settings%20for%20value%20reader.png>)
    

## パイプラインコンテキストビルダーの作成

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

1.  <your tenant>/Tenant Service Settings/Pipeline Context Buildersへナビゲート。
2.  **フォルダ**タブで*Pipeline Context Plugin Builder*をクリックして新しいアイテムを作成します。
3.  **Value Transformer**フィールドを*HttpRequest ContentからJObject*に設定します。
4.  **プラグインリーダー**ズフィールドを*同期設定プラグイン値リーダー*に設定してください。
5.  変更を保存してください。

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

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

1.  <your tenant>/Tenant Service Endpointsへナビゲート。
    
2.  **フォルダ**タブで*Pipeline Tenant Service Endpoint*をクリックして新しいアイテムを作成します。例えば、*MA Action Endpoint*と名付けてください。
    
3.  エンドポイントを以下のパラメータで設定します:
    
    パラメータ
    
    内容
    
    リクエスト値リーダー
    
    *Value Readers/Common/Raw Value Reader*
    
    パイプラインコンテキストビルダー
    
    *パイプラインコンテキストビルダー/パイプラインコンテキストプラグインビルダー*
    
    パイプライン
    
    *Pipelines/MA Action Testing Pipeline*
    
4.  **有効にする**チェックボックスを選択してください。変更を保存してください。
    

## エンゲージメントプランにトリガー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 Launchpadでマーケティングオートメーションアプリケーションを開きます。
    
3.  新しいキャンペーンを作成してください。新しいキャンペーンです。既存のキャンペーンがあれば、そのキャンペーンも利用できます。顧客が特定のページを訪れたときや一般的なPageViewイベントが発生したときにキャンペーンが発動するように、開始点を設定してください。
    
4.  ツールボックスから、*Trigger DEF Sync Process*マーケティングアクションをキャンペーンにドラッグしてみましょう。
    
    ![Add marketing action to campaign.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/def/60/data-exchange-framework/images/Campaign_toolbox.png)
    
5.  「 **DEF同期プロセスのトリガー** 」アクションをクリックします。「 **テナントサービス選択** 」ドロップダウンメニューで、利用可能なサービスリストからテナントサービスを選択します。「 **テナントサービス選択」** のドロップダウンメニューで、*MA Action Endpoint*をクリックします。
    
    ![Configure Trigger DEF Sync Process action.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/def/60/data-exchange-framework/images/Trigger_DEF_sync_process_action.png)
    
    > !注利用可能なテナントサービスのリストは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