ドキュメントExperience Platformエクスペリエンスデータモデル（XDM）ガイド

Advertisingの詳細 ​ スキーマフィールドグループ

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者

Advertisingの詳細 ​ は、XDM ExperienceEvent クラス ​ の標準スキーマフィールドグループです。 フィールドグループは、スキーマに単一の advertising オブジェクトを提供します。これは、広告インプレッション数、クリックスルー数およびアトリビューションに関連する情報をキャプチャします。

フィールドグループ構造

プロパティ
データタイプ
説明
adAssetReference
オブジェクト
広告に関するアセット情報をキャプチャします。 このオブジェクトの構造について詳しくは、次の ​ サブセクション ​ を参照してください。
adAssetViewDetails
オブジェクト
広告再生のビューの詳細をキャプチャします。 このオブジェクトの構造について詳しくは、次の ​ サブセクション ​ を参照してください。
adViewability
オブジェクト
エンドユーザーに表示されるインプレッション数（プレーヤーボリューム、ライブラリのバージョン、ウィンドウのステータス、広告ビューポートのサイズなど）をキャプチャします。 このオブジェクトの構造について詳しくは、次の ​ サブセクション ​ を参照してください。
clicks
測定
広告でのクリックアクションの数。
completes
測定
タイムドメディアアセットが最後まで視聴された回数。 このことは、エンドユーザーが先にスキップした可能性があるので、必ずしもビデオ全体を視聴したことを意味するものではありません。
conversions
測定
パフォーマンス評価のために事前定義済みのアクション（またはアクション）でイベントがトリガーされた回数。
federated
測定
データフェデレーション (お客様間のデータ共有など) を使用してエクスペリエンスイベントが作成されたかどうかを示します。
firstQuartiles
測定
通常の速度で、デュレーションの 25% を再生したデジタルビデオ広告の回数。
impressions
測定
表示される可能性のあるエンドユーザーに送信された広告インプレッションの数。
midpoints
測定
通常の速度で、デュレーションの 50% を再生したデジタルビデオ広告の回数。
starts
測定
デジタルビデオ広告の再生が開始された回数。
thirdQuartiles
測定
通常の速度で、デュレーションの 75% を再生したデジタルビデオ広告の回数。
timePlayed
測定
特定のタイムドメディアアセットでエンドユーザーが費やした時間。
downloadedPlayback
ブール値
true に設定した場合、ダウンロードされた広告セッションの再生に起因してヒットが生成されることを示します。

adAssetReference adAssetReference

adAssetReference オブジェクトは、広告に関するアセット情報をキャプチャします。

adAssetReference 構造

プロパティ
データタイプ
説明
_dc.title
文字列
人間が読み取れる、わかりやすい広告アセットの名前。
_xmpDM.duration
整数
アセットの長さまたはデュレーション （秒）。
_id
文字列
​ 広告 ID 標準 ​ に従った広告アセットの一意の ID。
advertiser
文字列
広告で商品が取り上げられる会社またはブランド。
campaign
文字列
広告キャンペーンの ID。
creativeID
文字列
広告クリエイティブの ID。
creativeURL
文字列
広告クリエイティブの URL。
placementID
文字列
広告のプレースメント ID。
siteID
文字列
広告サイトの ID。

adAssetViewDetails adAssetViewDetails

adAssetViewDetails オブジェクトは、広告再生のためのビューの詳細をキャプチャします。

adAssetViewDetails 構造

プロパティ
データタイプ
説明
adBreak
​ 広告ブレーク ​
タイムド広告がタイムドメディアにどのように挿入されるかを表します。
index
整数
親広告ブレーク内の広告のインデックス。 例えば、最初の広告にはインデックス 0 があり、2 番目の広告にはインデックス 1 があります。
playerName
文字列
広告のレンダリングを担当するプレイヤーの名前。

adViewability adViewability

adViewability オブジェクトは、エンドユーザーに表示されるインプレッション数（プレーヤーボリューム、ライブラリのバージョン、ウィンドウのステータス、広告ビューポートのサイズなど）をキャプチャします。

