アクションタイプ

Last update: Wed Jun 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

設定した後 Adobe Experience Platform Web SDK タグ拡張機能は、アクションタイプを設定する必要があります。

ここでは、でサポートされるアクションタイプについて説明します Adobe Experience Platform Web SDK タグ拡張機能.

応答を適用 apply-response

の使用 応答を適用 Edge Networkからの応答に基づいて様々なアクションを実行する場合は、「アクションタイプ」を選択します。このアクションタイプは、通常、サーバーがブラウザーに対して最初の呼び出しを行い、その呼び出しから応答を受け取ってEdge Networkーで Web SDK を初期化するハイブリッドデプロイメントで使用されます。

このアクションタイプを使用すると、ハイブリッドパーソナライゼーションのユースケースでクライアントの読み込み時間が短縮される可能性があります。

「応答を適用」アクションタイプを示すExperience Platformユーザーインターフェイスの画像。

このアクションタイプは、次の設定オプションをサポートしています。

Instance：使用している Web SDK インスタンスを選択します。
応答ヘッダー:Edge Networkサーバーコールから返されたヘッダーキーと値を含むオブジェクトを返すデータ要素を選択します。
応答本文:Edge Networkレスポンスで提供される JSON ペイロードを含むオブジェクトを返すデータ要素を選択します。
ビジュアルパーソナライゼーションの決定のレンダリング:Edge Networkが提供するパーソナライゼーションコンテンツを自動的にレンダリングし、ちらつきを防ぐためにコンテンツを事前に非表示にするには、このオプションを有効にします。

イベントを送信 send-event

Adobeにイベントを送信します Experience Platform これにより、Adobe Experience Platformは、お客様が送信したデータを収集し、その情報に基づいて行動することができます。インスタンスを選択します（複数のインスタンスがある場合）。送信したいデータは、以下で送信できます。 XDM データ フィールド。 XDM スキーマの構造に準拠する JSON オブジェクトを使用します。このオブジェクトは、ページ上で作成することも、 カスタムコード データ要素.

イベントを送信アクションタイプには、実装に応じて役立つ他のフィールドがいくつかあります。これらのフィールドはすべてオプションであることに注意してください。

タイプ： このフィールドを使用すると、XDM スキーマに記録されるイベントタイプを指定できます。参照： type が含まれる sendEvent コマンドを使用すると、詳細情報を取得できます。
データ： XDM スキーマに一致しないデータは、このフィールドを使用して送信できます。このフィールドは、Adobe Target プロファイルを更新したり、Target Recommendations属性を送信したりする場合に便利です。参照： data が含まれる sendEvent コマンドを使用すると、詳細情報を取得できます。
データセット ID: データストリームで指定したデータセット以外のデータセットにデータを送信する必要がある場合は、ここでデータセット ID を指定できます。
ドキュメントはアンロードされます： ユーザーがページから移動した場合でも、イベントがサーバーに到達するようにするには、 ドキュメントはアンロードされます チェックボックス。これにより、イベントはサーバーに到達できますが、応答は無視されます。
ビジュアルパーソナライゼーションの決定をレンダリング： ページ上でパーソナライズされたコンテンツをレンダリングする場合は、 ビジュアルパーソナライゼーションの決定のレンダリング チェックボックス。必要に応じて、決定範囲やサーフェスを指定することもできます。を参照してください。パーソナライゼーションドキュメントパーソナライズされたコンテンツのレンダリングに関する詳細情報。

ユーザーから同意を得たら、「同意を設定」アクションタイプを使用して、この同意をAdobe Experience Platform Web SDK に伝える必要があります。現在、「Adobe」と「IAB TCF」の 2 種類の標準がサポートされています。参照：顧客の同意環境設定のサポート. Adobeバージョン 2.0 を使用する場合、データ要素の値のみがサポートされます。同意オブジェクトに解決されるデータ要素を作成します。

このアクションでは、ID マップを含めて同意を得た後で ID を同期できるようにするオプションのフィールドも提供されます。同期は、同意が「保留中」または「アウト」と設定されている場合に役立ちます。これは、同意呼び出しが最初に実行される可能性が高いからです。

変数を更新 update-variable

イベントの結果として XDM オブジェクトを変更するには、このアクションを使用します。このアクションの目的は、後でフォームから参照できるオブジェクトを作成することです イベントを送信 イベント XDM オブジェクトを記録するアクション。

このアクションタイプを使用するには、以下を定義する必要があります。変数データ要素。変更する変数データ要素を選択すると、のエディターと同様のエディターが表示されます XDM オブジェクトデータ要素。

エディターに使用される XDM スキーマは、で選択されたスキーマです。変数データ要素。左側のツリーでプロパティの 1 つをクリックし、右側の値を変更することで、オブジェクトの 1 つ以上のプロパティを設定できます。例えば、次のスクリーンショットでは、producedBy プロパティを、「Produced by data element」というデータ要素に設定しています。

変数の更新アクションのエディターと XDM オブジェクトデータ要素のエディターにはいくつかの違いがあります。まず、変数の更新アクションには、「xdm」というラベルの付いたルートレベル項目があります。この項目をクリックすると、オブジェクト全体の設定に使用するデータ要素を指定できます。次に、変数の更新アクションには、xdm オブジェクトからデータを消去するチェックボックスがあります。左側のプロパティの 1 つをクリックし、右側のチェックボックスをオンにして値をクリアします。これにより、変数の値を設定する前に現在の値がクリアされます。

メディアイベントを送信 send-media-event

メディアイベントをAdobe Experience PlatformまたはAdobe Analytics（あるいはその両方）に送信します。このアクションは、web サイト上のメディアイベントを追跡する場合に役立ちます。インスタンスを選択します（複数のインスタンスがある場合）。このアクションにはが必要です playerId トラッキングされるメディアセッションの一意の ID を表します。また、 エクスペリエンスの品質 および playhead メディアセッション開始時のデータ要素。

メディアイベント送信画面を示す Platform UI 画像。

この メディアイベントを送信 アクションタイプでは、次のプロパティがサポートされています。

Instance：使用されている Web SDK インスタンス。
メディアイベントタイプ：トラッキングするメディアイベントのタイプ。
プレーヤー ID：メディアセッションの一意の ID。
再生ヘッド：メディア再生の現在の位置（秒単位）。
メディアセッションの詳細：メディア開始イベントを送信する場合、必要なメディアセッションの詳細を指定する必要があります。
チャプターの詳細：このセクションでは、チャプター開始メディアイベントを送信する際のチャプターの詳細を指定できます。
広告の詳細：を送信する場合 AdBreakStart イベントには、必要な広告の詳細を指定する必要があります。
広告ポッドの詳細：送信時の広告ポッドに関する詳細 AdStart イベント。
エラーの詳細：トラッキングされている再生エラーに関する詳細。
状態の更新の詳細：更新中のプレーヤーの状態。
カスタムメタデータ：追跡されるメディアイベントに関するカスタムメタデータ。
エクスペリエンスの品質：トラッキングされるエクスペリエンスデータのメディア品質。

Media Analytics トラッカーを取得 get-media-analytics-tracker

このアクションは、従来の Media Analytics API を取得するために使用されます。アクションを設定してオブジェクト名が指定されると、従来の Media Analytics API がそのウィンドウオブジェクトに書き出されます。何も指定されない場合、に書き出されます window.Media 現在の Media JS ライブラリと同様です。

Media Analytics トラッカーを取得アクションタイプを示す Platform UI 画像。