活動

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

邊緣網路擴展提供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. 在架構中,標識您嘗試收集的事件。 在本示例中,跟蹤「應用程式交互」,該交互包含應用程式操作事件和名稱。
    app交互架構

  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(自定義)
秘訣

自定義欄位組始終放在Experience Cloud組織標識符下。

「_techmarketingdemos」將替換為您組織的唯一值。

採購模式

程式碼

下面是在應用中構建和發送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 AnalyticsAdobe Experience Platform

下一個: Web視圖

注意

感謝您花時間學習Adobe Experience Platform移動軟體開發工具包。 如果您有問題、想要共用一般反饋或對未來內容有建議,請就此共用 Experience League社區討論帖子

本頁內容