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

Adobe Advertising Cloud ExperienceEvent 完全拡張 ​ スキーマフィールドグループ

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

Adobe Advertising Cloud ExperienceEvent 完全拡張 ​ は、XDM ExperienceEvent クラス ​ の標準スキーマフィールドグループで、Adobe Advertising(以前の「Advertising Cloud」)が収集する共通のメトリクスをキャプチャするものです。

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

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

フィールドグループ構造

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

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

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

adDeliveryDetails adDeliveryDetails

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

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

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

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

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

プロパティ
データタイプ
説明
adId
文字列
このイベントに関連付けられている広告の識別子。 この ID は Ad-ID 業界標準とは関係がありません。
runtime
文字列
広告ユニットのランタイム。ブラウザーやオペレーティングシステムのランタイムとは異なります。 使用可能な値:unknown および HTML5
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)の識別子。 通常、この識別子は Adobe Advertising Cloud 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 Cloud が広告在庫を表示するパートナー(取引所)。
siteID
文字列
広告インプレッションが提供された web サイトの識別子。
costCurrency
文字列
広告機会に対するパートナーへの支払いに使用される ISO 4217 通貨コード。 値は正規表現パターン[2]{3}$ (3 つの大文字)に従う必要があります。 例:USD、EUR。
inventorySourceId
文字列
このオポチュニティが配信された Adobe Advertising Cloud インベントリソースの ID。
segment
オブジェクト

ユーザーのセグメント化ルールに関連付けられた詳細。 プロパティは次のとおりです。

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

productDetails productDetails

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

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

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

買い物キャンペーンで使用される商品 Google 広告タイプ。 指定できる値には以下のものがあります。

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

次の手順

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

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

  1. A-Z ↩︎

  2. A-Z ↩︎

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