收集和映射Analytics数据

Last update: Thu Nov 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

初学者
中级
开发人员

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

您在前面的课程中收集并发送到PlatformEdge Network的event数据将转发到您在数据流中配置的服务，包括Adobe Analytics。您可以将数据映射到报表包中的正确变量。

先决条件

了解ExperienceEvent跟踪。
在示例应用程序中成功发送XDM数据。
可用于本课程的Adobe Analytics报表包。

学习目标

在本课程中，您将执行以下操作：

使用Adobe Analytics服务配置数据流。
了解Analytics变量的自动映射。
设置处理规则以将XDM数据映射到Analytics变量。

添加Adobe Analytics数据流服务

要将XDM数据从Edge Network发送到Adobe Analytics，请将Adobe Analytics服务配置为您在创建数据流过程中设置的数据流。

在数据收集UI中，选择 数据流 和您的数据流。
然后选择 添加服务。
从服务列表中添加 Adobe Analytics，
在Adobe Analytics中输入要在 报表包ID 中使用的报表包名称。
通过将 已启用 切换为开启来启用服务。
选择保存。

自动映射

许多标准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中的值。有关详细信息，请参阅AdobeExperience 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，您可以确认正在发送体验事件，XDM数据正确，并且Analytics映射按预期进行。

查看设置说明部分以将模拟器或设备连接到Assurance。
发送 productListAdds 事件（向购物篮中添加产品）。
查看ExperienceEvent点击。

查看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 事件。

在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组织标识符下。

_techmarketingdemos被替换为您的组织的唯一值。

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

使用字段组

将 Adobe Analytics ExperienceEvent完整扩展 字段组添加到您的架构中。
在应用程序中构建XDM负载，与Adobe Analytics ExperienceEvent Full Extension字段组一致，类似于您在跟踪事件数据课程中所执行的操作，或者
在Tags属性中生成规则，这些规则使用规则操作将数据附加或修改到Adobe Analytics ExperienceEvent Full Extension字段组。查看更多详细信息将数据附加到SDK事件或修改SDK事件中的数据。

促销eVar

如果您在Analytics设置中使用促销eVar，例如为了捕获产品（如&&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60）的颜色，您必须扩展您在跟踪事件数据中定义的XDM有效负载以捕获该促销信息。

在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.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)。

分析处理规则

IMPORTANT

某些自动映射的变量在处理规则中可能不可用。

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

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

TIP

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

从Analytics移动扩展迁移

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

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

实施Edge Network扩展并使用Edge.sendEvent API，如如何跟踪事件数据课程中所述。本教程重点介绍此实施。
实施Edge Bridge扩展，并继续使用您的MobileCore.trackAction和MobileCore.trackState API调用。有关更多详细信息和单独的教程，请参阅实施Edge Bridge扩展。

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