Adobe Analyticsへの XDM オブジェクト変数のマッピング

次の表に、Adobe Experience Platform Edge NetworkがAdobe Analyticsに自動的にマッピングする XDM 変数を示します。 これらの XDM フィールドパスを使用する場合、Adobe Analyticsにデータを送信するための追加設定は必要ありません。 これらのフィールドは、Adobe Analytics ExperienceEvent Template フィールドグループに含まれています。 Adobe AnalyticsとAdobe Experience Platformの両方にデータを送信する場合は、これらのフィールドの使用をお勧めします。

Customer Journey Analyticsに移行する予定がある場合は、Adobeでは、代わりに data オブジェクトを使用して、スキーマに準拠せずに直接Adobe Analyticsにデータを送信することをお勧めします。 この方法では、Adobe Analytics ExperienceEvent テンプレート ​ (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.currencyCode
currencyCode 設定変数を設定します。
xdm.commerce.order.purchaseID
purchaseID ページ変数を設定します。
xdm.commerce.order.payments[0].transactionID
transactionID ページ変数を設定します。
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.cookiesEnabled
cookie サポートディメンションを設定します。有効な値は Y (ブラウザーが cookie を受け入れる)および N (ブラウザーが cookie を拒否する)です。
xdm.environment.browserDetails.javaEnabled
Java 対応ディメンションを設定します。有効な値は Y (Java が有効) と N (Java が無効) です。
xdm.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.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[].value
それぞれの value 配列内のすべての list[] 文字列をそれぞれのリスト変数に連結します。区切り文字は、レポートスイート設定で設定された値に基づいて自動的に選択されます。
xdm._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].id
Adobe Experience Cloud ID サービスの ID
xdm.marketing.trackingCode
トラッキングコードディメンションを設定します。
xdm.media.mediaTimed.completes.value
ストリーミングメディア指標 コンテンツ完了
xdm.media.mediaTimed.dropBeforeStart.value
c.a.media.viewc.a.media.timePlayedc.a.media.play
xdm.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.media.mediaTimed.primaryAssetReference.
@id
ストリーミングメディアディメンション アセット ID
xdm.media.mediaTimed.primaryAssetReference.
dc:title
ストリーミングメディアディメンション ビデオ名
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Creator[N].iptc4xmpExt:Name
ストリーミングメディアディメンション 作成者
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Episode.iptc4xmpExt:Number
ストリーミングメディアディメンション エピソード
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Genre
ストリーミングメディアディメンション ジャンル
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Rating[N].iptc4xmpExt:RatingValue
ストリーミングメディアディメンション コンテンツ評価
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Season.iptc4xmpExt:Number
ストリーミングメディアディメンション シーズン
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Identifier
ストリーミングメディアディメンション コンテンツ ID
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Name
ストリーミングメディアディメンション 表示
xdm.media.mediaTimed.primaryAssetReference.
showType
ストリーミングメディアディメンション 表示タイプ
xdm.media.mediaTimed.primaryAssetReference.
xmpDM:duration
ストリーミングメディアディメンション ビデオの長さ
xdm.media.mediaTimed.primaryAssetViewDetails.
@id
ストリーミングメディアディメンション メディアセッション ID
xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastChannel
ストリーミングメディアディメンション コンテンツチャネル
xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastContentType
ストリーミングメディアディメンション コンテンツタイプ
xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastNetwork
ストリーミングメディアディメンション ネットワーク
xdm.media.mediaTimed.primaryAssetViewDetails.
mediaSegmentView.value
ストリーミングメディアディメンション コンテンツセグメント
xdm.media.mediaTimed.primaryAssetViewDetails.
playerName
ストリーミングメディアディメンション コンテンツプレーヤー名
xdm.media.mediaTimed.primaryAssetViewDetails.
playerSDKVersion.version
ストリーミングメディアディメンション SDK バージョン
xdm.media.mediaTimed.primaryAssetViewDetails.
sourceFeed
ストリーミングメディアディメンション メディアフィードのタイプ
xdm.media.mediaTimed.primaryAssetViewDetails.
streamFormat
ストリーミングメディアディメンション ストリーム形式
xdm.media.mediaTimed.progress10.value
ストリーミングメディア指標 10% 進捗マーカー
xdm.media.mediaTimed.progress95.value
ストリーミングメディア指標 95% 進捗マーカー
xdm.media.mediaTimed.resumes.value
ストリーミングメディア指標 コンテンツ再開
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.eVar250
eVar に 製品構文マーチャンダイジングを適用します。
xdm.productListItems[]._experience.analytics.
event1to100.event1.value
[...]
xdm.productListItems[]._experience.analytics.
event901-1000.event1000.value
イベントに product 構文マーチャンダイジングを適用します。
xdm.productListItems[].productCategories[].categoryID
カテゴリ」ディメンション。product ページ変数も参照してください。
xdm.productListItems[].name
製品」ディメンション。product ページ変数も参照してください。xdm.productListItems[].SKUxdm.productListItems[].name の両方にデータが含まれている場合、xdm.productListItems[].SKU の値が使用されます。
xdm.productListItems[].priceTotal
売上高」指標を判断するのに役立ちます。product ページ変数も参照してください。
xdm.productListItems[].quantity
単位」指標を判断するのに役立ちます。product ページ変数も参照してください。
xdm.productListItems[].SKU
製品」ディメンション。product ページ変数も参照してください。xdm.productListItems[].SKUxdm.productListItems[].name の両方にデータが含まれている場合、xdm.productListItems[].SKU の値が使用されます。
xdm.web.webInteraction.URL
linkURL 実装変数。
xdm.web.webInteraction.name
カスタムリンクダウンロードリンク、または離脱リンクディメンション(xdm.web.webInteraction.type の値によって異なります)。
xdm.web.webInteraction.type
クリックされたリンクのタイプを判断します。有効な値は other(カスタムリンク)、download(ダウンロードリンク)、exit(離脱リンク)です。
xdm.web.webPageDetails.URL
ページ URL」ディメンション。
xdm.web.webPageDetails.isErrorPage
「ページが見つかりませんでした」ディメンションおよび指標を判断するのに役立つフラグ。
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