文件Experience Platform行動應用程式教學課程

追蹤事件資料

Last update: Fri Sep 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 初學者
  • 中繼
  • 開發人員

瞭解如何追蹤行動應用程式中的事件。

Edge Network擴充功能提供API，可將體驗事件傳送至Platform Edge Network。 體驗事件是包含符合XDM ExperienceEvent結構描述定義的資料的物件。 更簡單地說，這些事件會擷取使用者在您的行動應用程式中的動作。 Platform Edge Network收到資料後，即可將該資料轉送至資料流中設定的應用程式和服務，例如Adobe Analytics和Experience Platform。 在產品檔案中進一步瞭解體驗事件。

先決條件

  • 所有套件相依性都在您的Xcode專案中設定。
  • 已在​ AppDelegate ​中登入副檔名。
  • 已設定MobileCore擴充功能使用您的開發appId。
  • 匯入的SDK。
  • 已順利建置並執行應用程式，包含上述變更。

學習目標

在本課程中，您將學習

  • 瞭解如何根據結構描述來建構XDM資料。
  • 根據標準欄位群組傳送XDM事件。
  • 根據自訂欄位群組傳送XDM事件。
  • 傳送XDM購買事件。
  • 使用Assurance進行驗證。

建構體驗事件

Adobe Experience Platform Edge擴充功能可將遵循先前已定義XDM結構的事件傳送至Adobe Experience Platform Edge Network。

程式如下……

  1. 識別您嘗試追蹤的行動應用程式互動。

  2. 檢閱您的結構並識別適當的事件。

  3. 檢閱您的結構描述，並識別應用於描述事件的任何其他欄位。

  4. 建構並填入資料物件。

  5. 建立並傳送事件。

  6. 驗證。

標準欄位群組

對於標準欄位群組，程式看起來像這樣：

  • 在您的結構描述中，識別您嘗試收集的事件。 在此範例中，您正在追蹤商務體驗事件，例如產品檢視(productViews)事件。

    產品檢視結構描述 {modal="regular"}

  • 若要在您的應用程式中建構包含體驗事件資料的物件，請使用如下的程式碼：

iOS
code language-swift 
var xdmData: [String: Any] = [
    "eventType": "commerce.productViews",
    "commerce": [
        "productViews": [
        "value": 1
        ]
    ]
]

在此程式碼中：

  • eventType：說明已發生的事件，儘可能使用已知值。

  • commerce.productViews.value：事件的數值或布林值。 如果是布林值(或Adobe Analytics中的「計數器」)，此值一律設為1。 如果是數值或貨幣事件，值可以是> 1。

Android
code language-kotlin 
val xdmData = mapOf(
    "eventType" to "commerce.productViews",
    "commerce" to mapOf(
        "productViews" to mapOf(
        "value": 1
        )
    )
)

在此程式碼中：

  • eventType：說明已發生的事件，儘可能使用已知值。

  • commerce.productViews.value：事件的數值或布林值。 如果是布林值(或Adobe Analytics中的「計數器」)，此值一律設為1。 如果是數值或貨幣事件，值可以是> 1。

  • 在您的結構描述中，識別與商務產品檢視事件相關聯的任何其他資料。 在此範例中，包含​ productListItems，這是用於任何商務相關事件的標準欄位集：

    產品清單專案結構描述 {modal="regular"}

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

  • 若要新增此資料，請展開您的xdmData物件以包含補充資料：

iOS
code language-swift 
var xdmData: [String: Any] = [
    "eventType": "commerce.productViews",
    "commerce": [
        "productViews": [
            "value": 1
        ]
    ],
    "productListItems": [
        [
            "name":  productName,
            "SKU": sku,
            "priceTotal": priceString,
            "quantity": 1
        ]
    ]
]
Android
code language-kotlin 
val xdmData = mapOf(
    "eventType" to "commerce.productViews",
    "commerce" to mapOf(
        "productViews" to mapOf(
        "value": 1
        )
    ),
    "productListItems" to mapOf(
        "name": productName,
        "SKU": sku,
        "priceTotal", priceString,
        "quantity", 1
    )
)
  • 您現在可以使用此資料結構來建立ExperienceEvent：
