Skip to content
Last updated

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を入力します。