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 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.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._dc.language
コンテキストデータ変数 a.locale を設定します。 xdm.environment.language が設定されていない場合にのみ使用されます。 Adobeでは、xdm.environment.language でこのフィールドを使用することをお勧めします。
xdm.environment.ipV4
フォールバックのユニーク訪問者識別方法として使用します。通常、X-Forwarded-For HTTP ヘッダーを使用して生成します。
xdm.environment.language
コンテキストデータ変数 a.locale を設定します。 Adobeでは、代わりに xdm.environment._dc.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
a.media.viewa.media.timePlayeda.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.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.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は、そのデータを値 somevalue のコンテキストデータ変数 1 としてAdobe Analyticsに送信します。 その後、処理ルールを使用して、そのコンテキストデータ変数の値を目的の Analytics 変数(eVar など)に割り当てることができます。

検索語句の処理ルール

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690