iOS
code language-swift 
let productViewEvent = ExperienceEvent(xdm: xdmData)
Android
code language-kotlin 
val productViewEvent = ExperienceEvent.Builder().setXdmSchema(xdmData).build()
  • 並使用sendEvent API將事件和資料傳送至Platform Edge Network：
iOS
code language-swift 
Edge.sendEvent(experienceEvent: productViewEvent)
Android
code language-kotlin 
Edge.sendEvent(productViewEvent, null)

Edge.sendEvent API是AEP Mobile SDK，相當於MobileCore.trackAction和MobileCore.trackState API呼叫。 如需詳細資訊，請參閱從Analytics行動擴充功能移轉至Adobe Experience Platform Edge Network。

您現在即將在專案中實作此程式碼。
您的應用程式中有不同的商務產品相關動作，而您想要根據使用者執行的這些動作，傳送事件：

  • 檢視：當使用者檢視特定產品時發生，
  • 加入購物車：當使用者在產品詳細資料畫面中點選 ShoppingCart 時，
  • 儲存以供稍後使用：當使用者在產品詳細資料畫面中點選 心 / ThumbUp 時，
  • 購買：使用者在產品詳細資料畫面中點選 信用卡 時。

若要以可重複使用的方式實作與商業相關的體驗事件的傳送，請使用專用函式：

iOS

  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. 針對工具列中的每個按鈕（ 心 、 購物車 和 信用卡 ），在ATTrackingManager.trackingAuthorizationStatus == .authorized關閉中新增相關呼叫：

      1. 針對 心 ：

        code language-swift 
        // Send saveForLater commerce experience event
MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "saveForLaters", product: product)

      2. 針對 ShoppingCart ：

        code language-swift 
        // Send productListAdds commerce experience event
MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "productListAdds", product: product)

      3. 針對 信用卡 ：

        code language-swift 
        // Send purchase commerce experience event
MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "purchases", product: product)
Android

  1. 在Android Studio導覽器中導覽至​ Android ChevronDown > 應用程式 > kotlin+java > com.adobe.luma.tutorial.android > 模型 > MobileSDK，並將下列專案新增至func sendCommerceExperienceEvent(commerceEventType: String, product: Product)函式。

    code language-kotlin 
    // Set up a data map, create an experience event and send the event.
val xdmData = mapOf(
    "eventType" to "commerce.$commerceEventType",
    "commerce" to mapOf(commerceEventType to mapOf("value" to 1)),
    "productListItems" to listOf(
        mapOf(
            "name" to product.name,
            "priceTotal" to product.price,
            "SKU" to product.sku
        )
    )
)
val commerceExperienceEvent = ExperienceEvent.Builder().setXdmSchema(xdmData).build()
Edge.sendEvent(commerceExperienceEvent, null)

    此函式將商務體驗事件型別和產品視為引數和

    • 使用函式中的引數將XDM裝載設定為對應，
    • 使用地圖設定體驗事件，
    • 使用Edge.sendEvent API傳送體驗事件。

  2. 導覽至Android Studio導覽器中的​ 應用程式 > kotlin+java > com.adobe.luma.tutorial.android > 檢視 > ProductView.kt，並將各種呼叫新增至sendCommerceExperienceEvent函式：

    1. 在LaunchedEffect(Unit)可撰寫函式中，您要在檢視產品的特定時間傳送產品檢視事件。

      code language-kotlin 
      // Send productViews commerce experience event
MobileSDK.shared.sendCommerceExperienceEvent("productViews", product)

    2. 針對工具列中的每個按鈕（ ThumbUp 、 ShoppingCart 及 CreditCard ），在scope.launch的if (MobileSDK.shared.trackingEnabled == TrackingStatus.AUTHORIZED) statement內新增相關呼叫：

      1. 針對 ThumbUp ：

        code language-kotlin 
        // Send saveForLater commerce experience event
