Web SDK タグ拡張機能の概要
Adobe Experience Platformのtags （旧Launch）を使用して、web サイトからEdge NetworkおよびダウンストリームのAdobe ソリューションにイベントデータを送信します。
次の手順に従う前に、次の プロパティ権限にアクセスできることを確認してください。
- 開発
- 拡張機能の管理
さらに、次のカテゴリのすべての権限を持っていることを確認してください。
- データモデリング
- ID
XDM スキーマの作成 schema
Experience Data Model （XDM） は、スキーマ形式のデータに共通の構造と定義を提供するオープンソースの仕様です。 Edge Networkにデータを送信する場合は、スキーマの設定を強くお勧めします。
- Adobe IDの資格情報を使用してCX Enterpriseにログインします。
- データ収集 > スキーマに移動します。
- 「スキーマを作成」を選択します。
- エクスペリエンスイベントを選択してから、次へを選択します。
- スキーマに目的の名前を付け、終了を選択します。
- （オプション）収集する追加データに対して、さらにフィールドまたは フィールドグループ を追加できます。
データストリームの作成 datastream
データストリーム は、Edge Networkに送信するデータの処理方法を指示する設定です。 特定の製品にデータを送信するようにデータストリームを設定すると、データストリームは、特定の製品が理解する方法で、各製品に関連するデータを自動的に渡します。
- データ収集 > データストリームに移動します。
- 新しいデータストリームを選択します。
- データストリームに目的の名前を付け、マッピングスキーマの下に最近作成したスキーマを選択します。
- 「保存」を選択します。
タグプロパティの作成
スキーマとデータストリームを作成したら、タグプロパティを作成して設定できます。
- データ収集 > タグに移動します。
- 新しいプロパティを選択します。
- タグプロパティに目的の名前とドメインを指定し、保存を選択します。
タグ拡張機能のインストール
Web SDK タグ拡張機能は、特定のタグプロパティにインストールされます。
- Data Collection > Tags > Extensionsに移動します。
- 「カタログ」タブを選択します。
- 検索を使用して、Adobe Experience Platform Web SDK拡張機能を見つけます。
- 拡張カードを選択し、右側の「インストール」を選択します。
タグ拡張機能の設定
Web SDK タグ拡張機能をインストールすると、自動的にConfiguration ページに移動します。
- 「 データストリーム」セクション で、各環境に対して必要なデータストリームを選択します。
その他のすべての設定は、ユーザー用に入力されるか、オプションで入力されます。 必要な設定設定を設定してから、保存を選択します。
変数データ要素の作成
Adobeでは、Variable データ要素を使用して、Adobeに送信するペイロードを保存することをお勧めします。 XDM オブジェクトも使用可能なデータ要素ですが、適用可能なユースケースでは古く、より制限されています。
-
データ収集 > タグに移動します。
-
目的のタグプロパティを選択します。
-
データ要素 > 新しいデータ要素を作成を選択します。
-
左側のデータ要素に次のプロパティを指定します。
- 名前：任意の名前
- 拡張機能: Adobe Experience Platform Web SDK
- データ要素タイプ: 変数
-
右側で次のプロパティを設定します。
変数タイプ: XDM
サンドボックス: スキーマを作成したサンドボックス
スキーマ：目的のスキーマ -
「保存」を選択します。
ルールの作成
ルールによって、トリガーを設定するタイミングや変数を決定します。 ライブラリが読み込まれるたびに実行されるルールを作成すると、各ページに値を含める変数を簡単に入力できます。
-
データ収集 > タグに移動します。
-
目的のタグプロパティを選択します。
-
ルール / ルールを追加を選択します。
-
ルールに目的の名前を付けます。
-
イベントの横にある「
+」アイコンを選択します。 -
イベントに次の設定を指定します。
- 拡張機能: Core
- イベントタイプ: ライブラリが読み込まれました（ページトップ）
-
「変更を保持」を選択します。
上記の手順では、ライブラリが読み込まれたらトリガーするというルールの条件の一部を確立します。 次の手順では、その条件が満たされたときに実行するアクションを確立します。
-
アクションの横にある’
+’ アイコンを選択します。 -
左側のアクションに次の設定を指定します。
- 拡張機能: Adobe Experience Platform Web SDK
- アクションの種類: イベントの送信
-
右側の次のフィールドを設定します。
- XDM: XDM変数データ要素
-
「変更を保持」を選択します。
公開
タグプロパティには、データをEdge Networkに送信するために必要なすべてのコンポーネントが含まれています。
- データ収集 > 公開フローに移動します。
- 「ライブラリを追加」を選択します。
- ライブラリに目的の名前を付けます。 バージョン管理ソフトウェアを使用する場合は、コミット名に似た名前を考えてみましょう。
- 環境ドロップダウンメニューを 開発 に設定します。
- 「変更されたすべてのリソースを追加」を選択します。
- 保存して開発にビルドを選択します。
これで、変更内容が開発環境にデプロイされました。
- データ収集 > 環境に移動します。
- 開発環境の横にあるインストールアイコンを選択します
- サイトのテスト web ページ内に埋め込みコードをインストールします。
タグが開発環境で機能することを検証したら、公開フロー インターフェイスを使用して、ライブラリをステージングに公開し、最終的には実稼動環境に公開できます。
- 拡張機能とルールを ライブラリ に追加し、環境にビルドして、サイトに埋め込みコードをインストールします。
- Adobe Experience Platform Debuggerで検証します。
これで、イベントをキャプチャしてEdge Networkに送信するリーン設定ができました。 スキーマにフィールドを追加したり、データストリームに製品を追加したり、タグプロパティにデータ要素を追加したりして、実装をさらに構築できるようになりました。