설명서Experience Platform모바일 앱 튜토리얼

이벤트 데이터 추적

Last update: Fri Sep 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 초급
  • 중간
  • 개발자

모바일 앱에서 이벤트를 추적하는 방법에 대해 알아봅니다.

Edge Network 확장은 Platform Edge Network에 경험 이벤트를 전송하기 위한 API를 제공합니다. 경험 이벤트는 XDM ExperienceEvent 스키마 정의를 따르는 데이터가 포함된 개체입니다. 보다 간단하게 설명하면, 이러한 이벤트는 사람들이 모바일 앱에서 수행하는 작업을 캡처합니다. Platform Edge Network이 데이터를 수신하면 해당 데이터를 Adobe Analytics 및 Experience Platform과 같이 데이터 스트림에 구성된 애플리케이션 및 서비스로 전달할 수 있습니다. 제품 설명서에서 경험 이벤트에 대해 자세히 알아보세요.

전제 조건

  • 모든 패키지 종속성은 Xcode 프로젝트에서 구성됩니다.
  • AppDelegate ​에 등록된 확장입니다.
  • 개발 appId을(를) 사용하도록 MobileCore 확장을 구성했습니다.
  • 가져온 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는 MobileCore.trackAction 및 MobileCore.trackState API 호출에 해당하는 AEP Mobile SDK입니다. 자세한 내용은 Analytics 모바일 확장에서 Adobe Experience Platform Edge Network으로 마이그레이션을 참조하십시오.

이제 프로젝트에서 이 코드를 구현합니다.
앱에 서로 다른 상거래 제품 관련 작업이 있으며 사용자가 수행한 다음 작업에 따라 이벤트를 전송하려고 합니다.

  • 보기: 사용자가 특정 제품을 볼 때 발생합니다.
  • 장바구니에 추가: 사용자가 제품 세부 정보 화면에서 장바구니 를 탭할 때,
  • 나중에 저장: 사용자가 제품 세부 사항 화면에서 Heart / ThumbUp 을(를) 탭할 때,
  • 구매: 사용자가 제품 세부 정보 화면에서 CreditCard 을(를) 탭할 때.

재사용 가능한 방식으로 상거래 관련 경험 이벤트 전송을 구현하려면 전용 함수를 사용합니다.

iOS

  1. Xcode Project 탐색기에서 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 Project 탐색기의 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. 도구 모음의 각 단추( Heart , ShoppingCart 및 CreditCard )에 대해 ATTrackingManager.trackingAuthorizationStatus == .authorized 종료 내에 관련 호출을 추가하십시오.

      1. 심장 의 경우:

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

      2. 장바구니 의 경우:

        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 VDown > 앱 > 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. 장바구니 의 경우:

        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™용으로 개발하는 경우 맵(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 > LoginSheet(으)로 이동합니다.

    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 VDown 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 V자형 화살표 app>kotlin+java>com.adobe.luma.tutorial.android>​보기​>​ LoginSheet.kt ​ ​로 이동합니다.

    1. Button 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. Heart (iOS) 또는 ThumbUp (Android)을 선택합니다.
    6. ShoppingCartAdd 를 선택하십시오.
    7. 신용 카드 를 선택하십시오.
iOS
{width="300"}
Android
{width="278"}

  1. Assurance UI에서 com.adobe.edge.konductor 공급업체에서 hitReceived 이벤트를 찾습니다.

  2. 이벤트를 선택하고 messages 개체에서 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