MobileSDK.shared.sendCommerceExperienceEvent("saveForLaters", product)

      2. 針對 ShoppingCart ：

        code language-kotlin 
        // Send productListAdds commerce experience event
MobileSDK.shared.sendCommerceExperienceEvent("productListAdds", product)

      3. 針對 信用卡 ：

        code language-kotlin 
        // Send purchase commerce experience event
MobileSDK.shared.sendCommerceExperienceEvent("purchases", product)
TIP
如果您正在針對Android™開發，請使用Map (java.util.Map)作為建構XDM承載的基礎介面。

自訂欄位分組

想像您想要追蹤應用程式本身的熒幕檢視和互動情形。 請記住，您已為此型別事件定義自訂欄位群組。

  • 在您的結構描述中，識別您嘗試收集的事件。
    應用程式互動結構描述 {modal="regular"}

  • 開始建構物件。

    note note
    NOTE

    • 標準欄位群組一律以物件根目錄開始。

    • 自訂欄位群組一律以您的Experience Cloud組織_techmarketingdemos所獨有的物件開頭（在此範例中）。

  • 針對應用程式互動事件，您可以建構如下的物件：

iOS
code language-swift 
let xdmData: [String: Any] = [
    "eventType": "application.interaction",
    "_techmarketingdemos": [
    "appInformation": [
        "appInteraction": [
            "name": "login",
            "appAction": [
                "value": 1
                ]
            ]
        ]
    ]
]
Android
code language-kotlin 
val xdmData = mapOf(
    "eventType" to "application.interaction",
    "_techmarketingdemos" to mapOf(
        "appInformation" to mapOf(
            "appInteraction" to mapOf(
                "name" to "login",
                "appAction" to mapOf("value" to 1)
            )
        )
    )
)
  • 對於熒幕追蹤事件，您可以建構如下的物件：
iOS
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
                ]
            ]
        ]
    ]
]
Android
code language-kotlin 
val xdmData = mapOf(
    "eventType" to "application.scene",
    tenant.value to mapOf(
        "appInformation" to mapOf(
            "appStateDetails" to mapOf(
                "screenType" to "App",
                "screenName" to stateName,
                "screenView" to mapOf("value" to 1)
            )
        )
    )
)
  • 您現在可以使用此資料結構來建立ExperienceEvent。
iOS
code language-swift 
let event = ExperienceEvent(xdm: xdmData)
Android
code language-kotlin 
val event = ExperienceEvent(xdmData)
  • 將事件和資料傳送至Platform Edge Network。
iOS
code language-swift 
Edge.sendEvent(experienceEvent: event)
Android
code language-kotlin 
Edge.sendEvent(event, null)

再次強調，請在專案中實作此程式碼。

iOS

  1. 為方便起見，您在​ MobileSDK ​中定義了兩個函式。 導覽至Xcode專案導覽器中的​ Luma > Luma > Utils > MobileSDK。

    • 一個用於應用程式互動。 將此程式碼新增至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傳送體驗事件。

    • 另一個用於熒幕追蹤。 將此程式碼新增至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")
Android

  1. 為方便起見，您在​ MobileSDK ​中定義了兩個函式。 導覽至Android Studio導覽器中的​ Android ChevronDown app > kotlin+java > com.adobe.luma.tutorial.android > 模型 > MobileSDK。

    • 一個用於應用程式互動。 將此程式碼新增至fun sendAppInteractionEvent(actionName: String)函式：

      code language-kotlin 
      // Set up a data map, create an experience event and send the event.
val xdmData = mapOf(
    "eventType" to "application.interaction",
    tenant.value to mapOf(
        "appInformation" to mapOf(
            "appInteraction" to mapOf(
                "name" to actionName,
                "appAction" to mapOf("value" to 1)
            )
        )
    )
)
val appInteractionEvent = ExperienceEvent.Builder().setXdmSchema(xdmData).build()
Edge.sendEvent(appInteractionEvent, null)

      此函式使用動作名稱作為引數，且

      • 使用函式的引數，將XDM裝載設定為對應。
      • 使用地圖設定體驗事件，
      • 使用Edge.sendEvent API傳送體驗事件。

    • 另一個用於熒幕追蹤。 將此程式碼新增至fun sendTrackScreenEvent(stateName: String)函式：

      code language-kotlin 
      // Set up a data map, create an experience event and send the event.
