文档Experience Platform移动设备应用程序教程

收集和映射Analytics数据

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

创建对象：

  • 初学者
  • 中级
  • 开发人员

了解如何将移动数据映射到Adobe Analytics。

您在前面的课程中收集并发送到Platform Edge Network的event数据将转发到您在数据流中配置的服务，包括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. 在Adobe Analytics中输入要在​ 报表包ID ​中使用的报表包名称。

  5. 通过将​ 已启用 ​切换为开启来启用服务。

  6. 选择​ 保存。

    将Adobe Analytics添加为数据流服务 {modal="regular"}

自动映射

许多标准XDM字段会自动映射到Analytics变量。 查看完整列表。

示例#1 - s.products

无法使用处理规则填充的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

如果仔细查看，所有事件都有两个字段：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点击。

    分析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 ​事件。

    分析xdm点击 {modal="regular"}

在Analytics映射中注意以下事项：

  • 已基于​ 使用 ​填充scAdd事件commerce.productListAdds。
  • 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组织标识符下。
已将租户名称_techmarketingdemos替换为您组织的唯一值。

要将此XDM上下文数据映射到报表包中的Analytics数据，您可以：

使用字段组

  • 将​ Adobe Analytics ExperienceEvent完整扩展 ​字段组添加到您的架构中。

    Analytics ExperienceEvent FullExtension字段组 {modal="regular"}

  • 在应用程序中构建XDM负载，与Adobe Analytics ExperienceEvent Full Extension字段组一致，类似于您在跟踪事件数据课程中所执行的操作，或者

  • 在Tags属性中生成规则，这些规则使用规则操作将数据附加或修改到Adobe Analytics ExperienceEvent Full Extension字段组。 查看更多详细信息将数据附加到SDK事件或修改SDK事件中的数据。

促销eVar

如果您在Analytics设置中使用促销eVar，则必须扩展您在跟踪事件数据中定义的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.appstatedetails.screenname (4) (5)，则您 ​用值​ a.x._techmarketingdemo.appstatedetails.appstatedetails.screenname (3)覆盖​ (1)的值 ​应用程序屏幕名称(eVar2)(2) (5)。

  • 如果设置了​ a.x.commerce.saveForLaters.value(Context) (9) ​ ​(10)，则您​ 将event (6) Add to Wishlist (Event 3) (7)设置为​ a.x.commerce.saveForLaters.value(Context) (8)。

分析处理规则 {modal="regular"}

IMPORTANT
某些自动映射的变量在处理规则中可能不可用。
首次映射到处理规则时，界面不会显示XDM对象中的上下文数据变量。 要修复该错误，请选择任意值，请保存并返回进行编辑。 此时应会显示所有XDM变量。

查看使用处理规则将contextData变量映射到prop和eVar。

TIP
与以前的移动应用程序实施不同，页面/屏幕查看次数与其他事件之间没有区别。 相反，可以通过在处理规则中设置​ 页面名称 ​维度来递增​ 页面查看 ​量度。 由于您正在教程中收集自定义screenName字段，因此强烈建议在处理规则中将屏幕名称映射到​ 页面名称。

从Analytics移动扩展迁移

如果您使用Adobe Analytics移动扩展开发移动应用程序，则很可能使用了MobileCore.trackAction和MobileCore.trackState API调用。

如果您决定迁移以使用推荐的Edge Network，则可以选择以下选项：

SUCCESS
您已设置应用程序，通过在数据流中启用Edge服务将Experience Adobe Analytics XDM对象映射到Adobe Analytics变量。 并在适用的情况下使用处理规则。
感谢您投入时间学习Adobe Experience Platform Mobile SDK。 如果您有任何疑问、希望分享一般反馈或有关于未来内容的建议，请在此Experience League社区讨论帖子上分享这些内容。

下一步：将数据发送到Experience Platform

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b