Web SDK 拡張機能の設定

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

Web SDK タグ拡張機能は、web プロパティからExperience PlatformEdge Networkを介してAdobe Experience Cloudにデータを送信します。

拡張機能を使用すると、データを Platform にストリーミングし、ID を同期し、顧客同意シグナルを処理して、コンテキストデータを自動的に収集できます。

このドキュメントでは、タグ UI でタグ拡張機能を設定する方法について説明します。

Web SDK タグ拡張機能のインストール install

Web SDK タグ拡張機能には、プロパティをインストールする必要があります。まだ行っていない場合は、タグプロパティの作成に関するドキュメントを参照してください。

プロパティを作成したら、プロパティを開き、左側のバーにある 拡張機能 タブを選択します。

「カタログ」タブを選択します。使用可能な拡張機能のリストから、Web SDK の拡張機能を見つけて インストール を選択します。

Web SDK 拡張機能が選択されたタグ UI を示す画像

インストール を選択した後、Web SDK タグ拡張機能を設定し、設定を保存する必要があります。

NOTE

タグ拡張機能は、設定を保存した後にのみインストールされます。タグ拡張機能の設定方法については、次の節を参照してください。

インスタンス設定を指定 general

ページ上部の設定オプションは、データのルーティング先と、サーバーで使用する設定をAdobe Experience Platformに指示します。

タグ UI の Web SDK タグ拡張機能の一般設定を示す画像

名前:Adobe Experience Platform Web SDK 拡張機能は、ページ上の複数のインスタンスをサポートします。この名前は、タグ設定を持つ複数の組織にデータを送信する場合に使用します。インスタンス名のデフォルトは alloy です。ただし、インスタンス名を任意の有効なJavaScript オブジェクト名に変更できます。
IMS 組織 ID:Adobe時にデータを送信する組織の ID。ほとんどの場合、自動入力されるデフォルト値を使用します。ページ上に複数のインスタンスがある場合、データの送信先の 2 番目の組織の値をこのフィールドに入力します。
Edge ドメイン：拡張機能がデータを送受信するドメイン。 Adobeでは、この拡張機能にファーストパーティドメイン（CNAME）を使用することをお勧めします。デフォルトのサードパーティドメインは開発環境で使用できますが、実稼動環境には適していません。ファーストパーティ CNAME の設定方法については、ここで説明します。

データストリーム設定の指定 datastreams

このセクションでは、使用可能な 3 つの環境（実稼働、ステージング、開発）のそれぞれに使用するデータストリームを選択できます。

リクエストがサーバーに送信されると、Edge Network側の設定を参照するために、データストリーム ID が使用されます。 Web サイト上でコードを変更することなく、設定を更新できます。

データストリームの設定方法については、データストリームに関するガイドを参照してください。

使用可能なドロップダウンメニューからデータストリームを選択するか、値を入力 を選択して、各環境のカスタムデータストリーム ID を入力できます。

タグ UI の Web SDK タグ拡張機能のデータストリーム設定を示す画像

プライバシー設定の指定 privacy

この節では、Web SDK が web サイトからのユーザー同意シグナルをどのように処理するかを設定できます。特に、他の明示的な同意環境設定が指定されていない場合にユーザーが想定されるデフォルトの同意レベルを選択できます。

デフォルトの同意レベルは、ユーザープロファイルに保存されません。

タグ UI の Web SDK タグ拡張機能のプライバシー設定を示す画像

デフォルトの同意レベル

説明

イン

ユーザーが同意環境設定を指定する前に発生するイベントを収集します。

アウト

ユーザーが同意環境設定を指定する前に発生するイベントを破棄します。

保留中

ユーザーが同意環境設定を指定する前に発生するイベントをキューに追加します。同意の環境設定が指定されると、指定された環境設定に応じてイベントが収集または破棄されます。

データ要素によって提供

デフォルトの同意レベルは、定義した別のデータ要素によって決まります。このオプションを使用する場合は、提供されたドロップダウンメニューを使用してデータ要素を指定する必要があります。

TIP

