活動

瞭解如何在移動應用中跟蹤事件。

邊緣網路擴展提供API，用於向平台邊緣網路發送體驗事件。 體驗事件是包含符合XDM體驗事件架構定義的資料的對象。 更簡單的是，它們捕捉了人們在移動應用中所做的事情。 一旦平台邊緣網路接收到資料，就可以將其轉發到在資料流中配置的應用程式和服務，如Adobe Analytics和Experience Platform。 瞭解有關 體驗事件 中。

先決條件

• 已使用所需SDK更新PodFile。
• 已在AppDelegate中註冊擴展。
• 已將MobileCore配置為使用您的開發AppId。
• 導入的SDK。
• 已成功構建並運行應用，但有上述更改。

學習目標

在本課中，您將：

• 瞭解如何基於架構構建XDM資料。
• 根據標準欄位組發送XDM事件。
• 基於自定義欄位組發送XDM事件。
• 發送XDM購買事件。
• 使用保證驗證。

構建體驗事件

Adobe Experience Platform邊緣擴展可以將遵循先前定義的XDM架構的事件發送到Adobe Experience Platform邊緣網路。

這個過程是這樣……

1. 標識您嘗試跟蹤的移動應用交互。

2. 查看您的架構並確定相應的事件。

3. 查看您的架構並標識應用於描述事件的任何其他欄位。

4. 構造並填充資料對象。

5. 建立和發送事件。

6. 驗證.

讓我們看幾個例子。

示例#1 — 標準欄位組

在不嘗試在示例應用程式中實施的情況下查看以下示例：

1. 在您的架構中，標識您嘗試收集的事件，在此示例中，我們將跟蹤產品視圖。
   

2. 開始構建對象：

   var xdmData: [String: Any] = [
       "eventType": "commerce.productViews",
       "commerce": [
           "productViews": [
           "value": 1
           ]
       ]
   ]
   

   • eventType:描述發生的事件，使用 已知值 可能的時候。
   • commerce.productViews.value:提供事件的數值。 如果是布爾值(或Adobe Analytics的「計數器」)，則值將始終為1。 如果是數字事件或貨幣事件，則值可以大於1。

3. 在架構中，標識與事件關聯的任何其他資料。 在此示例中，包括 productListItems 它是與商業相關事件一起使用的標準欄位集：
   

   • 注意 productListItems 是一個陣列，因此可以提供多個產品。

4. 展開xdmData對象以包括補充資料：

   var xdmData: [String: Any] = [
       "eventType": "commerce.productViews",
           "commerce": [
           "productViews": [
               "value": 1
           ]
       ],
       "productListItems": [
           [
               "name":  productName,
               "SKU": sku,
               "priceTotal": priceString,
               "quantity": 1
           ]
       ]
   ]
   

5. 使用資料結構建立 ExperienceEvent:

   let productViewEvent = ExperienceEvent(xdm: xdmData)
   

6. 將事件和資料發送到平台邊緣網路：

   Edge.sendEvent(experienceEvent: productViewEvent)
   

示例#2 — 自定義欄位組

在不嘗試在示例應用程式中實施的情況下查看以下示例：

1. 在架構中，標識您嘗試收集的事件。 在本示例中，跟蹤「應用程式交互」，該交互包含應用程式操作事件和名稱。
   

2. 開始構建對象。

   注意

   標準欄位組始終在對象根中開始。

   自定義欄位組始終在Experience Cloud組織「_techmarketingdemos」的唯一對象下開始。

   var xdmData: [String: Any] = [
   "_techmarketingdemos": [
       "appInformation": [
           "appInteraction": [
               "name": actionName,
               "appAction": [
                   "value": 1
                   ]
               ]
           ]
       ]
   ]
   

   或者……

   var xdmData: [String: Any] = [:]
   xdmData["_techmarketingdemos"] = [
       "appInformation": [
           "appInteraction": [
               "name": actionName,
               "appAction": [
                   "value": 1
               ]
           ]
       ]
   ]
   

3. 使用資料結構建立 ExperienceEvent。

   let appInteractionEvent = ExperienceEvent(xdm: xdmData)
   

4. 將事件和資料發送到平台邊緣網路。

   Edge.sendEvent(experienceEvent: appInteractionEvent)
   

正在向Luma應用添加螢幕視圖跟蹤

上述實例有望說明構建XDM資料對象時的思想過程。 接下來，我們將在Luma應用中添加螢幕視圖跟蹤。

