Adobe Analyticsへの XDM オブジェクト変数のマッピング
Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
- トピック：
- 実装の基本
作成対象：
- 管理者
- 開発者
次の表に、Adobe Experience Platform Edge NetworkがAdobe Analyticsに自動的にマッピングする XDM 変数を示します。 これらの XDM フィールドパスを使用する場合、Adobe Analyticsにデータを送信するための追加設定は必要ありません。 これらのフィールドは、Adobe Analytics ExperienceEvent Template フィールドグループに含まれています。 Adobe AnalyticsとAdobe Experience Platformの両方にデータを送信する場合は、これらのフィールドの使用をお勧めします。
Customer Journey AnalyticsAdobeに移行する予定がある場合は、代わりに、data オブジェクトを使用して、スキーマに準拠せずに直接Adobe Analyticsにデータを送信することをお勧めします。 この方法では、Adobe Analytics ExperienceEvent Template （これはCustomer Journey Analyticsにはあまり適用されません）を使用する代わりに、独自のスキーマを使用できます。 同様のマッピングテーブルについては、Adobe Analyticsへのデータオブジェクト変数のマッピングを参照してください。
値の優先度
このテーブル内のほとんどの XDM オブジェクトフィールドは、 データオブジェクトフィールドと一致します。 特定の XDM オブジェクトフィールドとそれぞれのデータオブジェクトフィールドの両方を設定した場合、データオブジェクトフィールドが優先されます。 XDM オブジェクトフィールドとデータオブジェクトフィールドの両方を使用する場合、Adobeでは、データオブジェクトフィールドを使用してカスタムイベントを設定することをお勧めします。 フィールド data.__adobe.analytics.events が存在する場合は、コマースおよびカスタムイベントに関連するすべての XDM オブジェクトフィールドが上書きされます。
XDM オブジェクトフィールドのマッピング
このテーブルの以前の更新は、このページの GitHub のコミット履歴で確認できます。
XDM フィールドパス
Analytics の変数と説明
xdm.application.isCloseモバイルライフサイクル指標であるクラッシュ回数の定義に役立ちます。
xdm.application.isInstallモバイルライフサイクル指標である初回起動数を増やすタイミングを判断するのに役立ちます。
xdm.application.closeType終了イベントがクラッシュであるかどうかを判断します。有効な値は
close（ライフサイクルセッションが終了し、前のセッションで一時停止イベントを受け取った場合）、unknown（ライフサイクルセッションは一時停止イベントなしで終了する）です。モバイルライフサイクル指標であるクラッシュ回数の設定に役立ちます。xdm.application.isInstallモバイルライフサイクル指標であるインストール数。
xdm.application.isLaunchモバイルライフサイクル指標である起動回数。
xdm.application.nameモバイルライフサイクルディメンションであるアプリ ID の設定に役立ちます。
xdm.application.isUpgradeモバイルライフサイクル指標であるアップグレード回数。
xdm.application.versionモバイルライフサイクルディメンションであるアプリ ID の設定に役立ちます。
xdm.application.sessionLengthモバイルライフサイクル指標である前のセッションの長さ。
xdm.commerce.checkouts.idイベントのシリアル化を「チェックアウト」指標に適用します。
xdm.commerce.checkouts.value「チェックアウト」指標を必要な量だけ増分します。
xdm.commerce.order.currencyCodecurrencyCode 設定変数を設定します。
xdm.commerce.order.purchaseIDpurchaseID ページ変数を設定します。
xdm.commerce.order.payments[0].transactionIDtransactionID ページ変数を設定します。
xdm.commerce.productListAdds.idイベントのシリアル化を「買い物かごへの追加」指標に適用します。
xdm.commerce.productListAdds.value「買い物かごへの追加件数」指標を増分します。
xdm.commerce.productListOpens.idイベントのシリアル化を「買い物かご」指標に適用します。
xdm.commerce.productListOpens.value「買い物かご」指標を増分します。
xdm.commerce.productListRemovals.idイベントのシリアル化を「買い物かごからの削除件数」指標に適用します。
xdm.commerce.productListRemovals.value「買い物かごからの削除件数」指標を増分します。
xdm.commerce.productListViews.idイベントのシリアル化を「買い物かごの表示回数」指標に適用します。
xdm.commerce.productListViews.value「買い物かごの表示回数」指標を増分します。
xdm.commerce.productViews.idイベントのシリアル化を「製品表示回数」指標に適用します。
xdm.commerce.productViews.value「製品表示回数」指標を増分します。
xdm.commerce.purchases.value「注文件数」指標を増分します。
xdm.device.modelモバイルライフサイクルディメンションであるデバイス名。
xdm.device.colorDepth「色深度」ディメンションの設定に役立ちます。
xdm.device.screenHeight「画面の解像度」ディメンションの設定に役立ちます。
xdm.device.screenWidth「画面の解像度」ディメンションの設定に役立ちます。
xdm.device.typeモバイルデバイスのタイプ。
xdm.environment.browserDetails.acceptLanguage言語ディメンションの設定に役立ちます。
xdm.environment.browserDetails.cookiesEnabledxdm.environment.browserDetails.javaEnabledxdm.environment.browserDetails.userAgentフォールバックのユニーク訪問者識別方法として使用します。通常、
User-Agent HTTP リクエストヘッダーを使用して生成します。このフィールドをレポートで使用する場合は、eVar にマッピングできます。xdm.environment.browserDetails.viewportHeightブラウザーの高さディメンションを設定します。
xdm.environment.browserDetails.viewportWidthブラウザーの幅ディメンションを設定します。
xdm.environment.carrierモバイルライフサイクルディメンションである通信事業者名。
xdm.environment.connectionType接続タイプディメンションの設定に役立ちます。
xdm.environment.ipV4フォールバックのユニーク訪問者識別方法として使用します。通常、
X-Forwarded-For HTTP ヘッダーを使用して生成します。xdm.environment._dc.languageモバイルディメンション「ロケール」。 xdm.environment.language が設定されていない場合にのみ使用されます。
xdm.environment.languageモバイルディメンション「ロケール」。
xdm.environment.operatingSystemモバイルライフサイクルディメンションであるオペレーティングシステム。
xdm.environment.operatingSystemVersionモバイルライフサイクルディメンションであるオペレーティングシステムのバージョンの設定に役立ちます。
xdm._experience.analytics.customDimensions.eVars.eVar1[...]xdm._experience.analytics.customDimensions.eVars.eVar250それぞれの eVar ディメンションを設定します。
xdm._experience.analytics.customDimensions.hierarchies.hier1[...]xdm._experience.analytics.customDImensions.hierarchies.hier5それぞれの階層ディメンションを設定します。
xdm._experience.analytics.customDimensions.listProps.prop1.delimiter[...]xdm._experience.analytics.customDimensions.listProps.prop75.delimiterリスト prop の区切り文字の上書き。区切り文字はレポートスイート設定のトラフィック変数管理から自動的に取得されるので、このフィールドの使用はお勧めしません。このフィールドを使用すると、使用される区切り文字と Analytics が想定する区切り文字との間に不一致が発生する可能性があります。
xdm._experience.analytics.customDimensions.listProps.prop1.values[...]xdm._experience.analytics.customDimensions.listProps.prop75.valuesそれぞれのリスト prop 値を含んだ文字列配列。
xdm._experience.analytics.customDimensions.lists.list1.list[].value[...]xdm._experience.analytics.customDimensions.lists.list3.list[].valuexdm._experience.analytics.customDimensions.props.prop1[...]xdm._experience.analytics.customDimensions.props.prop75それぞれの prop ディメンションを設定します。
xdm._experience.analytics.event1to100.event1.id[...]xdm._experience.analytics.event901to1000.event1000.idそれぞれのカスタムイベント指標にイベントのシリアル化を適用します。各イベント ID は、それに対応する 100 グループの親に存在します。例えば、
event678 にシリアル化を適用するには、xdm._experience.analytics.event601to700.event678.id を使用します。xdm._experience.analytics.event1to100.event1.value[...]xdm._experience.analytics.event901to1000.event1000.valueそれぞれのカスタムイベント指標を必要な量だけ増分します。各イベントは、それに対応する 100 グループの親に存在します。例えば、
event567 のフィールドは xdm._experience.analytics.event501to600.event567.value です。xdm.identityMap.ECID[0].idxdm.marketing.trackingCodeトラッキングコードディメンションを設定します。
xdm.media.mediaTimed.completes.valueストリーミングメディア指標 コンテンツ完了。
xdm.media.mediaTimed.dropBeforeStart.valuec.a.media.view、c.a.media.timePlayed、c.a.media.playxdm.media.mediaTimed.federated.valueストリーミングメディア指標 Federated Data。
xdm.media.mediaTimed.firstQuartiles.valueストリーミングメディア指標 25% 進捗マーカー。
xdm.media.mediaTimed.mediaSegmentView.valueストリーミングメディア指標 コンテンツセグメント閲覧回数。
xdm.media.mediaTimed.midpoints.valueストリーミングメディア指標 50% 進捗マーカー。
xdm.media.mediaTimed.pauseTime.valueストリーミングメディア指標 合計一時停止時間。
xdm.media.mediaTimed.pauses.valueストリーミングメディア指標 一時停止イベント。
xdm.mediaCollection.sessionDetails.assetIDストリーミングメディアディメンション アセット ID。
xdm.mediaCollection.sessionDetails.friendlyNameストリーミングメディアディメンション ビデオ名。
xdm.mediaCollection.sessionDetails.originatorストリーミングメディアディメンション 作成者。
xdm.mediaCollection.sessionDetails.episodeストリーミングメディアディメンション エピソード。
xdm.mediaCollection.sessionDetails.genreストリーミングメディアディメンション ジャンル。
xdm.mediaCollection.sessionDetails.ratingストリーミングメディアディメンション コンテンツ評価。
xdm.mediaCollection.sessionDetails.seasonストリーミングメディアディメンション シーズン。
xdm.mediaCollection.sessionDetails.nameストリーミングメディアディメンション コンテンツ ID。
xdm.mediaCollection.sessionDetails.showストリーミングメディアディメンション 表示。
xdm.mediaCollection.sessionDetails.showTypeストリーミングメディアディメンション 表示タイプ。
xdm.mediaCollection.sessionDetails.lengthストリーミングメディアディメンション ビデオの長さ。
xdm.media.mediaTimed.primaryAssetViewDetails.@idストリーミングメディアディメンション メディアセッション ID。
xdm.mediaCollection.sessionDetails.channelストリーミングメディアディメンション コンテンツチャネル。
xdm.mediaCollection.sessionDetails.contentTypeストリーミングメディアディメンション コンテンツタイプ。
xdm.mediaCollection.sessionDetails.networkストリーミングメディアディメンション ネットワーク。
xdm.media.mediaTimed.primaryAssetViewDetails.mediaSegmentView.valueストリーミングメディアディメンション コンテンツセグメント。
xdm.mediaCollection.sessionDetails.playerNameストリーミングメディアディメンション コンテンツプレーヤー名。
xdm.mediaCollection.sessionDetails.appVersionストリーミングメディアディメンション SDK Version。
xdm.mediaCollection.sessionDetails.feedストリーミングメディアディメンション メディアフィードのタイプ。
xdm.mediaCollection.sessionDetails.streamFormatストリーミングメディアディメンション ストリーム形式。
xdm.media.mediaTimed.progress10.valueストリーミングメディア指標 10% 進捗マーカー。
xdm.media.mediaTimed.progress95.valueストリーミングメディア指標 95% 進捗マーカー。
xdm.mediaCollection.sessionDetails.hasResumeストリーミングメディア指標 コンテンツ再開。
xdm.media.mediaTimed.starts.valueストリーミングメディア指標 メディア開始。
xdm.media.mediaTimed.thirdQuartiles.valueストリーミングメディア指標 75% 進捗マーカー。
xdm.media.mediaTimed.timePlayed.valueストリーミングメディア指標 コンテンツ滞在時間。
xdm.media.mediaTimed.totalTimePlayed.valueストリーミングメディア指標 メディア閲覧時間。
xdm.placeContext.geo._schema.latitude訪問者の緯度の位置。 モバイルライフサイクルの場所ディメンションの設定に役立ちます。
xdm.placeContext.geo._schema.longitude訪問者の経度の位置。 モバイルライフサイクルの場所ディメンションの設定に役立ちます。
xdm.placeContext.geo.postalCode「郵便番号」ディメンション。
xdm.placeContext.geo.stateProvince「米国の州」ディメンション。
xdm.placeContext.localTimeデータフィードでは
t_time_info として表示されます。xdm.productListItems[]._experience.analytics.customDimensions.eVars.eVar1[...]xdm.productListItems[]._experience.analytics.customDimensions.eVars.eVar250eVar に 製品構文マーチャンダイジングを適用します。
xdm.productListItems[]._experience.analytics.event1to100.event1.value[...]xdm.productListItems[]._experience.analytics.event901-1000.event1000.valueイベントに product 構文マーチャンダイジングを適用します。
xdm.productListItems[].namexdm.productListItems[].SKUxdm.web.webInteraction.URLlinkURL 実装変数。
xdm.web.webInteraction.namexdm.web.webInteraction.typeクリックされたリンクのタイプを判断します。有効な値は
other（カスタムリンク）、download（ダウンロードリンク）、exit（離脱リンク）です。xdm.web.webPageDetails.URL「ページ URL」ディメンション。
xdm.web.webPageDetails.name「ページ」ディメンション。
xdm.web.webPageDetails.server「サーバー」ディメンション。
xdm.web.webPageDetails.siteSection「サイトセクション」ディメンション。
xdm.web.webReferrer.URL「リファラー」ディメンション。
他の XDM フィールドを Analytics 変数にマッピングする
Adobe Analyticsに追加するディメンションまたは指標がある場合は、 コンテキストデータ変数を通じて行うことができます。
暗黙マッピング
自動的にマッピングされない XDM フィールド要素は、プレフィックス a.x. が付いたコンテキストデータとしてAdobe Analyticsに送信されます。 その後、 処理ルールを使用して、このコンテキストデータ変数を目的の Analytics 変数にマッピングできます。 例えば、次のイベントを送信した場合：
alloy("event",{
"xdm":{
"_atag":{
"search":{
"term":"Example search term"
}
}
}
})
Web SDK は、そのデータをコンテキストデータ変数 a.x._atag.search.term として Adobe Analytics に送信します。その後、処理ルールを使用して、そのコンテキストデータ変数の値を目的の Analytics 変数（eVar など）に割り当てることができます。
明示的マッピング
また、XDM フィールド要素をコンテキストデータとして明示的にマッピングすることもできます。 contextData 要素を使用して明示的にマッピングされた XDM フィールド要素は、接頭辞なしでコンテキストデータとしてAdobe Analyticsに送信されます。 その後、 処理ルールを使用して、このコンテキストデータ変数を目的の Analytics 変数にマッピングできます。 例えば、次のイベントを送信した場合：
alloy("event",{
"xdm":{
"_atag":{
"analytics": {
"contextData" : {
"someValue" : "1"
}
}
}
}
})
Web SDKは、そのデータを値 1 のコンテキストデータ変数 somevalue としてAdobe Analyticsに送信します。 その後、処理ルールを使用して、そのコンテキストデータ変数の値を目的の Analytics 変数（eVar など）に割り当てることができます。
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690