收集和映射Analytics数据

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

事件 您在之前的课程中收集并发送到Platform Edge Network的数据将转发到您在数据流中配置的服务,包括Adobe Analytics。 您可以将数据映射到报表包中的正确变量。

架构

先决条件

  • 了解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添加为数据流服务

自动映射

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

示例#1 - s.products

一个很好的示例是 products变量 无法使用处理规则填充的部分。 对于XDM实施,您会将所有必需的数据传入 productListItemss.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[].SKUproductListItems[].name 两者都包含数据,值位于 productListItems[].SKU 已使用。 请参阅 Analytics Experience Edge中的Adobe变量映射 以了解更多信息。

示例#2 - scAdd

仔细查看,所有事件都有两个字段 value (必需)和 id (可选)。 此 value 字段用于递增事件计数。 此 id 字段用于序列化。

此对象:

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

结果位于:

s.events = "scAdd"

此对象:

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

结果位于:

s.events = "scAdd:321435"

使用保障进行验证

使用 Assurance 您可以确认正在发送体验事件,XDM数据正确,并且Analytics映射按预期进行。

  1. 查看 设置说明 部分以将模拟器或设备连接到Assurance。

  2. 发送 productListAdd 活动(向购物篮中添加产品)。

  3. 查看ExperienceEvent点击。

    analytics xdm点击

  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点击

在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字段组

  • 在应用程序中构建XDM负载,与Adobe Analytics ExperienceEvent Full Extension字段组保持一致,类似于在中完成的工作 跟踪事件数据 课程,或

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

促销 eVar

如果您使用 促销eVar 例如,用于捕获产品的颜色,如 &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60,您必须扩展在中定义的XDM有效负载 跟踪事件数据 来获取销售信息。

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

使用处理规则

以下是使用此数据的处理规则的外观:

  • 覆盖值 (1) 应用程序屏幕名称(eVar2) (2)具有下列值: a.x._techmarketingdemo.appinformation.appstatedetails.screenname (3)如果 a.x._techmarketingdemo.appinformation.appstatedetails.screenname (4) 已设置 (五)。

  • 设置事件 (6) 添加到愿望清单(事件3) (7)至 a.x.commerce.saveForLaters.value(Context) (8)如果 a.x.commerce.saveForLaters.value(Context) (9) 已设置 (10)。

analytics处理规则

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

可找到有关处理规则和上下文数据的其他信息 此处.

TIP
与以前的移动应用程序实施不同,页面/屏幕查看次数与其他事件之间没有区别。 相反,您可以递增 页面查看 量度,方法是设置 页面名称 处理规则中的维度。 由于您正在收集自定义 screenName 字段,强烈建议将屏幕名称映射到 页面名称 在处理规则中。
SUCCESS
您已设置应用程序,将Experience Edge XDM对象映射到Adobe Analytics变量,以在您的数据流中启用Adobe Analytics服务并在适用的情况下使用处理规则。
感谢您投入时间学习Adobe Experience Platform Mobile SDK。 如果您有疑问、希望分享一般反馈或有关于未来内容的建议,请在此共享它们 Experience League社区讨论帖子.

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

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