Web SDK タグ拡張機能の概要
Adobe Experience Platform tags (旧称 Launch)を使用すると、web サイトからEdge NetworkおよびダウンストリームのAdobe ソリューションにイベントデータを送信できます。
これらの手順を実行する前に、次の プロパティ権限 にアクセスできることを確認してください。
- Develop
- Manage extensions
さらに、次のカテゴリにすべての 権限 があることを確認します。
- データモデリング
- ID
XDM スキーマの作成 schema
エクスペリエンスデータモデル(XDM) は、スキーマの形式でデータの共通の構造と定義を提供するオープンソース仕様です。 データをEdge Networkに送信する場合は、スキーマを設定することを強くお勧めします。
- Adobe IDの資格情報を使用して experience.adobe.com にログインします。
- Data Collection/Schemasに移動します。
- Create schema を選択します。
- 「Experience Event」を選択し、「Next」を選択します。
- スキーマに必要な名前を付けて、「Finish」を選択します。
- (オプション)収集する追加データについて、さらにフィールドまたは フィールドグループ を追加できます。
データストリームの作成 datastream
データストリーム とは、送信するデータの処理方法をEdge Networkに指示する設定です。 特定の製品にデータを送信するようにデータストリームを設定すると、データストリームは、関連するデータを、特定の製品が理解できる方法で、各製品に自動的に渡します。
- Data Collection/Datastreamsに移動します。
- New datastream を選択します。
- データストリームに必要な名前を付け、Mapping schema の下で最近作成したスキーマを選択します。
- Save を選択します。
タグプロパティの作成
スキーマとデータストリームを作成したら、タグプロパティを作成して設定できます。
- Data Collection/Tagsに移動します。
- New property を選択します。
- タグプロパティに必要な名前とドメインを指定し、「Save」を選択します。
タグ拡張機能のインストール
Web SDK タグ拡張機能は、指定されたタグプロパティにインストールされます。
- Data Collection/Tags/Extensions に移動します。
- 「Catalog」タブを選択します。
- 検索を使用して Adobe Experience Platform Web SDK 拡張機能を見つけます。
- 拡張機能カードを選択し、右側の「Install」を選択します。
タグ拡張機能の設定
Web SDK タグ拡張機能をインストールすると、自動的に Configuration ページが表示されます。
- データストリーム セクション で、各環境に目的のデータストリームを選択します。
その他の設定は、すべて自己入力かオプションで指定します。 必要な設定を行い、「Save」を選択します。
可変データ要素の作成
Adobeでは、 変数 データ要素を使用して、Adobeに送信するペイロードを保存することをお勧めします。 XDM オブジェクトも使用可能なデータ要素ですが、より古く、該当するユースケースに限られています。
-
Data Collection/Tagsに移動します。
-
目的のタグプロパティを選択します。
-
Data elements/Create new data element を選択します。
-
データ要素に、左側で次のプロパティを指定します。
- Name:任意の名前
- Extension:Adobe Experience Platform Web SDK
- Data element type:Variable
-
右側で次のプロパティを設定します。
変数タイプ:XDM
Sandbox:スキーマを作成したサンドボックス
Schema:目的のスキーマ -
Save を選択します。
ルールの作成
ルールは、何かをトリガーにするタイミングや、変数を設定するタイミングを決定します。 ライブラリが読み込まれるたびに実行されるルールを作成すると、すべてのページに値を含める変数を簡単に入力できます。
-
Data Collection/Tagsに移動します。
-
目的のタグプロパティを選択します。
-
Rules/Add rule を選択します。
-
ルールに目的の名前を付けます。
-
+の横にある「Events」アイコンを選択します。 -
イベントに次の設定を行います。
- Extension:Core
- Event type:Library loaded (page top)
-
Keep changes を選択します。
上記の手順では、ライブラリが読み込まれたらトリガーを実行するという、ルールの条件部分を定義します。 次の手順では、基準を満たした場合のアクションを設定します。
-
+の横にある「Actions」アイコンを選択します。 -
アクションの左側で、次の設定を行います。
- Extension:Adobe Experience Platform Web SDK
- Action type:Send event
-
以下のフィールドを右側に設定します。
- XDM:XDM 変数データ要素
-
Keep changes を選択します。
公開
タグプロパティには、Edge Networkにデータを送信するために必要なすべてのコンポーネントが含まれています。
- Data Collection/Publishing flowに移動します。
- Add library を選択します。
- ライブラリに目的の名前を付けます。 バージョン管理ソフトウェアで作業する場合、この名前はコミット名と似ていると考えてください。
- 環境ドロップダウンメニューを Development に設定します。
- Add all changed resources を選択します。
- Save & build to Development を選択します。
これで、変更が開発環境にデプロイされました。
- Data Collection/Environmentsに移動します。
- 開発環境の横にある「インストール」アイコンを選択します。
- サイトのテスト web ページ内に埋め込みコードをインストールします。
タグが開発環境で動作することを検証したら、Publishing flow インターフェイスを使用してライブラリをステージング環境に公開し、最終的に実稼動環境に公開できます。
- 拡張機能とルールを ライブラリ に追加し、環境 にビルドして、埋め込みコードをサイトにインストールします。
- Adobe Experience Platform Debugger で検証します。
これで、イベントをキャプチャしてEdge Networkに送信するリーン方式の設定ができました。 スキーマにフィールドを追加したり、データストリームに製品を追加したり、タグプロパティにデータ要素を追加したりして、実装をさらに構築できるようになりました。