val xdmData = mapOf(
    "eventType" to "application.scene",
    tenant.value to mapOf(
        "appInformation" to mapOf(
            "appStateDetails" to mapOf(
                "screenType" to "App",
                "screenName" to stateName,
                "screenView" to mapOf("value" to 1)
            )
        )
    )
)
val trackScreenEvent = ExperienceEvent.Builder().setXdmSchema(xdmData).build()
Edge.sendEvent(trackScreenEvent, null)

      此函式使用狀態名稱作為引數，而

      • 使用函式的引數，將XDM裝載設定為對應。
      • 使用地圖設定體驗事件，
      • 使用Edge.sendEvent API傳送體驗事件。

  2. 導覽至​ Android ChevronDown app>kotlin+java>com.adobe.luma.tutorial.android>​檢視​>​ LoginSheet.kt ​

    1. 將下列醒目提示的程式碼新增至​ 按鈕 onClick ​事件：

      code language-kotlin 
      // Send app interaction event
MobileSDK.shared.sendAppInteractionEvent("login")

    2. 將下列醒目提示的程式碼新增至LaunchedEffect(Unit)可撰寫函式：

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

驗證

  1. 檢閱設定指示區段，將您的模擬器或裝置與Assurance連線。

    1. 將Assurance圖示向左移動。
    2. 在索引標籤列中選取「首頁」，並確認您在「首頁」畫面中看到​ ECID、電子郵件 ​和​ CRM ID。
    3. 在索引標籤列中選取​ Products。
    4. 選取產品。
    5. 選取 心臟 (iOS)或 ThumbUp (Android)。
    6. 選取「 購物車新增 」。
    7. 選取 信用卡 。
iOS
{width="300"}
Android
{width="278"}

  1. 在Assurance UI中，尋找來自​ com.adobe.edge.konductor ​廠商的​ hitReceived ​事件。

  2. 選取事件並檢閱​ 訊息 ​物件中的XDM資料。 或者，您可以使用 複製 複製原始事件，並使用您喜好的文字或程式碼編輯器貼上並檢查該事件。

    資料彙集驗證 {modal="regular"}

後續步驟

您現在應該擁有所有工具，可開始將資料收集新增至應用程式。 您可以新增更多智慧來瞭解使用者如何與應用程式中的產品互動，也可以新增更多應用程式互動和熒幕追蹤呼叫至應用程式：

  • 實施訂單、結帳、清空購物籃和其他功能至應用程式，並新增相關商務體驗事件至此功能。
  • 使用適當的引數重複呼叫sendAppInteractionEvent，以追蹤使用者的其他應用程式互動。
  • 使用適當的引數重複呼叫sendTrackScreenEvent，以追蹤使用者在應用程式中檢視的熒幕。
TIP
如需更多範例，請檢閱完成的應用程式。

將事件傳送至Analytics和Platform

現在您已收集事件並傳送至Platform Edge Network，它們會傳送至資料流中設定的應用程式和服務。 在稍後的課程中，您會將此資料對應至Adobe Analytics、Adobe Experience Platform和其他Adobe Experience Cloud解決方案(如Adobe Target和Adobe Journey Optimizer)。

SUCCESS
您現在已設定應用程式，以追蹤商務、應用程式互動和畫面追蹤事件至Adobe Experience Platform Edge Network。 以及您在資料流中定義的所有服務。
感謝您花時間學習Adobe Experience Platform Mobile SDK。 如果您有任何疑問、想分享一般意見或有關於未來內容的建議，請在這篇Experience League社群討論貼文上分享。

下一個： 處理WebViews

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