Web SDK タグ拡張機能の概要

Adobe Experience Platform tags (旧称 Launch)を使用すると、web サイトからEdge NetworkおよびダウンストリームのAdobe ソリューションにイベントデータを送信できます。

これらの手順を実行する前に、次の ​ プロパティ権限 ​ にアクセスできることを確認してください。

  • Develop
  • Manage extensions

さらに、次のカテゴリにすべての ​ 権限 ​ があることを確認します。

  • データモデリング
  • ID

XDM スキーマの作成 schema

​ エクスペリエンスデータモデル(XDM) ​ は、スキーマの形式でデータの共通の構造と定義を提供するオープンソース仕様です。 データをEdge Networkに送信する場合は、スキーマを設定することを強くお勧めします。

  1. Adobe IDの資格情報を使用して experience.adobe.com にログインします。
  2. Data CollectionSchemas​に移動します。
  3. Create schema を選択します。
  4. Experience Event」を選択し、「Next」を選択します。
  5. スキーマに必要な名前を付けて、「Finish」を選択します。
  6. (オプション)収集する追加データについて、さらにフィールドまたは ​ フィールドグループ ​ を追加できます。

スキーマキャンバス

NOTE
保存したスキーマでは、変更 追加 のみが許可されます。 詳しくは、​ スキーマの進化 ​ を参照してください。

データストリームの作成 datastream

​ データストリーム ​ とは、送信するデータの処理方法をEdge Networkに指示する設定です。 特定の製品にデータを送信するようにデータストリームを設定すると、データストリームは、関連するデータを、特定の製品が理解できる方法で、各製品に自動的に渡します。

  1. Data CollectionDatastreams​に移動します。
  2. New datastream を選択します。
  3. データストリームに必要な名前を付け、Mapping schema の下で最近作成したスキーマを選択します。
  4. Save を選択します。

データストリームリスト

タグプロパティの作成

スキーマとデータストリームを作成したら、タグプロパティを作成して設定できます。

  1. Data CollectionTags​に移動します。
  2. New property を選択します。
  3. タグプロパティに必要な名前とドメインを指定し、「Save」を選択します。

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

Web SDK タグ拡張機能は、指定されたタグプロパティにインストールされます。

  1. Data Collection/Tags/Extensions に移動します。
  2. Catalog」タブを選択します。
  3. 検索を使用して Adobe Experience Platform Web SDK 拡張機能を見つけます。
  4. 拡張機能カードを選択し、右側の「Install」を選択します。

SDKのインストール

タグ拡張機能の設定

Web SDK タグ拡張機能をインストールすると、自動的に Configuration ページが表示されます。

  1. ​ データストリーム セクション ​ で、各環境に目的のデータストリームを選択します。

その他の設定は、すべて自己入力かオプションで指定します。 必要な設定を行い、「Save」を選択します。

可変データ要素の作成

Adobeでは、​ 変数 ​ データ要素を使用して、Adobeに送信するペイロードを保存することをお勧めします。 XDM オブジェクトも使用可能なデータ要素ですが、より古く、該当するユースケースに限られています。

  1. Data CollectionTags​に移動します。

  2. 目的のタグプロパティを選択します。

  3. Data elements/Create new data element を選択します。

  4. データ要素に、左側で次のプロパティを指定します。

    • Name:任意の名前
    • Extension:Adobe Experience Platform Web SDK
    • Data element type:Variable
  5. 右側で次のプロパティを設定します。
    変数タイプ:XDM
    Sandbox:スキーマを作成したサンドボックス
    Schema:目的のスキーマ

  6. Save を選択します。

ルールの作成

ルールは、何かをトリガーにするタイミングや、変数を設定するタイミングを決定します。 ライブラリが読み込まれるたびに実行されるルールを作成すると、すべてのページに値を含める変数を簡単に入力できます。

  1. Data CollectionTags​に移動します。

  2. 目的のタグプロパティを選択します。

  3. Rules/Add rule を選択します。

  4. ルールに目的の名前を付けます。

  5. + の横にある「Events」アイコンを選択します。

  6. イベントに次の設定を行います。

    • Extension:Core
    • Event type:Library loaded (page top)
  7. Keep changes を選択します。

上記の手順では、ライブラリが読み込まれたらトリガーを実行するという、ルールの条件部分を定義します。 次の手順では、基準を満たした場合のアクションを設定します。

  1. + の横にある「Actions」アイコンを選択します。

  2. アクションの左側で、次の設定を行います。

    • Extension:Adobe Experience Platform Web SDK
    • Action type:Send event
  3. 以下のフィールドを右側に設定します。

    • XDM:XDM 変数データ要素
  4. Keep changes を選択します。

アクション設定

公開

タグプロパティには、Edge Networkにデータを送信するために必要なすべてのコンポーネントが含まれています。

  1. Data CollectionPublishing flow​に移動します。
  2. Add library を選択します。
  3. ライブラリに目的の名前を付けます。 バージョン管理ソフトウェアで作業する場合、この名前はコミット名と似ていると考えてください。
  4. 環境ドロップダウンメニューを Development に設定します。
  5. Add all changed resources を選択します。
  6. Save & build to Development を選択します。

これで、変更が開発環境にデプロイされました。

  1. Data CollectionEnvironments​に移動します。
  2. 開発環境の横にある「インストール」アイコンを選択します。
  3. サイトのテスト web ページ内に埋め込みコードをインストールします。

タグが開発環境で動作することを検証したら、Publishing flow インターフェイスを使用してライブラリをステージング環境に公開し、最終的に実稼動環境に公開できます。

  1. 拡張機能とルールを ライブラリ に追加し、環境 にビルドして、埋め込みコードをサイトにインストールします。
  2. Adobe Experience Platform Debugger で検証します。

これで、イベントをキャプチャしてEdge Networkに送信するリーン方式の設定ができました。 スキーマにフィールドを追加したり、データストリームに製品を追加したり、タグプロパティにデータ要素を追加したりして、実装をさらに構築できるようになりました。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743