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

收集與對應Analytics資料

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

建立對象：

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

瞭解如何將行動資料對應至Adobe Analytics。

您在先前課程中收集並傳送至Platform Edge Network的事件資料會轉送至您在資料流中設定的服務，包括Adobe Analytics。 將資料對應至報表套裝中的正確變數。

架構 {modal="regular"}

先決條件

  • 瞭解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. 輸入您要在​ 報表套裝ID ​中使用的來自Adobe Analytics的報表套裝名稱。

  5. 透過將​ 已啟用 ​切換為開啟來啟用服務。

  6. 選取「儲存」。

    將Adobe Analytics新增為資料流服務 {modal="regular"}

自動對應

許多標準XDM欄位會自動對應至Analytics變數。 檢視完整清單。

範例#1 - s.products

無法使用處理規則填入的產品變數就是很好的範例。 透過XDM實作，您傳遞了productListItems中的所有必要資料，系統透過Analytics對應自動填入s.products。

此物件：

"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[].SKU和productListItems[].name都包含資料，則使用productListItems[].SKU中的值。 如需詳細資訊，請參閱Adobe Experience 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"

使用保證進行驗證

使用Assurance，您可以確認您傳送的是體驗事件、XDM資料正確，且Analytics對應如預期發生。

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

  2. 傳送​ productListAdds ​活動（新增產品至購物籃）。

  3. 檢視ExperienceEvent點選。

    分析xdm點選 {modal="regular"}

  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點選 {modal="regular"}

在Analytics對應中注意下列事項：

  • 個事件 ​已根據scAdd填入commerce.productListAdds。
  • 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 Full Extension ​欄位群組新增至您的結構描述。

    Analytics ExperienceEvent FullExtension欄位群組 {modal="regular"}

  • 在您的應用程式中建置XDM裝載，符合Adobe Analytics ExperienceEvent Full Extension欄位群組，類似於您在追蹤事件資料課程中完成的工作，或者

  • 在Tags屬性中建置規則，這些規則使用規則動作來附加或修改資料至Adobe Analytics ExperienceEvent Full Extension欄位群組。 檢視更多詳細資料將資料附加至SDK事件或修改SDK事件中的資料。

銷售eVar

如果您在Analytics設定中使用銷售eVar，您必須擴充您在追蹤事件資料中定義的XDM裝載，以擷取該銷售資訊。 銷售var的範例為evar1，其中您想要擷取產品的顏色，例如&&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60

  • 在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.appstatedetails.screenname (4) (5)，您 ​以​ a.x._techmarketingdemo.appstatedetails.appstatedetails.screenname ​的值覆寫​ (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)。

分析處理規則 {modal="regular"}

IMPORTANT
有些自動對應的變數可能無法用於處理規則。
第一次對應到處理規則時，介面不會顯示XDM物件的內容資料變數。 若要修正選取的任何值，請儲存並返回編輯。 所有XDM變數現在都會顯示。

檢視使用處理規則將contextData變數對應至prop和eVar。

TIP
和先前的行動應用程式實作不同，頁面/畫面檢視和其他事件沒有區別。 您可以改為在處理規則中設定​ 頁面名稱 ​維度，以增加​ 頁面檢視 ​量度。 由於您正在教學課程中收集自訂screenName欄位，強烈建議在處理規則中將熒幕名稱對應至​ 頁面名稱。

從Analytics行動擴充功能遷移

如果您已使用Adobe Analytics行動擴充功能開發行動應用程式，您很可能已使用MobileCore.trackAction和MobileCore.trackState API呼叫。

如果您決定移轉使用建議的Edge Network，您會有選項：

SUCCESS
您已在資料流中啟用Edge服務，藉此設定應用程式將Experience Adobe Analytics XDM物件對應至Adobe Analytics變數。 並在適用時使用處理規則。
感謝您花時間學習Adobe Experience Platform Mobile SDK。 如果您有任何疑問、想分享一般意見或有關於未來內容的建議，請在這篇Experience League社群討論貼文上分享。

下一步： 傳送資料至Experience Platform

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