adViewability 構造

プロパティ
データタイプ
説明
implementationDetails
​ 実装の詳細 ​
視認性指標を測定するために実装されたライブラリの名前とバージョン。
measuredAdNotVisible
測定
インプレッション時にビューアビリティライブラリで測定されたとおりに、広告が表示されないことを示します。
measuredMuted
測定
インプレッション時にビューアビリティライブラリで測定されたとおりに、広告がミュートされていることを示します。
unmeasurableIframe
測定
インプレッション時にビューアビリティライブラリで測定されたとおりに、広告が非アクティブウィンドウに表示されることを示します。
unmeasurableOther
測定
広告が iframe 内に表示されているので、ビューアビリティライブラリが測定を適切に実行できないことを示します。
viewabilityEligibleImpressions
測定
ビューアビリティライブラリを備えたエンドユーザーに対する広告の (1 つまたは複数の) インプレッション。
viewabilityCompletes
測定
ビューアビリティライブラリによって完了時にビューアブルと判断されたエンドユーザーに対する広告の (1 つまたは複数の) 完了。
viewableFirstQuartiles
測定
ビューアビリティライブラリによって再生の第 1 四分位数時にビューアブルと判断されたエンドユーザーに対する広告の (1 つまたは複数の) 第 1 四分位数。
viewableImpressions
測定
ビューアビリティライブラリによって 2 秒間再生された後にビューアブルと判断されたエンドユーザーに対する広告のインプレッション。
viewableMidpoints
測定
ビューアビリティライブラリによって再生の中間点にビューアブルと判断されたエンドユーザーに対する広告の（1 つまたは複数の）中間点。
viewableThirdQuartiles
測定
ビューアビリティライブラリによって再生の第 3 四分位数時にビューアブルと判断されたエンドユーザーに対する広告の (1 つまたは複数の) 第 3 四分位数。
activeWindow
ブール値
広告がユーザーのデバイスのアクティブウィンドウに表示されたかどうかを示します。
adHeight
整数
実行時に測定される、プレイヤーの垂直方向のピクセル数。プレイヤーに追加のコントロールまたはサムネールがある場合は、広告のサイズよりも大きくなる可能性があります。
adUnitDepth
整数
パブリッシャーは、コンテナ（iFrame）内に広告ユニットを埋め込んで、広告のアクセスをページのコードのみに制限することができます。 この値は、広告ユニットが表示されるコンテナの数を表します。
adWidth
整数
実行時に測定される、プレイヤーの水平方向のピクセル数。プレイヤーに追加のコントロールまたはサムネールがある場合は、広告のサイズよりも大きくなる可能性があります。
measurementEligible
ブール値
広告が視認性測定の資格を有したかどうか。ユニットにサポートされているクリエイティブフォーマットとタグタイプがある場合、広告は適格です。
percentViewable
整数
測定時にビューアブルと判断された広告のピクセルの割合。
playerVolume
整数
実行時に測定されたプレイヤーのボリュームの割合。0 はミュートで、100 は最大ボリュームです。
viewable
ブール値
広告が実行時に表示可能だったかどうかを示します。 ディスプレイ広告は、広告の少なくとも 50% が 1 秒間表示される場合に表示可能と見なされます。 ビデオ広告は、ビデオの再生中に広告の 50% 以上が 2 秒以上連続して表示された場合、表示可能と見なされます。
viewportHeight
整数
実行時に測定された、エクスペリエンスが表示されたウィンドウ内の垂直方向のサイズ（ピクセル単位）。 Web ビューイベントの場合、この値は、ブラウザービューポートの高さを示します。
viewportWidth
整数
実行時に測定された、エクスペリエンスが表示されたウィンドウ内の水平方向のサイズ（ピクセル単位）。 Web ビューイベントの場合、この値は、ブラウザービューポートの幅を示します。

フィールドグループについて詳しくは、​ 公開 XDM リポジトリ ​ を参照してください。

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07