收集和映射Analytics数据

了解如何将移动数据映射到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服务配置为您在创建数据流过程中设置的数据流。

  1. 在数据收集UI中,选择​ 数据流 ​和您的数据流。

  2. 然后选择 添加 添加服务

  3. 从服务列表中添加​ Adobe Analytics

  4. 在Adobe Analytics中输入要在​ 报表包ID ​中使用的报表包名称。

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

  6. 选择​ 保存

    将Adobe Analytics添加为数据流服务

自动映射

许多标准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[].SKUproductListItems[].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"

使用保证功能进行验证

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

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

  2. 发送​ productListAdds ​事件(向购物篮中添加产品)。

  3. 查看ExperienceEvent点击。

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

    分析xdm点击

在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完整扩展 ​字段组添加到您的架构中。

    Analytics ExperienceEvent FullExtension字段组

  • 在应用程序中构建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
    {
      "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)。

分析处理规则

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