跟踪事件数据

了解如何跟踪移动应用程序中的事件。

Edge Network扩展提供了一个将Experience事件发送到PlatformEdge Network的API。 体验事件是一个对象,其中包含符合XDM ExperienceEvent架构定义的数据。 更简单地说,它们捕获用户在您的移动应用程序中的操作。 平台Edge Network收到数据后,可以将其转发到数据流中配置的应用程序和服务,如Adobe Analytics和Experience Platform。 在产品文档中了解有关体验事件的更多信息。

先决条件

  • 所有包依赖项都已存在于您的Xcode项目中。
  • 已在​ AppDelegate ​中注册扩展。
  • 已将MobileCore扩展配置为使用开发appId
  • 导入的SDK。
  • 通过上述更改成功构建并运行应用程序。

学习目标

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

  • 了解如何基于架构构建XDM数据。
  • 基于标准字段组发送XDM事件。
  • 基于自定义字段组发送XDM事件。
  • 发送XDM购买事件。
  • 使用保障进行验证。

构建体验事件

Adobe Experience Platform Edge扩展可以将遵循之前定义的XDM架构的事件发送到Adobe Experience PlatformEdge Network。

这个过程是这样的……

  1. 识别您尝试跟踪的移动应用程序交互。

  2. 检查您的架构并确定相应的事件。

  3. 查看您的架构并确定应用于描述事件的任何其他字段。

  4. 构造和填充数据对象。

  5. 创建并发送事件。

  6. 验证。

标准字段组

对于标准字段组,此过程如下所示:

  • 在您的架构中,识别您尝试收集的事件。 在此示例中,您正在跟踪商务体验事件,例如产品查看(productViews)事件。

    产品视图架构

  • 要在应用程序中构建包含体验事件数据的对象,您可以使用以下代码:

    code language-swift
    var xdmData: [String: Any] = [
        "eventType": "commerce.productViews",
        "commerce": [
            "productViews": [
              "value": 1
            ]
        ]
    ]
    
    • eventType:描述发生的事件,尽可能使用已知值
    • commerce.productViews.value:事件的数值或布尔值。 如果它是一个布尔值(在Adobe Analytics中为“计数器”),则该值始终设置为1。 如果是数值或货币事件,该值可以大于1。
  • 在您的架构中,标识与商业产品查看事件关联的任何其他数据。 在此示例中,包括​ productListItems,它是用于任何商业相关事件的标准字段集:

    产品列表项架构

    • 请注意,productListItems ​是一个数组,因此可以提供多个产品。
  • 要添加此数据,请展开xdmData对象以包含补充数据:

    code language-swift
    var xdmData: [String: Any] = [
        "eventType": "commerce.productViews",
            "commerce": [
            "productViews": [
                "value": 1
            ]
        ],
        "productListItems": [
            [
                "name":  productName,
                "SKU": sku,
                "priceTotal": priceString,
                "quantity": 1
            ]
        ]
    ]
    
  • 您现在可以使用此数据结构创建ExperienceEvent

    code language-swift
    let productViewEvent = ExperienceEvent(xdm: xdmData)
    
  • 并使用sendEvent API将事件和数据发送到PlatformEdge Network:

    code language-swift
    Edge.sendEvent(experienceEvent: productViewEvent)
    

Edge.sendEvent API是AEP Mobile SDK等效于MobileCore.trackActionMobileCore.trackState API调用。 有关详细信息,请参阅从Analytics移动扩展迁移到Adobe Experience PlatformEdge Network

现在,您即将在您的Xcode项目中实际实施此代码。
您的应用程序中有不同的商业产品相关操作,并且您要根据用户执行的以下操作发送事件:

  • 视图:在用户查看特定产品时发生,
  • 添加到购物车:用户点击时 产品详细信息屏幕中的 {width="20"},
  • 暂存:用户点击时 产品详细信息屏幕中的 {width="15"},
  • 购买:用户点击时 产品详细信息屏幕中的 {width="20"}。

