Web SDK 拡張機能の設定

Last update: Thu Jul 11 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 タグ拡張機能には、プロパティをインストールする必要があります。まだ行っていない場合は、のドキュメントを参照してください。タグプロパティの作成.

プロパティを作成したら、プロパティを開き、 拡張機能 左側のバーの Tab キー。

「」を選択します カタログ タブ。使用可能な拡張機能のリストから、を見つけます 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 タグ拡張機能のプライバシー設定を示す画像

デフォルトの同意レベル

説明

対象：

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

Out

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

保留中

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

データ要素によって提供

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

TIP

使用方法 Out または 保留中 ビジネス運営に関して明示的なユーザー同意が必要な場合。

ID 設定の指定 identity

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

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

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

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

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

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

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

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

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

at.js から Web SDK への Target の移行：このオプションを使用して有効にします Web SDK レガシーの読み書きを行う mbox および mboxEdgeCluster at.js で使用される cookie 1.x または 2.x ライブラリ。これにより、訪問者プロファイルを維持しながら、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

データ収集設定を管理します。 JavaScript ライブラリの同様の設定は、 configure コマンド。

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

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

TIP

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

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

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

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

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

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