[ベータ版]{class="badge informative"}

Adobe Advertising ExperienceEvent Full Extension スキーマフィールドグループ

AVAILABILITY
Adobe Advertising ExperienceEvent Full Extension フィールドグループは現在ベータ版です。 ドキュメントと機能は変更される場合があります。

Adobe Advertising ExperienceEvent Full Extensionは、XDM ExperienceEvent classの標準スキーマフィールドグループで、Adobe Advertising(旧称「Advertising Cloud」)によって収集される一般的な指標をキャプチャします。

このドキュメントでは、Advertising拡張機能フィールドグループの構造と使用例について説明します。

NOTE
このフィールドグループ をExperience Platform UIで検索したり、​ パブリック XDM リポジトリ ​でスキーマ全体を表示したりすることもできます。

フィールドグループ構造

フィールドグループは、スキーマに単一の _experience オブジェクトを提供し、スキーマ自身には単一の adcloud オブジェクトが含まれます。

​ フィールドグループ Advertisingの最上位フィールド ​

プロパティ
データタイプ
説明
adDeliveryDetails
オブジェクト
広告配信の詳細: このオブジェクトの内容について詳しくは、​ オブジェクト adDeliveryDetailsの以下の サブセクションを参照してください。
advertisement
オブジェクト
デジタル広告の詳細。 このオブジェクトの内容について詳しくは、広告オブジェクト の以下の サブセクションを参照してください。
campaign
オブジェクト
キャンペーン階層の詳細: このオブジェクトの内容について詳しくは、キャンペーンオブジェクト の以下の サブセクションを参照してください。
conversionDetails
オブジェクト
広告のコンバージョンの詳細。 このオブジェクトの内容については詳しくは、次のサブセクションを参照してください。
eventType
文字列
Adobe Advertising イベントタイプ。
fees
オブジェクト
Advertising料金の詳細。 このオブジェクトの内容について詳しくは、料金オブジェクト の以下の サブセクションを参照してください。
inventory
オブジェクト
在庫の詳細: このオブジェクトの内容については詳しくは、次のサブセクションを参照してください。
productDetails
オブジェクト
商品の広告の詳細。 このオブジェクトの内容について詳しくは、productDetails オブジェクト の以下の サブセクションを参照してください。
stitchId
文字列
サードパーティ Cookieをブロックするブラウザーでクリックスルーのコンバージョンを追跡するための、Adobe Advertising広告サーバーのID。

adDeliveryDetails adDeliveryDetails

adDeliveryDetails オブジェクトは、広告が配信された場所と方法に関する情報(プレースメント web サイトや位置識別子など)を提供します。

オブジェクトとそのフィールドを示す スキーマ図。

プロパティ
データタイプ
説明
placementWebsite
文字列
広告が表示されたweb サイト。
siteLinkText
文字列
広告で選択された実際のサイトリンク。
interestLocationID
文字列
検索クエリから推測された場所。 例えば、「ゴアのホテル」のクエリは、ユーザーの実際の閲覧場所に関係なく、ゴアのIDを返します。
physicalLocationID
文字列
ユーザーのブラウジング場所。広告ネットワークからの参照IDで表されます。 このIDは、読み取り可能な場所の名前(都市や国など)ではなく、広告ネットワークによって地理的なターゲットを識別するために割り当てられたコードです。

Advertising オブジェクトは、デジタル広告に関する詳細(識別子、タイプ、クリエイティブ、ターゲティング、関連キーワードなど)を記述します。

オブジェクトとそのフィールドを示す スキーマ図。

プロパティ
データタイプ
説明
adId
文字列
このイベントに関連付けられた広告の識別子。 このIDは、Ad-ID業界標準とは関係ありません。
runtime
文字列
広告ユニットのランタイム。ブラウザーまたはオペレーティングシステムのランタイムとは異なります。 指定できる値はunknownHTML5です。
adClass
文字列
ドライビングイベントの広告クラス : displayvideo、またはsocial
adUnitType
文字列

