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

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

最終更新日： 2026年10月21日

作成対象：

  • Beginner
  • Intermediate
  • Developer

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

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

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

前提条件

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

学習目標

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

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

Add Adobe Analytics datastream service

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

  1. データ収集UIで、データストリーム​とデータストリームを選択します。

  2. 次に、 Add Add Service​を選択します。

  3. ​ サービス ​のリストから​ Adobe Analytics ​を追加します。

  4. レポートスイート ID​で使用するAdobe Analyticsのレポートスイートの名前を入力します。

  5. 有効​を切り替えて、サービスを有効にします。

  6. 「保存」を選択します。

    Adobe Analyticsをデータストリームサービスとして追加 {modal="regular"}

自動マッピング

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

例#1 - s.products

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

このオブジェクト：

"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

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

このオブジェクト：

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

結果：

s.events = "scAdd"

このオブジェクト：

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

結果：

s.events = "scAdd:321435"

Assurance での検証

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

  1. シミュレーターまたはデバイスをAssuranceに接続するには、設定の手順 セクションを確認してください。

  2. productListAdds イベントを送信します（商品を買い物かごに追加します）。

  3. ExperienceEvent ヒットを表示します。

    analytics xdm ヒット ​ {modal="regular"}

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

    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
  }
}
// ...

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

    analytics xdm ヒット ​ {modal="regular"}

Analytics マッピングでは、次の点に注意してください。

  • イベント​には、commerce.productListAddsに基づいてscAddが入力されます。
  • pl （製品変数）には、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組織IDの下に配置されます。
テナント名_techmarketingdemosは、組織の一意の値に置き換えられます。

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

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

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

    Analytics ExperienceEvent FullExtension フィールドグループ ​ {modal="regular"}

  • ​ トラックイベントデータ ​ レッスンで行った作業と同様に、Adobe Analytics ExperienceEvent Full Extension フィールドグループに準拠して、アプリでXDM ペイロードを作成します。

  • ルールアクションを使用してAdobe Analytics ExperienceEvent Full Extension フィールドグループにデータを添付または変更するルールをTags プロパティで作成します。 詳しくは、​ データをSDK イベントに添付またはSDK イベントのデータを変更を参照してください。

マーチャンダイジング eVars

Analytics設定で​ マーチャンダイジング eVarsを使用している場合は、​ トラックイベントデータ ​で定義したXDM ペイロードを拡張して、マーチャンダイジング情報を取得する必要があります。 マーチャンダイジング変数の例はevar1です。&&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60のように、商品の色をキャプチャする場合は、

  • 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
      }
  }
}

  • コード内：

    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
    ]
  ]
]

処理ルールの使用

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

  • a.x._techmarketingdemo.appinformation.appstatedetails.screenname （3）の値で​ （1） ​​ アプリ画面名（eVar2） ​​ （2）の値を ​​ a.x._techmarketingdemo.appinformation.appstatedetails.screenname ​​ （4） ​​が​​（5）に設定されている場合に上書きします。

  • a.x.commerce.saveForLaters.value （Context） （9） が設定されている場合、イベント​​ イベント ​​ （6） ​​ ウィッシュリストに追加（イベント 3） ​​ （7）から ​​ a.x.commerce.saveForLaters.value （Context） ​​（8）に追加します（10）。

分析処理ルール ​ {modal="regular"}

IMPORTANT
自動マッピングされた変数の一部は、処理ルールで使用できない場合があります。
処理ルールに初めてマッピングする場合、インターフェイスにXDM オブジェクトのコンテキストデータ変数が表示されません。 これを修正するには、任意の値を選択して保存し、編集に戻ります。 これで、すべてのXDM変数が表示されます。

処理ルールを使用してcontextData変数をpropとeVarにマッピングするを参照してください。

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

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

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

お勧めのEdge Networkを使用するために移行する場合は、次のオプションがあります。

SUCCESS
データストリームでAdobe Analytics サービスを有効にすることで、Experience Edge XDM オブジェクトをAdobe Analytics変数にマッピングするようにアプリを設定しました。 該当する場合は、処理ルールを使用します。
Adobe Experience Platform Mobile SDKについて学ぶために時間を割いていただきありがとうございます。 ご質問がある場合、一般的なフィードバックを共有したい場合、または今後のコンテンツに関する提案がある場合は、このExperience League コミュニティのディスカッション投稿で共有してください。

次：Experience Platformにデータを送信

recommendation-more-help
platform-learn-help-tutorial-mobile-sdk