アクションタイプ
設定した後 Adobe Experience Platform Web SDK タグ拡張機能は、アクションタイプを設定する必要があります。
ここでは、でサポートされるアクションタイプについて説明します Adobe Experience Platform Web SDK タグ拡張機能.
イベントを送信 send-event
Adobeにイベントを送信します Experience Platform これにより、Adobe Experience Platformは、お客様が送信したデータを収集し、その情報に基づいて行動することができます。 インスタンスを選択します(複数のインスタンスがある場合)。 送信したいデータは、以下で送信できます。 XDM データ フィールド。 XDM スキーマの構造に準拠する JSON オブジェクトを使用します。 このオブジェクトは、ページ上で作成することも、 カスタムコード データ要素.
イベントを送信アクションタイプには、実装に応じて役立つ他のフィールドがいくつかあります。 これらのフィールドはすべてオプションであることに注意してください。
- タイプ: このフィールドを使用すると、XDM スキーマに記録されるイベントタイプを指定できます。 参照:
type
が含まれるsendEvent
コマンドを使用すると、詳細情報を取得できます。 - データ: XDM スキーマに一致しないデータは、このフィールドを使用して送信できます。 このフィールドは、Adobe Target プロファイルを更新したり、Target Recommendations属性を送信したりする場合に便利です。 参照:
data
が含まれるsendEvent
コマンドを使用すると、詳細情報を取得できます。 - データセット ID: データストリームで指定したデータセット以外のデータセットにデータを送信する必要がある場合は、ここでデータセット ID を指定できます。
- ドキュメントはアンロードされます: ユーザーがページから移動した場合でも、イベントがサーバーに到達するようにするには、 ドキュメントはアンロードされます チェックボックス。 これにより、イベントはサーバーに到達できますが、応答は無視されます。
- ビジュアルパーソナライゼーションの決定をレンダリング: ページ上でパーソナライズされたコンテンツをレンダリングする場合は、 ビジュアルパーソナライゼーションの決定のレンダリング チェックボックス。 必要に応じて、決定範囲やサーフェスを指定することもできます。 を参照してください。 パーソナライゼーションドキュメント パーソナライズされたコンテンツのレンダリングに関する詳細情報。
同意を設定 set-consent
ユーザーから同意を得たら、「同意を設定」アクションタイプを使用して、この同意を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
メディアセッション開始時のデータ要素。
この メディアイベントを送信 アクションタイプでは、次のプロパティがサポートされています。
- Instance:使用されている Web SDK インスタンス。
- メディアイベントタイプ:トラッキングするメディアイベントのタイプ。
- プレーヤー ID:メディアセッションの一意の ID。
- 再生ヘッド:メディア再生の現在の位置(秒単位)。
- メディアセッションの詳細:メディア開始イベントを送信する場合、必要なメディアセッションの詳細を指定する必要があります。
- チャプターの詳細:このセクションでは、チャプター開始メディアイベントを送信する際のチャプターの詳細を指定できます。
- 広告の詳細:を送信する場合
AdBreakStart
イベントには、必要な広告の詳細を指定する必要があります。 - 広告ポッドの詳細:送信時の広告ポッドに関する詳細
AdStart
イベント。 - エラーの詳細:トラッキングされている再生エラーに関する詳細。
- 状態の更新の詳細:更新中のプレーヤーの状態。
- カスタムメタデータ:追跡されるメディアイベントに関するカスタムメタデータ。
- エクスペリエンスの品質:トラッキングされるエクスペリエンスデータのメディア品質。
Media Analytics トラッカーを取得 get-media-analytics-tracker
このアクションは、従来の Media Analytics API を取得するために使用されます。 アクションを設定してオブジェクト名が指定されると、従来の Media Analytics API がそのウィンドウオブジェクトに書き出されます。 何も指定されない場合、に書き出されます window.Media
現在の Media JS ライブラリと同様です。
次の手順 next-steps
この記事を読むことで、アクションの設定方法に関する理解を深めることができました。 次に、その方法について説明します データ要素タイプの設定.