要以可重用方式实施与商业相关的体验事件的发送,请使用专用函数:

  1. 在Xcode项目导航器中导航到​ Luma > Luma > Utils > MobileSDK,并将以下内容添加到func sendCommerceExperienceEvent(commerceEventType: String, product: Product)函数。

    code language-swift
    // Set up a data dictionary, create an experience event and send the event.
    let xdmData: [String: Any] = [
        "eventType": "commerce." + commerceEventType,
        "commerce": [
            commerceEventType: [
                "value": 1
            ]
        ],
        "productListItems": [
            [
                "name": product.name,
                "priceTotal": product.price,
                "SKU": product.sku
            ]
        ]
    ]
    
    let commerceExperienceEvent = ExperienceEvent(xdm: xdmData)
    Edge.sendEvent(experienceEvent: commerceExperienceEvent)
    

    此函数将商务体验事件类型和产品作为参数和

    • 将XDM有效负载设置为词典,使用函数中的参数,
    • 使用词典设置体验事件,
    • 使用Edge.sendEvent API发送体验事件。
  2. 在Xcode项目导航器中导航到​ Luma > Luma > Views > Products > ProductView,并将各种调用添加到sendCommerceExperienceEvent函数:

    1. .task修饰符处,在ATTrackingManager.trackingAuthorizationStatus结束处。 在初始化并显示产品视图时调用此.task修饰符,以便您想要在该特定时刻发送产品视图事件。

      code language-swift
      // Send productViews commerce experience event
      MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "productViews", product: product)
      
    2. 对于每个按钮( {width="15"}, {width="20"}和 {width="20"}),在ATTrackingManager.trackingAuthorizationStatus == .authorized结束位置内添加相关调用:

      1. 对象 {width="15"}:

        code language-swift
        // Send saveForLater commerce experience event
        MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "saveForLaters", product: product)
        
      2. 对象 {width="20"}:

        code language-swift
        // Send productListAdds commerce experience event
        MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "productListAdds", product: product)
        
      3. 对象 {width="20"}:

        code language-swift
        // Send purchase commerce experience event
        MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "purchases", product: product)
        
TIP
如果您正在针对Android™进行开发,请使用映射(java.util.Map)作为构建XDM有效负载的基础接口。

自定义字段组

假设您想跟踪应用程序本身中的屏幕查看次数和交互次数。 请记住,您已为此类型事件定义了自定义字段组。

  • 在您的架构中,识别您尝试收集的事件。
    应用交互架构

  • 开始构建对象。

    note note
    NOTE
    • 标准字段组始终以对象根开头。

    • 自定义字段组始终以Experience Cloud组织_techmarketingdemos所独有的对象开头。

    对于应用程序交互事件,您可以构建如下对象:

    code language-swift
    let xdmData: [String: Any] = [
      "eventType": "application.interaction",
      "_techmarketingdemos": [
        "appInformation": [
            "appInteraction": [
                "name": "login",
                "appAction": [
                    "value": 1
                    ]
                ]
            ]
        ]
    ]
    

    对于屏幕跟踪事件,您可以构建如下对象:

    code language-swift
    var xdmData: [String: Any] = [
      "eventType": "application.scene",
      "_techmarketingdemos": [
          "appInformation": [
              "appStateDetails": [
                  "screenType": "App",
                      "screenName": "luma: content: ios: us: en: login",
                      "screenView": [
                          "value": 1
                      ]
                  ]
              ]
          ]
    ]
    
  • 您现在可以使用此数据结构创建ExperienceEvent

    code language-swift
    let event = ExperienceEvent(xdm: xdmData)
    
  • 将事件和数据发送到PlatformEdge Network。

    code language-swift
    Edge.sendEvent(experienceEvent: event)
    

