---
title: "Engage SDKスクリプトを使って統合します"
slug: "integrate-engage-sdk-script"
abstract: "CDNからEngage SDKスクリプトを読み込んでウェブサイトをSitecore CDPに統合する方法。"
---
# Engage SDKスクリプトを使って統合します

このトピックでは、Engage SDKを使ってウェブサイトを統合する方法を説明します。

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

> !注**始める前に**
> 
> -   [Sitecore CDPインスタンスに関する必要な情報を収集してください。](https://doc.sitecore.com/cdp/ja/developers/api/integrating-with-sitecore-cdp/walkthroughs-for-integrating/collect-required-details.html "Collect required details")
>     
> -   HTML、JavaScript、そしてウェブブラウザの開発者ツールに慣れていることを確認してください。
>     
> -   統合するためのウェブサイトを用意しましょう。
>     

## スクリプトをウェブサイトに読み込んでください

ウェブサイト統合の最初のステップは、HTML <script> タグを使ってウェブサイトのすべてのウェブページにEngage SDKスクリプトを読み込むことです。

スクリプトを読み込むには:

1.  コードエディターで、ウェブサイトのフォルダ構造を開きます。
    
2.  JavaScriptファイルを保存しているフォルダに新しいJavaScriptファイルを作成します。
    
    例: scripts/sitecore-engage.js
    
3.  JavaScriptファイルを開き、以下のEngage SDKスクリプトを貼り付けてください:
    
    // Initialize the engage variable
    var engage = undefined;
    
    // Create and inject the <script> tag into the HTML
    var s = document.createElement("script");
    s.type = "text/javascript";
    s.async = true;
    s.src = "https://d1mj578wat5n4o.cloudfront.net/sitecore-engage-v.1.4.3.min.js";
    var x = document.querySelector("script");
    x.parentNode.insertBefore(s, x);
    
    // Initialize the Engage SDK
    s.addEventListener("load", async () => {
     var settings = {
     clientKey: "<client\_key\_PLACEHOLDER>",
     targetURL: "<stream\_api\_target\_endpoint\_PLACEHOLDER>",
     pointOfSale: "<point\_of\_sale\_PLACEHOLDER>",
     cookieDomain: "<cookie\_domain\_PLACEHOLDER>",
     cookieExpiryDays: 365,
     forceServerCookieMode: false,
     includeUTMParameters: true,
     webPersonalization: true /\* boolean or object. See Settings object for all options. Set to \`false\` if you don't have Personalize. \*/
     };
     engage = await window.Engage.init(settings);
    
     // Send a VIEW event
     // ...
    });
    
    プレースホルダーの値は、[Sitecore CDPインスタンスの必要な詳細に置き換えてください。](../preparing-to-integrate/collect-required-details.md "Collect required details")
    
    > !重要**クッキー同意**本番環境では、サイト訪問者が同意を得た場合のみEngage SDKを読み込み、クッキーを設定してください。サイト訪問者がクッキーを受け入れているかどうかを確認する [コード例](cookies.html "Cookies") も参照してください。
    
    > !重要**コンテンツセキュリティポリシー(CSP)**Engage SDKスクリプトが読み込まれるようにするために、コンテンツ [セキュリティポリシー(CSP)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP)に以下の内容を追加する必要があるかもしれません:
    > 
    > -   Stream [APIのターゲットエンドポイント](collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950147122 "Stream API target endpoint")。
    >     
    > -   https://d1mj578wat5n4o.cloudfront.net
    >     
    > -   ウェブパーソナライゼーションを実行していて、環境が**AP地域**、**EU地域**、**または米国地域**であれば:
    >     
    > 
    > https://d35vb5cccm4xzp.cloudfront.net
    > 
    > -   ウェブパーソナライゼーションを使い、環境が **JP地域**であれば:
    > 
    > https://d2ez8k04aaol9g.cloudfront.net
    
4.  JavaScriptファイルを保存してください。
    
5.  ウェブサイトのすべてのウェブページにスクリプトをインポートするHTMLファイルを開きます。
    
6.  スクリプトを含むJavaScriptファイルをHTMLファイルにインポートします。JavaScriptファイルを閉じる</body>タグの前の最初の<script>要素としてインポートします。
    
    > !重要ウェブサイトのアーキテクチャによっては、<script> タグをHTMLの他の場所に配置したほうが良いかもしれません。JavaScriptファイルをどこでインポートするかは、ウェブ体験やウェブ実験のパフォーマンスに影響を与えます。
    
    例: index.html
    
    <html>
     <head></head>
     <body>
    ...
     <script src="scripts/sitecore-engage.js"></script>
     <script></script>
     <script></script>
     </body>
    </html>
    

## スクリプトがあなたのウェブサイトに読み込まれているか確認してください

Engage SDKスクリプトがあなたのウェブサイトに読み込まれることを確認するには:

1.  ウェブブラウザでウェブサイトとコンソールを開いてください。このウォークスルーの残りの部分はウェブサイトとコンソールを開いたままにしてください。
    
2.  コンソールでengage;を入力してください。
    
    オブジェクトが戻ってきたら、あなたのウェブサイトにスクリプトを正常に読み込んだことになります。
    

## 初めてのVIEWイベントをSend

スクリプトがあなたのウェブサイトに読み込まれたことを確認したら、データを収集してSitecore CDPに送信します。VIEWイベントはウェブページが読み込まれるたびにトリガーされるため、VIEWイベントを送信します。

VIEWイベントを送信するには:

1.  コードエディターでスクリプトを含むJavaScriptファイルを開きます。
    
2.  s.addEventListener()関数の下部、engage = await window.Engage.init(settings);行の下に、次のコードを貼り付けます:
    
    // VIEW event object
    var event = {
     channel: "<channel\_PLACEHOLDER>",
     language: "<language\_PLACEHOLDER>",
     currency: "<currency\_PLACEHOLDER>",
     page: "<page\_PLACEHOLDER>"
    };
    
    // Send VIEW event
    engage.pageView(event);
    
    // For testing and debugging purposes only
    console.log("Copy-paste the following line into Sitecore CDP > Guests > Search field:");
    console.log(engage.getBrowserId());
    
    プレースホルダーの値は、[Sitecore CDPインスタンスの必要な詳細に置き換えてください。](../preparing-to-integrate/collect-required-details.md "Collect required details")
    
    このスクリプトはVIEWイベントオブジェクトを作成し、コンポーネントが初めてレンダリングされた直後にイベントデータをSitecore CDPに送信します。また、ブラウザのIDもコンソールにログします。次の手順でブラウザIDを使ってSitecore CDP内のVIEWイベントを見つけます。
    
3.  ウェブブラウザでウェブページを再読み込みます。VIEWイベントがトリガーされ、イベントデータが送信されます。
    

## Sitecore CDPがあなたのVIEWイベントをキャプチャしたか確認してください

VIEWイベントを送信した後、Sitecore CDPにログインしてイベントを見つけます。

Sitecore CDPがあなたのVIEWイベントをキャプチャしたことを確認するために:

1.  ウェブブラウザのコンソールで、次のようなテキストを見つけてください:
    
    a38b230c-11eb-4cf9-8d5d-274e9f344925​
    
2.  テキストをコピーしてください。
    
3.  Sitecore CDPで **ゲストをクリックし、**検索ドロップダウンで **ブラウザID**を選択し、コピーしたテキストを検索欄に貼り付けます。
    
    匿名のゲストが展示している。
    
    ![Search field in the Guests screen.](images/cdp-guests-bid.jpg)
    
    このゲストは、さっきあなたがアプリを読み込んでいたことです。次に、このゲストに関連付けられたVIEWイベントを見つけます。
    
4.  ゲストをクリックしてください。ゲストプロフィールが表示されます。
    
5.  ゲストプロフィールページでイベント **ビューアー**をクリックします。このゲストに関連するイベントのリストが表示されます。リストにはVIEWイベントが含まれています。これは前回の手順でトリガーされたイベントです。
    

## 今後のステップ

現在、あなたのウェブサイトをSitecore CDPと無事に統合しました。ウェブサイトからイベントを送信し、Sitecore CDPがリアルタイムでユーザーに関するデータを収集していることを確認しました。

次に、次のことができます:

-   [Send他の行動データ](../understanding-integration-details/sending-events-using-the-engage-sdk.md "Sending events using the Engage SDK")、例えば [IDENTITYイベント](../../stream-api/sitecore-engage-sdk-reference/functions/engage-identity.md "Engage.identity(eventData[, extensionData])") や [カスタムイベント](../../stream-api/sitecore-engage-sdk-reference/functions/engage-event.md "Engage.event(type, eventData[, extensionData])")など。
-   [ユーザーがサイト上の商品やショッピングカートとやり取りする際に取引データをSendします。](../understanding-integration-details/sending-orders-using-the-engage-sdk.md "Sending orders using the Engage SDK")
-   もし経験があれば、 [Sitecore Personalizeを体験したり実験をしたり](../understanding-integration-details/running-personalization.md "Running personalization")することができます。