# Web SDKインテグレーション

ベータ
Web SDKは現在ベータ版です。詳細については、御社のアカウント担当までお知らせください。

Web SDKは、ウェブサイト上でパーソナライゼーションを実行するクライアントサイドのJavaScriptライブラリです。RT 2.0リアクターに接続し、訪問者のオーディエンスメンバーシップを評価し、パーソナライズされたクリエイティブアセットを取得し、コンテンツスポットのDOM要素を置き換え、キャンペーンイベントを追跡します。

必須
Web SDKがウェブサイトにインストールされていない場合、訪問者にパーソナライゼーションは表示されません。Personalization Studioでキャンペーンを設定しても、オーディエンスには届きません。

## Web SDKの機能

1. ページ上で読み込み（スクリプトタグまたは非同期ローダー経由）
2. RT 2.0リアクター経由で訪問者を識別
3. キャンペーンルールに対してオーディエンスメンバーシップを評価
4. Personalization Studio APIから一致するクリエイティブアセットを取得
5. コンテンツスポットのDOM要素をパーソナライズされたコンテンツに置き換え
6. インプレッションとクリックを追跡
7. リクエストが失敗した場合またはパフォーマンスSLAを超過した場合、デフォルトコンテンツにフォールバック


**パフォーマンス目標：** サブ秒での判定、取得、配信、レンダリング — またはフォールバックコンテンツを表示します。

## インストール

パーソナライゼーションを実行するウェブサイトのすべてのページに、Web SDKのスクリプトタグまたは非同期ローダーを追加します。データエンジニアと連携して、SDKがRT 2.0リアクターとParent Segmentに接続されていることを確認してください。

SDKのスクリプトタグは`<head>`セクションのできるだけ上部に配置してください。`<body>`の下部に配置したり、読み込みを遅延させたりすると、パーソナライゼーションが実行されるまでの時間が長くなります。

## DOM要素への安定したIDの追加

コンテンツスポットは、HTMLの`id`属性で要素を特定します。Personalization Studioでコンテンツスポットを登録する前に、パーソナライズしたいDOM要素に安定した一意の`id`属性があることを確認してください。

## ブラウザセキュリティと埋め込みの回避策

Personalization Studioのいくつかの機能は、アプリケーション内のiframeにウェブサイトを埋め込みます。これにより、コンテンツスポットの選択やコンテンツプレビューに最適な体験が提供されます。ただし、多くのウェブサイトにはiframe埋め込みを防止するブラウザセキュリティ設定があります。

このステップの実施者
**Web Developer**がこれらの回避策を設定するのが一般的です。ブラウザセキュリティヘッダーやドメインレベルの設定に関わるためです。ページの登録やキャンペーンのプレビューを行うDigital Marketerも、ブラウザにRequestlyをインストールする必要がある場合があります。

### Requestlyによるiframe埋め込みの設定

**Requestly**（ChromeおよびFirefox対応）などのブラウザ拡張機能を使用して、Personalization Studioでの作業中にセキュリティヘッダーを一時的に削除します。

1. Chrome Web StoreまたはFirefoxアドオンからRequestlyをインストールします。
2. ウェブサイトのドメインに適用する**Modify Headers**ルールを作成します。
3. 以下のレスポンスヘッダーを**削除**するルールを2つ追加します：
  - `X-Frame-Options`
  - `Content-Security-Policy`
4. Personalization Studioでの作業時にルールを有効にし、作業終了時に無効にします。


URLフィルターを使用してルールを特定のページに制限し、適用範囲を狭くすることもできます。

注意
このステップは、ページの登録やVisual Selectorの使用前に完了する必要があります。Visual Selectorは、Personalization Studio内でウェブサイトを読み込むためにiframe埋め込みが必要です。

### 認証が必要なコンテンツのパーソナライゼーション

ユーザーのログインが必要なコンテンツをパーソナライズする場合：

1. Personalization Studioを開く**前に**、別のブラウザタブでウェブサイトにログインします。
2. ドメイン間でCookieが共有されるよう、ブラウザでサードパーティCookieを有効にします。


**Chromeでサードパーティcookieを有効にする方法：**

1. **設定 > プライバシーとセキュリティ > サードパーティcookie**を開きます。
2. **サードパーティcookieを許可**を選択します。
3. または、**サードパーティcookieの使用を許可するサイト**までスクロールし、**追加**をクリックして、ウェブサイトのURLを入力します。