ビジネス運営に明示的なユーザー同意が必要な場合は、「アウト」または 保留中 を使用します。

ID 設定の指定 identity

この節では、ユーザー識別の処理に関する Web SDK の動作を定義できます。

タグ UI の Web SDK タグ拡張機能の ID 設定を示す画像

VisitorAPI から ECID を移行：このオプションはデフォルトで有効になっています。この機能が有効な場合、SDK では、AMCV および s_ecid Cookie を読み取り、Visitor.js で使用される AMCV Cookie を設定できます。この機能は、一部のページがまだ Visitor.js を使用している可能性があるので、Web SDK に移行する際に重要です。このオプションを使用すると、SDK は引き続き同じ ECID を使用できるので、ユーザーが 2 つの異なるユーザーとして識別されることはありません。

サードパーティ cookie を使用：このオプションを有効にすると、Web SDK はユーザー識別子をサードパーティ cookie に保存しようとします。成功した場合、ユーザーは、各ドメインで個別のユーザーとして識別されるのではなく、複数のドメインを移動する際に単一のユーザーとして識別されます。このオプションが有効になっている場合、ブラウザーがサードパーティ cookie をサポートしていない場合や、ユーザーによってサードパーティ cookie を許可しないように設定されている場合には、SDK はサードパーティ cookie にユーザー識別子を保存できない可能性があります。この場合、SDK はファーストパーティドメインにのみ識別子を保存します。

note important
IMPORTANT
>サードパーティ cookie は、Web SDK のファーストパーティデバイス ID 機能と互換性がありません。

ファーストパーティデバイス ID またはサードパーティ Cookie のいずれかを使用できますが、両方の機能を同時に使用することはできません。

パーソナライゼーション設定の指定 personalization

このセクションでは、パーソナライズされたコンテンツの読み込み中にページの特定の部分を非表示にする方法を設定できます。これにより、訪問者にはパーソナライズされたページのみが表示されます。

タグ UI の Web SDK タグ拡張機能のパーソナライゼーション設定を示す画像

Target を at.js から Web SDK に移行：このオプションを使用すると、at.js 1.x または 2.x ライブラリで使用されるレガシー mbox および mboxEdgeCluster Cookie の読み取りと書き込みが Web SDK ーザーに対して有効になります。これにより、訪問者プロファイルを維持しながら、Web SDK を使用するページから at.js 1.x または 2.x ライブラリを使用するページに（またはその逆に）移行できます。

スタイルの事前非表示 prehiding-style

事前非表示のスタイルエディターでは、ページの特定のセクションを非表示にするカスタム CSS ルールを定義できます。ページが読み込まれると、Web SDK はこのスタイルを使用して、パーソナライズの必要なセクションを非表示にし、パーソナライゼーションを取得した後、パーソナライズされたページセクションの非表示を解除します。これにより、訪問者には、パーソナライゼーション取得プロセスが表示されずに、既にパーソナライズされたページが表示されます。

事前非表示のスニペット prehiding-snippet

事前非表示スニペットは、Web SDK ライブラリが非同期で読み込まれる際に役立ちます。この場合、ちらつきを避けるために、Web SDK ライブラリが読み込まれる前にコンテンツを非表示にすることをお勧めします。

事前非表示のスニペットを使用するには、コピーしてページの <head> 要素内に貼り付けます。

IMPORTANT

事前非表示スニペットを使用する場合、Adobeでは事前非表示スタイルで使用したのと同じ CSS ルールを使用することをお勧めします。

データ収集設定の指定 data-collection

データ収集設定を管理します。 configure コマンドを使用すると、JavaScript ライブラリの同様の設定を利用できます。

タグ UI の Web SDK タグ拡張機能のデータ収集設定を示す画像。