ブラウザーまたはデバイスで広告をレンダリングするコードの識別子。 指定できる値には以下のものがあります。

  • linearVideo: リニア ビデオ
  • interactiveVideo: インタラクティブビデオ
  • banner: バナー,
  • richMediaBanner: リッチメディアバナー,
  • newsFeedVideo: ニュースフィードのビデオ,
  • newsFeedDisplay: ニュースフィード表示,
  • HTML5: HTML5,
  • inPageVideo: ページのビデオで,
  • inPageDisplay: ページの表示中
  • facebook: Facebook,
  • twitter: Twitter,
  • linearTv: リニア TV,
  • vod: ビデオ オンデマンド
promotedAssetId
文字列
このイベントに関連付けられた広告でプロモーションされるアセットの識別子。
creativeID
文字列
このイベントに関連付けられた広告クリエイティブ(バナー、ビデオ、ソーシャル広告など)の識別子。
keywordID
文字列
このイベントをトリガーした検索クエリでユーザーが入力したキーワードの識別子。
keyword
文字列
顧客が入札したリストキーワード。
isDynamicSearchAd
ブール
イベントが動的検索広告から発生しているかどうかを示します。
audienceID
文字列
広告のターゲットとなるオーディエンスセグメントの識別子。
adGroupID
文字列
このイベントをトリガーした広告に関連付けられた広告グループの識別子。
campaignID
文字列
このイベントをトリガーした広告に関連付けられたキャンペーンの識別子。
networkType
文字列

イベントが発生したネットワークタイプ。 指定できる値には以下のものがあります。

  • search:広告が検索ネットワークに表示されました。
  • content:広告がコンテンツ ネットワークに表示されました。
matchType
文字列

キーワード一致タイプ。 指定できる値には以下のものがあります。

  • exact: キーワードの完全一致
  • broad: キーワードの幅広い一致
  • phrase: キーワードの語句一致

campaign campaign

キャンペーンオブジェクトは、通貨の詳細とともに、アカウント、広告主、プレースメント、パッケージ識別子などの広告キャンペーン階層を定義します。

オブジェクトとそのフィールドを示す スキーマ図。

プロパティ
データタイプ
説明
accountId
文字列
アカウントの識別子。
dspId
文字列
キャンペーンが定義されるDemand Side Platform(DSP)のID。 通常、このIDはAdobe Advertising DSPのIDです。
campaignId
文字列
キャンペーンの識別子。
placementId
文字列
プレースメントの識別子。
packageId
文字列
Advertising DSP パッケージの識別子。
advertiserId
文字列
広告主の識別子。
experimentId
文字列
実験の識別子。
sampleGroupId
文字列
サンプルグループの識別子。
currency
文字列
アカウントのISO 4217請求通貨コード。 正規表現パターン [1]{3}$(大文字3文字)を使用します。 例:USD、EUR。

conversionDetails conversionDetails

conversionDetails オブジェクトは、トラッキングコード、ID、コンバージョンプロパティなど、広告コンバージョンのトラッキング情報を取得します。

