---
title: "外部の目的地へConnect Sitecore Personalize"
slug: "connect-sitecore-personalize-to-an-external-destination"
abstract: "Sitecore Personalizeから外部宛Sitecore Sendやメールサービスプロバイダー(ESP)への接続を設定することができます。"
---
# 外部の目的地へConnect Sitecore Personalize

このウォークスルーでは、Sitecore Personalizeから外部宛先への接続設定方法を説明します。Sitecore Personalizeでは、トリガー付き [実験](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/introduction-to-experiments-in-sitecore-personalize/introduction-to-triggered-experiments-in-sitecore-personalize/create-a-triggered-experiment.html "Create a triggered experiment") や [体験](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/introduction-to-experiences/introduction-to-triggered-experiences-in-sitecore-personalize/create-a-triggered-experience.html "Create a triggered experience")の作成を開始するには、まずパーソナライズされたデータを送信するための接続を選択する必要があります。外部宛先(例えばメールサービスプロバイダー(ESP)やREST APIエンドポイントへの接続を設定することができます。この接続は、トリガーされた実験や体験の出力を選択した宛先に送信する方法を提供します。例えば、放棄されたカートリッジのメールメッセージを設定する際にESPへの接続を使うことができます。同様に、注文作成後にゲストのデータ拡張を更新するためにゲストREST APIへの接続を作成することもできます。

*User*、*Developer*、*Admin*またはSitecore Cloud Portalの役割を持つチームメンバーは、外部の宛先に接続できます。

このウォークスルーでは、以下の方法を説明します:

-   新しいつながりを作る
-   接続の認証
-   リクエストの設定
-   レビューして接続を保存

## 新しいつながりを作る

Sitecore Personalizeを外部の目的地に接続する最初のステップは、その目的地への新しい接続を作成することです。

新しいつながりを作るために:

1.  ナビゲーションメニューで、**Developer center** > **Connections**をクリックしてください。
    
2.  **接続**ページで「**接続を追加**」>**宛先**をクリックします。
    
3.  **「名前&説明**」ページで、以下の項目を入力してください:
    
    ![The Name & Describe page when creating a new connection in Sitecore Personalize.](https://doc.sitecore.com/api/markdown-image/personalize/ja/users/sitecore-personalize/images/ConnectionName.png)
    
    -   **名前** - 目的地に一意で直感的な名前を入力してください。
    -   **説明** - 目的地の簡潔な説明を入力します。
    -   **アイコン** - ドロップダウンリストから、ユーザーがトリガーされた実験や体験を作成する際に表示されるアイコンを選択します。
4.  「 **次へ** 」をクリックすると **認証** ページに移動します。
    

## 接続の認証

接続名を付けた後は、外部宛先への接続認証方法を選択しなければなりません。可能な限りOAuth 2の使用をお勧めします。

目的地への接続を認証するには:

1.  **認証**ページで、以下のいずれかの認証方法をクリックし、必要な項目に記入してください:
    
    ![The Authenticate page lets you select the authentication method to connect to an external destination.](https://doc.sitecore.com/api/markdown-image/personalize/ja/users/sitecore-personalize/images/ConnectionAuthenticate.png)
    
    -   **OAuth 2**:
        
        -   **アクセストークンURL** - 宛先のアクセストークンのURLを入力します。アクセストークンは宛先システムによって生成されます。アクセストークンはHTTPS URLを使用する必要があります。これにより安全な接続が確保されます。
            
        -   **Authentication option**\- 認証認証情報をヘッダー内のものに渡すにはヘッダーオプションを選択し、リクエストの本文に認証情報を渡すには**Body**オプションを選択する。
            
        -   **Client ID** - 宛先のクライアントIDを入力します。
            
        -   **Client Secret** - クライアントの宛先秘密を入力する。
            
        -   **Headers**\- オプションで「**ヘッダーを表示**」をクリックし、最初のフィールドにキー、2番目のフィールドに値を入力してください。追加のヘッダーを入力するには、「**ヘッダーを追加**」をクリックしてください。**認証オプション**で**ヘッダー**を選択した場合、ここに認証パラメータと値を入力する必要があります。
            
        -   **URLエンコードフォーム** - オプションで「 **URLエンコードフォームを表示** 」をクリックし、最初のフィールドにキー、2番目のフィールドに値を入力してください。追加の項目を入力するには、「 **フォームアイテムを追加**」をクリックしてください。このオプションではキーや値を有効なURL形式に変換し、Sitecore Personalizeに送信できます。
            
        -   **Mutual TLSで設定** - クリックしてMutual Transport Layer Security(mTLS)を有効にしてください。これにより、Sitecore Personalizeと接続先がTLSプロトコルを使って互いに認証できます。
            
            Sitecore Personalize mTLS JSON Web Key Set(JWKS)エンドポイントを見るには、![pers\_JWTS.png](https://doc.sitecore.com/api/markdown-image/personalize/ja/users/sitecore-personalize/images/pers_JWTS.png) アイコンをクリックしてください。JWKSは、任意のJSON Web Tokens(JWT)を検証するために使われる公開鍵を含む鍵の集合体です。
            
    -   **基本:**
        
        -   **ユーザー名** - 認証用のユーザー名を入力してください。
        -   **パスワード** - 宛先への認証用パスワードを入力します。
    -   **None** - これは公開APIにのみ使用され、ESPのような外部宛先への接続には推奨されません。
        
2.  **「次へ**」をクリックすると「**リクエストの設定**」ページに移動します。
    

## リクエストの設定

リクエストを設定する際に、REST APIリクエストとレスポンスに関連するメタデータを表すヘッダーやパラメータを設定できます。ヘッダーやパラメータには、トラブルシューティングに役立つ情報が含まれています。

リクエストを設定するには:

1.  リクエスト **の設定** ページのリクエスト**URLドロップダウンリスト** で、リクエストで使用する以下のHTTPメソッドのいずれかを選択してください。
    
    ![The Configure Request page lets you set the request method, URL, headers, and body to use for the external destination.](https://doc.sitecore.com/api/markdown-image/personalize/ja/users/sitecore-personalize/images/ConnectionRequest.png)
    
    -   **POST** - この方法でデータを送り、リソースコレクションの下に子リソースを作成します。
    -   **PUT** - この方法で既存のリソースを更新するためのデータを送信します。あるいは、リソースがまだ存在しない場合は、新しいリソースが作成されます。
    -   **PATCH** - このメソッドを使って既存のリソースを部分的に更新できます。リソース内の単一の値や複数の値を、リソース全体を再送することなく変更できます。
    -   **DELETE** - この方法で既存のリソースを削除します。
2.  **リクエストURL**欄で、宛先リクエストを送信するためのURLを入力します。
    
    FreeMarkerの変数表記を使うことでURLに変数を含めることができます ${}。例えば、https://example.com/api/emails/${email}?limit=${num}.
    
    > !重要接続内でリクエストURLやヘッダー、リクエストボディを設定する際、[ゲストデータオブジェクト](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/connecting-sitecore-personalize-to-an-external-system/use-guest-data-in-the-api-request-for-a-triggered-experiment.html "Use guest data in the API request for a triggered experiment")の変数( ${guest.email}など)は使えません。体験や実験とは異なり、FreeMarkerは実行時にこれらのオブジェクトやプロパティを認識せず、例外が発生することがあります。
    
3.  「**デフォルトのヘッダーを表示**」をクリックすると、宛先のデフォルトヘッダーとパラメータが表示されます:
    
    -   **Accept** - このフィールドは**application/json**を表示し、JSONが応答の受け入れフォーマットであることを示します。
    -   **Accept-Encoding** - このフィールドは**gzip**を表示し、gzipが受け入れられる圧縮タイプであることを示します。
    -   **Content-Type** - このフィールドは**application/json**を表示し、リクエストで送られるコンテンツのフォーマットをJSONに指定します。
4.  追加のヘッダーを追加するには、「 **ヘッダーを追加**」をクリックしてください。次の項目を入力するための追加の行が表示されます:
    
    -   **キー** - ヘッダー名を入力してください。
    -   **値** - パラメータを入力します。
    
    FreeMarkerの変数表記法を使うことで、ヘッダー名やパラメータに変数を含めることができます ${}。
    
5.  接続タイムアウトを設定するには、以下の項目を入力してください:
    
    -   **接続タイムアウト(ms)** - ドロップダウンリストで、接続が終了するまでの非アクティブ期間のミリ秒数を選択します。デフォルトは1000です。
    -   **「タイムアウト(ms)」を読みます - ドロップダウンリストで、接続が確立されてからサーバーからの応答を受け取れないまでのミリ秒数を選択し、その後接続が終了します。デフォルトは1000です。」**
6.  **リクエスト**欄に、接続をテストするためのサンプルJSONリクエストを入力してください。JSONが有効であることを確認しましょう。サンプルリクエストには実際のゲスト連絡先を送らないでください。
    
    サンプルリクエストに変数を含めるには、FreeMarker変数表記をダブルクォートで囲んで "${}"。例えば、"name": "${name}" や "email": "${email}"。
    
7.  「 **テストリクエスト**」をクリックします。リクエストURLやヘッダー、本文に ${email}などの変数を含めていれば、それらのテスト値を入力してください。次に **「テストを実行する**」をクリックします。
    
    テスト結果は**対応**フィールドに表示され、関連するステータスコードが表示されます。
    
8.  **「次へ**」をクリックすると「**レビュー &保存**」ページに移動します。
    

## レビューして接続を保存

このページを進む必要があります。そうしないと、前ページで設定した接続が保存されず、最初から接続を作ってからやり直さなければなりません。

つながりを保存するために:

1.  「 **レビュー &保存** 」ページでは、あなたの接続の統合ビューを見ることができます。外部宛先が正しく設定されているか確認してください。
    
    ![The Review & Save page provides a summary of your external destination.](https://doc.sitecore.com/api/markdown-image/personalize/ja/users/sitecore-personalize/images/ConnectionSave.png)
    
2.  セットアップの詳細を編集するために前のページに戻るには、ページ上部の該当タブをクリックするか、**戻る**をクリックしてください。
    
3.  接続設定を最終決定する準備ができたら、**保存**をクリックします。
    
    > !警告保存後は接続を編集できません。保存する前に必ず確認してください。
    
    このつながりは、トリガーされた [実験](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/introduction-to-experiments-in-sitecore-personalize/introduction-to-triggered-experiments-in-sitecore-personalize/create-a-triggered-experiment.html "Create a triggered experiment") や [体験](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/introduction-to-experiences/introduction-to-triggered-experiences-in-sitecore-personalize/create-a-triggered-experience.html "Create a triggered experience")を作成する際に使うことができます。