再次重申,让我们在您的Xcode项目中实际实施此代码。

  1. 为方便起见,您在​ MobileSDK ​中定义了两个函数。 在Xcode项目导航器中导航到​ Luma > Luma > Utils > MobileSDK

    1. 一个用于应用程序交互。 将此代码添加到func sendAppInteractionEvent(actionName: String)函数:

      code language-swift
      // Set up a data dictionary, create an experience event and send the event.
      let xdmData: [String: Any] = [
          "eventType": "application.interaction",
          tenant : [
              "appInformation": [
                  "appInteraction": [
                      "name": actionName,
                      "appAction": [
                          "value": 1
                      ]
                  ]
              ]
          ]
      ]
      let appInteractionEvent = ExperienceEvent(xdm: xdmData)
      Edge.sendEvent(experienceEvent: appInteractionEvent)
      

      此函数使用操作名称作为参数,并且

      • 将XDM有效负载设置为词典,使用函数中的参数,
      • 使用词典设置体验事件,
      • 使用Edge.sendEvent API发送体验事件。
    2. 还有一个用于屏幕跟踪。 将此代码添加到func sendTrackScreenEvent(stateName: String) 函数:

      code language-swift
      // Set up a data dictionary, create an experience event and send the event.
      let xdmData: [String: Any] = [
          "eventType": "application.scene",
          tenant : [
              "appInformation": [
                  "appStateDetails": [
                      "screenType": "App",
                      "screenName": stateName,
                      "screenView": [
                          "value": 1
                      ]
                  ]
              ]
          ]
      ]
      let trackScreenEvent = ExperienceEvent(xdm: xdmData)
      Edge.sendEvent(experienceEvent: trackScreenEvent)
      

      此函数使用状态名称作为参数并

      • 将XDM有效负载设置为词典,使用函数中的参数,
      • 使用词典设置体验事件,
      • 使用Edge.sendEvent API发送体验事件。
  2. 导航到​ Luma > Luma > Views > General > 登录工作表

    1. 在“登录”按钮结尾处添加以下高亮显示的代码:

      code language-swift
      // Send app interaction event
      MobileSDK.shared.sendAppInteractionEvent(actionName: "login")
      
    2. 将以下高亮显示的代码添加到onAppear修饰符:

      code language-swift
      // Send track screen event
      MobileSDK.shared.sendTrackScreenEvent(stateName: "luma: content: ios: us: en: login")
      

验证

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

    1. 将“Assurance(保证)”图标向左移动。

    2. 在选项卡栏中选择​ Home,并验证您是否在Home屏幕中看到​ ECID电子邮件 ​和​ CRM ID

    3. 在选项卡栏中选择​ Products

    4. 选择产品。

    5. 选择 {width="15"}。

    6. 选择 {width="20"}。

    7. 选择 {width="15"}。

      {width="300"}

  2. 在Assurance UI中,查找来自​ com.adobe.edge.konductor ​供应商的​ hitReceived ​事件。

  3. 选择事件并查看​ 消息 ​对象中的XDM数据。 或者,您可以使用 复制 复制原始事件 ​并使用首选项的文本或代码编辑器粘贴和检查该事件。

    数据收集验证

后续步骤

您现在应该拥有所有工具,能够开始向应用程序添加数据收集。 您可以为用户在应用程序中与产品的交互方式添加更多智能,并为应用程序添加更多应用程序交互和屏幕跟踪调用:

  • 在应用程序中实施订单、结帐、空购物篮和其他功能,并将相关的商务体验事件添加到此功能。
  • 使用相应的参数重复对sendAppInteractionEvent的调用,以跟踪用户进行的其他应用程序交互。
  • 使用相应的参数重复对sendTrackScreenEvent的调用,以跟踪用户在应用程序中查看的屏幕。
TIP
有关更多示例,请查看完成的应用程序

将事件发送到Analytics和Platform

现在您已收集事件并将它们发送到PlatformEdge Network,将它们发送到数据流中配置的应用程序和服务。 在以后的课程中,您可以将此数据映射到Adobe AnalyticsAdobe Experience Platform以及其他Adobe Experience Cloud解决方案,如Adobe Target和Adobe Journey Optimizer。

SUCCESS
您现在已设置应用程序,以跟踪与Adobe Experience PlatformEdge Network以及您在数据流中定义的所有服务的商务、应用程序交互和屏幕跟踪事件。
感谢您投入时间学习Adobe Experience Platform Mobile SDK。 如果您有疑问、希望共享一般反馈或有关于未来内容的建议,请在此Experience League社区讨论帖子上共享它们。

下一步: 处理WebViews

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