On before event send callback: Adobeに送信されたペイロードを評価して変更するコールバック関数。コールバック関数内の content 変数を使用して、ペイロードを変更します。このコールバックは、JavaScript ライブラリの onBeforeEventSend と同等のタグです。
内部リンククリック数を収集：サイトまたはプロパティ内部のリンクトラッキングデータの収集を有効にするチェックボックス。このチェックボックスを有効にすると、イベントのグループ化オプションが表示されます。
- イベントのグループ化なし：リンクトラッキングデータは、別のイベントでAdobeに送信されます。別々のイベントで送信されるリンククリック数は、Adobe Experience Platformに送信されるデータの契約上の使用を増やす可能性があります。
- セッションストレージを使用したイベントのグループ化：次のページイベントまで、リンクトラッキングデータをセッションストレージに保存します。次のページでは、保存されたリンクトラッキングデータとページビューデータが同時にAdobeに送信されます。 Adobeでは、内部リンクをトラッキングする場合にこの設定を有効にすることをお勧めします。
- ローカルオブジェクトを使用したイベントのグループ化：次のページイベントまで、リンクトラッキングデータをローカルオブジェクトに保存します。訪問者が新しいページに移動すると、リンクトラッキングデータが失われます。この設定は、単一ページアプリケーションのコンテキストで最も役立ちます。
外部リンククリック数を収集：外部リンクの収集を有効にするチェックボックス。
ダウンロードリンクのクリック数を収集：ダウンロードリンクの収集を有効にするチェックボックス。
ダウンロードリンク修飾子：リンク URL をダウンロードリンクとして認定する正規表現。
クリックのプロパティをフィルター：コレクション前にクリック関連のプロパティを評価および変更するコールバック関数。この関数は、イベント送信コールバックの前 On に実行されます。
コンテキスト設定：特定の XDM フィールドに値を入力する訪問者情報を自動的に収集します。 すべてのデフォルトのコンテキスト情報 または 特定のコンテキスト情報 を選択できます。これは、JavaScript ライブラリの context と同等のタグです。
- Web：現在のページに関する情報を収集します。
- デバイス：ユーザーのデバイスに関する情報を収集します。
- 環境：ユーザーのブラウザーに関する情報を収集します。
- 場所のコンテキスト：ユーザーの場所に関する情報を収集します。
- 高エントロピーのユーザーエージェントヒント：ユーザーのデバイスに関するより詳細な情報を収集します。

TIP

リンククリックの前にオン送信 フィールドは、既に設定されているプロパティにのみ表示される非推奨のコールバックです。これは、JavaScript ライブラリの onBeforeLinkClickSend と同等のタグです。 フィルタークリックプロパティ コールバックを使用してクリックデータをフィルタリングまたは調整するか、On before event send コールバック を使用して、Adobeに送信されるペイロード全体をフィルタリングまたは調整します。 フィルタークリックのプロパティ コールバックと リンククリックの送信前にオン コールバックの両方が設定されている場合、フィルタークリックのプロパティ コールバックのみが実行されます。

メディアコレクション設定の指定 media-collection

メディア収集機能は、web サイト上のメディアセッションに関連するデータを収集するのに役立ちます。

収集されたデータには、メディアプレイバック、一時停止、完了およびその他の関連イベントに関する情報を含めることができます。収集したら、このデータをAdobe Experience PlatformやAdobe Analyticsに送信して、レポートを生成できます。この機能は、web サイトでのメディア消費行動を追跡および把握するための包括的なソリューションを提供します。

タグ UI の Web SDK タグ拡張機能のメディアコレクション設定を示す画像

Channel：メディアコレクションが実行されるチャネルの名前。例：Video channel。
Player Name：メディアプレーヤーの名前。
アプリケーションのバージョン：メディアプレーヤーアプリケーションのバージョン。
メイン ping 間隔：メインコンテンツに対する ping の頻度（秒単位）。デフォルト値は 10 です。値の範囲は 10 ～ 50 秒です。値を指定しない場合、自動的にトラッキングされるセッションを使用するときにデフォルト値が使用されます。
広告 ping 間隔：広告コンテンツに対する ping の頻度（秒単位）。デフォルト値は 10 です。値の範囲は 1 ～ 10 秒です。値を指定しない場合、自動的にトラッキングされるセッションを使用するときにデフォルト値が使用されます