![​ オブジェクトとそのフィールドを示すconversionDetails スキーマ図。](https://experienceleague.adobe.com/docs/experience-platform/assets/conversionDetails.png?lang=ja"conversionDetails フィールド ")

プロパティ
データタイプ
説明
trackingCode
文字列
イベントのコンバージョントラッキングコード。 使用可能な形式の一覧については、AMO ID形式を参照してください。
trackingIdentities
文字列
イベントのEF ID、またはトラッキング IDの詳細。 使用可能な形式の一覧については、EF ID形式を参照してください。
conversionProperties
オブジェクト
変換プロパティのマップ。キーと値のペア文字列(subscriptions=253など)の配列として表されます。

fees fees

手数料オブジェクトは、Advertising DSP、アカウント、広告主ごとに分類された、メディア、データ、その他の広告コストをキャプチャします。

オブジェクトとそのフィールドを示す スキーマ図。

プロパティ
データタイプ
説明
DSPMediaFees
数値
Advertising DSPが請求する広告料。
DSPDataFees
数値
Advertising DSPが請求するデータ料金。
DSPOtherFees
数値
Advertising DSPが請求するその他の料金。
accountMediaFees
数値
Advertising DSPはアカウントの広告料を請求できますが、請求することはできません。
accountDataFees
数値
Advertising DSPでは請求できないが、アカウントのデータ料金はかかります。
accountOtherFees
数値
その他の手数料はアカウントに対して発生しますが、Advertising DSPからは請求できません。
advertiserMediaFees
数値
広告主にアカウントから請求されるメディア広告主料金。
advertiserDataFees
数値
アカウントから広告主に請求されるその他の広告主料金。
advertiserOtherFees
数値
アカウントから広告主に請求されるその他の広告主料金。
billableMediaNetSpend
数値
メディア広告の請求可能な純支出。
totalMediaNetSpend
数値
メディア広告の総支出額。
billableDataNetSpend
数値
データ広告の請求可能な正味費用。
billableOtherNetSpend
数値
他の種類の広告に対する請求可能な正味支出。
totalBillableNetSpend
数値
請求可能な正味支出の合計。
totalNonBillableNetSpend
数値
請求不可の正味支出の合計。
totalNetSpend
数値
純支出合計。

inventory inventory

在庫オブジェクトには、セッションデータ、パートナーコード、サイト ID、コスト通貨、セグメンテーションルールなど、広告在庫の商談に関する詳細が記録されます。

オブジェクトとそのフィールドを示す スキーマ図。

プロパティ
データタイプ
説明
sessionId
文字列
エクスペリエンスイベントに関連付けられたセッション ID。同じセッションで発生した独立したイベントをリンクするために使用されます。
feedID
文字列
パブリッシャー、広告交換、およびその他の機能の複合ID。
sspPartnerCode
文字列
Adobe Advertisingがインベントリの商談を受け取るパートナー(交換)。
siteID
文字列
広告インプレッションが配信されたweb サイトの識別子。
costCurrency
文字列
広告機会に対するパートナーへの支払いに使用されるISO 4217通貨コード。 値は、正規表現パターン [2]{3}$ (3つの大文字)に従う必要があります。 例:USD、EUR。
inventorySourceId
文字列
このオポチュニティが配信されたAdobe Advertising インベントリ ソースのID。
segment
オブジェクト

ユーザーセグメンテーションルールに関連する詳細。 そのプロパティは次のとおりです。

  • attributablePartnerId (文字列): attributableSegmentIdを所有するセグメントプロバイダーの識別子。
  • attributableSegmentId (文字列): プレースメントのターゲティングルールでユーザーターゲティング用にクレジットされたセグメント。 これは、コストの追跡とパートナーの支払いの目的で使用されます。
  • segments (文字列): ユーザーが属していたユーザーセグメント a\)と、広告がターゲットにしていたユーザーセグメント b\)の積集合。 これは、オークション時にユーザーが属していたセグメントの完全なリストではありません。
optimizationTag
文字列
最適化に関連するタグ。
attributableDeviceGraphId
文字列
コンバージョンイベントに関連付けられたデバイスグラフの識別子。

productDetails productDetails

productDetails オブジェクトには、製品識別子、国、言語、パーティション、タイトル、広告タイプなど、Adobe Advertising Search, Social, & Commerceのショッピング広告で取り上げられた製品に関する情報が含まれています。

オブジェクトとそのフィールドを示す スキーマ図。

プロパティ
データタイプ
説明
productID
文字列
このイベントに関連付けられた広告で取り上げられた製品の識別子。
country
文字列
イベントに関連する広告に表示された製品の販売国。
language
文字列
顧客のMerchant Center データフィードに示されている製品情報の言語。
partitionID
文字列
このイベントの広告に関連付けられている製品グループの識別子。
title
文字列
広告に表示されている製品タイトル。
adType
文字列

Google ショッピング キャンペーンで使用される製品の広告タイプ。 指定できる値には以下のものがあります。

  • pla_with_pog: イベントがショッピング広告を通じて購入された場合
  • pla: イベントがショッピング広告から発生した日時。
  • pla_multichannel: ショッピング広告のイベントに「オンライン」と「ローカル」の両方のショッピングチャネルのオプションが含まれている場合。
  • pla_with_promotion: ショッピング広告のイベントに加盟店のプロモーションが表示された場合。

次の手順

このドキュメントでは、Adobe Advertising拡張機能フィールドグループの構造とユースケースについて説明しました。 フィールドグループ自体の詳細については、公開 XDM リポジトリを参照してください。

このフィールドグループを使用してAdobe Experience Platform Web SDKを使用してAdvertising データを収集する場合は、​ データストリームの設定に関するガイドを参照して、サーバー側のXDMにデータをマッピングする方法を確認してください。

  1. A-Z ↩︎

  2. A-Z ↩︎

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