1. 導航到 Home.swift。

2. 將下列程式碼新增至 viewDidAppear(...).

           let stateName = "luma: content: ios: us: en: home"
           var xdmData: [String: Any] = [:]
           //Page View
           xdmData["_techmarketingdemos"] = [
               "appInformation": [
                   "appStateDetails": [
                       "screenType": "App",
                       "screenName": stateName,
                       "screenView": [
                           "value": 1
                       ]
                   ]
               ]
           ]
           let experienceEvent = ExperienceEvent(xdm: xdmData)
           Edge.sendEvent(experienceEvent: experienceEvent)
   

3. 對應用中的每個螢幕重複，更新 stateName 隨你走。

驗證

1. 查看 設定說明 並將模擬器或設備連接到Assurance。
2. 執行操作並查找 hitReceived 事件 com.adobe.edge.konductor 供應商。
3. 選擇事件並查看中的XDM資料 messages 的雙曲餘切值。
   

示例#3 — 採購

在本示例中，假定用戶成功進行了以下採購：

• 產品#1 — 瑜伽墊。
  • 49.99美元x1
  • SKU:5829
• 產品#2 — 水瓶。
  • $10.00 x 3
  • SKU:9841
• 訂單合計：US$79.99
• 唯一訂單ID:298234720
• 付款類型：威士信用卡
• 唯一付款交易記錄ID:847361

方案

以下是要使用的相關架構欄位：

• eventType:"commerce.purches"
• commerce.purchases
• commerce.order
• productsListItems
• _techmarketingdemos.appStateDetails（自定義）

程式碼

下面是在應用中構建和發送XDM對象的方式。

let stateName = "luma: content: ios: us: en: orderconfirmation"
let currencyCode = "USD"
let orderTotal = "79.99"
let paymentType = "Visa Credit Card"
let orderId = "298234720"
let paymentTransactionId = "847361"
var xdmData: [String: Any] = [
  "eventType": "commerce.purchases",
  "commerce": [
    "purchases": [
      "value": 1
    ],
    "order": [
      "currencyCode": currencyCode,
      "priceTotal": orderTotal,
      "purchaseID": orderId,
      "purchaseOrderNumber": orderId,
      "payments": [ //Assuming only 1 payment type is used
        [
          "currencyCode": currencyCode,
          "paymentAmount": orderTotal,
          "paymentType": paymentType,
          "transactionID": paymentTransactionId
        ]
      ]
    ]
  ],
  "productListItems": [
      [
          "name":  "Yoga Mat",
          "SKU": "5829",
          "priceTotal": "49.99",
          "quantity": 1
      ],
      [
        "name":  "Water Bottle",
        "SKU": "9841",
        "priceTotal": "30.00",
        "quantity": 3
      ]
  ]
]

//Custom field group
xdmData["_techmarketingdemos"] = [
  "appInformation": [
    "appStateDetails": [
      "screenType": "App",
      "screenName": stateName,
      "screenView": [
        "value": 1
      ]
    ]
  ]
]
let experienceEvent = ExperienceEvent(xdm: xdmData)
Edge.sendEvent(experienceEvent: experienceEvent)

在Luma應用中實施

您應該擁有所有工具，以開始向Luma示例應用添加資料收集。 以下是您可以遵循的假設跟蹤要求清單。

• 跟蹤每個螢幕視圖。
  • 架構欄位：screenType、screenName、screenView
• 跟蹤非商業活動。
  • 架構欄位：appInteraction.name、appAction
• 商業操作：
  • 產品頁：產品視圖
  • 添加到購物車：productListAdds
  • 從購物車中刪除：productList刪除
  • 開始簽出：檢查
  • 查看購物車：productListViews
  • 添加到願望清單：為Laters保存
  • 購買：採購，訂單

驗證

1. 查看 設定說明 並將模擬器或設備連接到Assurance。

2. 執行操作並查找 hitReceived 事件 com.adobe.edge.konductor 供應商。

3. 選擇事件並查看中的XDM資料 messages 的雙曲餘切值。
   

將事件發送到分析和平台

現在您已收集事件並將其發送到平台邊緣網路，這些事件將發送到您在 資料流。 在以後的課程中，您將將此資料映射到 Adobe Analytics 和 Adobe Experience Platform。

下一個： Web視圖

Business.Adobe.com資源