ドキュメント Experience Platform モバイルアプリチュートリアル

Analytics データの収集とマッピング

Last update: Wed Sep 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

初心者
中級
開発者

モバイルデータをAdobe Analyticsにマッピングする方法について説明します。

以前のレッスンで収集して Platform Edge Networkに送信したイベントデータは、Adobe Analyticsを含むデータストリームで設定されたサービスに転送されます。データをレポートスイートの正しい変数にマッピングします。

アーキテクチャ {modal="regular"}

前提条件

ExperienceEvent トラッキングの理解。
サンプルアプリで XDM データを正常に送信しました。
このレッスンで使用できるAdobe Analytics レポートスイート。

学習目標

このレッスンでは、次の操作を行います。

Adobe Analytics サービスを使用してデータストリームを設定します。
Analytics 変数の自動マッピングについて説明します。
XDM データを Analytics 変数にマッピングする処理ルールを設定します。

Adobe Analytics データストリームサービスを追加

XDM データをEdge NetworkからAdobe Analyticsに送信するには、データストリームの作成の一部として設定したデータストリームに対して、Adobe Analytics サービスを設定します。

データ収集 UI で、「データストリーム とデータストリームを選択します。
次に、「 サービスを追加」を選択します。
サービス リストから Adobe Analytics を追加します。
レポートスイート ID で使用する、Adobe Analyticsのレポートスイートの名前を入力します。
有効をオンにしてサービスを有効にします。
「保存」を選択します。

{modal="regular"}

自動マッピング

標準 XDM フィールドの多くは、Analytics 変数に自動的にマッピングされます。完全なリストを参照してください。

例#1 - s.products

良い例は、処理ルールを使用して入力できない products 変数です。 XDM 実装を使用すると、必要なデータをすべて productListItems に渡し、Analytics マッピング s.products よってデータが自動的に入力されます。

このオブジェクトは、

"productListItems": [
    [
      "name":  "Yoga Mat",
      "SKU": "5829",
      "priceTotal": "49.99",
      "quantity": 1
    ],
    [
      "name":  "Water Bottle",
      "SKU": "9841",
      "priceTotal": "30.00",
      "quantity": 3
    ]
]

結果：

s.products = ";5829;1;49.99,9841;3;30.00"

NOTE

productListItems[].SKU と productListItems[].name の両方にデータが含まれている場合、productListItems[].SKU の値が使用されます。詳しくは、Adobe Experience Edgeの Analytics 変数のマッピングを参照してください。

例#2 - scAdd

詳しく見ると、すべてのイベントには value （必須）と id （オプション）の 2 つのフィールドがあります。 value フィールドは、イベント数を増分するために使用されます。シリアル化には id フィールドを使用します。

このオブジェクトは、

"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}

結果：

s.events = "scAdd"

このオブジェクトは、

"commerce" : {
  "productListAdds" : {
    "value" : 1,
    "id": "321435"
  }
}

結果：

s.events = "scAdd:321435"

Assurance での検証

Assuranceを使用するとエクスペリエンスイベントを送信しており、XDM データが正しく、Analytics マッピングが期待どおりに行われていることを確認できます。

設定手順の節を参照して、シミュレーターまたはデバイスをAssuranceに接続します。
productListAdds イベントを送信します（バスケットに製品を追加します）。
ExperienceEvent ヒットを表示します。

{modal="regular"}

JSON の XDM 部分を確認します。

code language-json

code language-json
`"xdm" : { "productListItems" : [ { "SKU" : "LLWS05.1-XS", "name" : "Desiree Fitness Tee", "priceTotal" : 24 } ], "timestamp" : "2023-08-04T12:53:37.662Z", "eventType" : "commerce.productListAdds", "commerce" : { "productListAdds" : { "value" : 1 } } // ...`

