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

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

最終更新日： 2026年6月16日

作成対象：

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Advertisingの詳細は、XDM ExperienceEvent クラス ​の標準スキーマフィールドグループです。 フィールドグループは、広告インプレッション、クリックスルー、アトリビューションに関連する情報をキャプチャするスキーマに1つの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
文字列
Ad-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
測定
ビューアビリティライブラリを実装したエンドユーザーへの広告のインプレッション。
viewabilityCompletes
測定
ビューアビリティライブラリにより、完了時に閲覧可能と判断されたエンドユーザーに対する広告の完了数。
viewableFirstQuartiles
測定
エンドユーザーに対する広告の第1四分位数は、再生第1四分位数でビューアビリティライブラリによってビューアブルと見なされる。
viewableImpressions
測定
エンドユーザーに対する広告のインプレッションは、ビューアビリティライブラリによって2秒間再生された後にビューアブルと判断される。
viewableMidpoints
測定
ビューアビリティライブラリにより、プレイの中点でビューアブルと見なされるエンドユーザに対する広告の中点。
viewableThirdQuartiles
測定
ビューアビリティライブラリによって第3四分位点で視聴可能と判断されたエンドユーザーに対する広告の第3四分位点。
activeWindow
ブール
ユーザーのデバイスのアクティブなウィンドウに広告が表示されたかどうかを示します。
adHeight
整数
実行時に測定される、プレイヤーの垂直方向のピクセル数。 プレイヤーに追加のコントロールまたはサムネールがある場合は、広告のサイズよりも大きくなる可能性があります。
adUnitDepth
整数
パブリッシャーは、広告のアクセスをページのコードのみに制限するために、広告ユニットをコンテナ（iFrame）に埋め込むことができます。 この値は、広告ユニットがの内部に表示されるコンテナの数を表します。
adWidth
整数
実行時に測定される、プレイヤーの水平方向のピクセル数。 プレイヤーに追加のコントロールまたはサムネールがある場合は、広告のサイズよりも大きくなる可能性があります。
measurementEligible
ブール
広告が視認性測定の資格を有したかどうか。 ユニットにサポートされているクリエイティブフォーマットとタグタイプがある場合、広告は適格です。
percentViewable
整数
測定時に表示可能と判断された広告内のピクセルの割合。
playerVolume
整数
実行時に測定されるプレーヤーのボリュームの割合（0はミュートされ、100は最大ボリュームです）。
viewable
ブール
実行時に広告を表示できるかどうかを示します。 広告の50%以上が1秒以上表示されている場合、ディスプレイ広告は表示可能と見なされます。 ビデオの再生中に広告の50%以上が表示されている場合、ビデオ広告は少なくとも2秒連続して表示されると見なされます。
viewportHeight
整数
実行時に測定された、エクスペリエンスが表示されたウィンドウの垂直方向のサイズ（ピクセル単位）。 Web ビューイベントの場合、この値はブラウザーのビューポートの高さを示します。
viewportWidth
整数
実行時に測定された、ウィンドウ内に表示されたエクスペリエンスの水平サイズ（ピクセル単位）です。 Web ビューイベントの場合、この値はブラウザーのビューポート幅を示します。

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

recommendation-more-help
experience-platform-help-xdm