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

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

Last update: Tue Oct 14 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 サービスを設定します。

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

  2. 次に、「 追加 サービスを追加」を選択します。

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

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

  5. 有効 をオンにしてサービスを有効にします。

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

    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 マッピングが期待どおりに行われていることを確認できます。

  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 マッピングには、以下のことに注意してください。

  • イベント には、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 フィールドグループをスキーマに追加します。

    Analytics ExperienceEvent FullExtension フィールドグループ ​ {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 
    {
  "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 （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を使用して移行する場合は、次の選択肢があります。

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