"xdm" : {
  "productListItems" : [ {
    "SKU" : "LLWS05.1-XS",
    "name" : "Desiree Fitness Tee",
    "priceTotal" : 24
  } ],
"timestamp" : "2023-08-04T12:53:37.662Z",
"eventType" : "commerce.productListAdds",
"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}
// ...

analytics.mapping イベントを確認します。

{modal="regular"}

Analytics マッピングには、以下のことに注意してください。

イベント には、scAdd に基づく commerce.productListAdds が入力されます。
pl （products 変数）には、productListItems に基づいて連結された値が入力されます。
このイベントには、すべてのコンテキストデータを含む他の興味深い情報があります。

コンテキストデータを使用したマッピング

Analytics に転送された XDM データは、標準フィールドとカスタムフィールドの両方を含むコンテキストデータに変換されます。

コンテキストデータキーは、次の構文に従って作成されます。

a.x.[xdm path]

例：

// Standard Field
a.x.commerce.saveforlaters.value

// Custom Field
a.x._techmarketingdemos.appinformation.appstatedetails.screenname

NOTE

カスタムフィールドは、Experience Cloud組織識別子の下に配置されます。

テナント名 _techmarketingdemos は組織の一意の値に置き換えられます。

この XDM コンテキストデータをレポートスイートの Analytics データにマッピングするには、次の操作を実行します。

フィールドグループの使用

Adobe Analytics ExperienceEvent Full Extension フィールドグループをスキーマに追加します。

{modal="regular"}
イベントデータを追跡レッスン、またはで行ったのと同様に、Adobe Analytics ExperienceEvent フル拡張機能フィールドグループに従って、アプリに XDM ペイロードを作成します
ルールアクションを使用してAdobe Analytics ExperienceEvent 完全拡張フィールドグループにデータを添付または変更するルールを、タグプロパティ内に作成します。詳しくは、SDK イベントへのデータの添付または SDK イベントのデータの変更を参照してください。

マーチャンダイジング eVar

Analytics の設定でマーチャンダイジング eVar を使用している場合、そのマーチャンダイジング情報を取得するために、イベントデータの追跡で定義した XDM ペイロードを拡張する必要があります。マーチャンダイジング var の例として、商品の色を取得するタイミング（evar1 など）を &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60 します

JSON の場合：

code language-json

code language-json
`{ "productListItems": [ { "SKU": "LLWS05.1-XS", "name": "Desiree Fitness Tee", "priceTotal": 24, "_experience": { "analytics": { "events1to100": { "event10": { "value": 50 } }, "customDimensions": { "eVars": { "eVar1": "red", } } } } } ], "eventType": "commerce.productListAdds", "commerce": { "productListAdds": { "value": 1 } } }`

{
  "productListItems": [
      {
          "SKU": "LLWS05.1-XS",
          "name": "Desiree Fitness Tee",
          "priceTotal": 24,
          "_experience": {
              "analytics": {
                  "events1to100": {
                      "event10": {
                          "value": 50
                      }
                  },
                  "customDimensions": {
                      "eVars": {
                          "eVar1": "red",
                      }
                  }
              }
          }
      }
  ],
  "eventType": "commerce.productListAdds",
  "commerce": {
      "productListAdds": {
          "value": 1
      }
  }
}

コード内：

code language-swift

code language-swift
`var xdmData: [String: Any] = [ "productListItems": [ [ "name": productName, "SKU": sku, "priceTotal": priceString, "_experience" : [ "analytics": [ "events1to100": [ "event10": [ "value:": value ] ], "customDimensions": [ "eVars": [ "eVar1": color ] ] ] ] ] ], "eventType": "commerce.productViews", "commerce": [ "productViews": [ "value": 1 ] ] ]`

var xdmData: [String: Any] = [
  "productListItems": [
    [
      "name":  productName,
      "SKU": sku,
      "priceTotal": priceString,
      "_experience" : [
        "analytics": [
          "events1to100": [
            "event10": [
              "value:": value
            ]
          ],
          "customDimensions": [
            "eVars": [
              "eVar1": color
            ]
          ]
        ]
      ]
    ]
  ],
  "eventType": "commerce.productViews",
  "commerce": [
    "productViews": [
      "value": 1
    ]
  ]
]

処理ルールの使用

このデータを使用した処理ルールは、次のようになります。

a.x._techmarketingdemo.appinformation.appstatedetails.screenname （4） が設定されている場合は、（1） アプリ画面名（eVar2） （2）を a.x._techmarketingdemo.appinformation.appstatedetails.screenname a.x._techmarketingdemo.appinformation.appstatedetails.screenname の値に上書き （5）します。
a.x.commerce.saveForLaters.value （コンテキスト） （9） が設定されている場合は、（イベント （6） ウィッシュリストに追加（イベント 3） （7）を a.x.commerce.saveForLaters.value （コンテキスト） （8）に追加（10）します。

analytics 処理ルール {modal="regular"}

IMPORTANT

自動的にマッピングされた変数の一部は、処理ルールで使用できない場合があります。

処理ルールに初めてマッピングする場合、インターフェイスには XDM オブジェクトからのコンテキストデータ変数は表示されません。この問題を修正するには、任意の値を選択し、保存してから、編集に戻ります。すべての XDM 変数が表示されます。

処理ルールを使用した contextData 変数の prop および eVar へのマッピングを参照してください。

TIP

以前のモバイルアプリ実装とは異なり、ページ/画面ビューと他のイベントの区別はありません。代わりに、処理ルールで ページ名 ディメンションを設定して、ページビュー 指標を増分できます。このチュートリアルではカスタム screenName フィールドを収集しているので、処理ルールで画面名を ページ名 にマッピングすることを強くお勧めします。

Analytics モバイル拡張機能からの移行

Adobe Analytics モバイル拡張機能を使用してモバイルアプリケーションを開発した場合は、MobileCore.trackAction および MobileCore.trackState の API 呼び出しを使用している可能性が高くなります。

推奨されるEdge Networkを使用して移行する場合は、次の選択肢があります。

イベントデータのトラッキング方法のレッスンで示すように Edge.sendEventEdge Network拡張機能を実装し、🔗 API を使用します。このチュートリアルでは、この実装に焦点を当てています。
Edge Bridge拡張機能を実装し、MobileCore.trackAction および MobileCore.trackState API 呼び出しを引き続き使用します。詳細と別のチュートリアルについては、Edge Bridge拡張機能の実装を参照してください。

SUCCESS

データストリームでAdobe Analytics サービスを有効にして、Experience Edge XDM オブジェクトをAdobe Analytics変数にマッピングするようにアプリを設定しました。該当する場合は、処理ルールを使用します。
Adobe Experience Platform Mobile SDKの学習にご協力いただき、ありがとうございます。ご不明な点がある場合や、一般的なフィードバックをお寄せになる場合、または今後のコンテンツに関するご提案がある場合は、この Experience League Community Discussion の投稿でお知らせください。

次のトピック：Experience Platformへのデータの送信

recommendation-more-help

9fed61f5-c338-47ad-8005-0b89a5f4af8b