이벤트
모바일 앱에서 이벤트를 추적하는 방법에 대해 알아봅니다.
Edge Network 확장은 Platform Edge Network에 경험 이벤트를 전송하기 위한 API를 제공합니다. 경험 이벤트 는 XDM ExperienceEvent 스키마 정의를 따르는 데이터가 포함된 개체입니다. 보다 간단하게, 모바일 앱에서 사람들이 하는 작업을 캡처합니다. Platform Edge Network에서 데이터를 수신하면 Adobe Analytics 및 Experience Platform과 같이 데이터 스트림에 구성된 애플리케이션 및 서비스로 전달할 수 있습니다. 에 대해 자세히 알아보기 경험 이벤트 를 참조하십시오.
사전 요구 사항
- 필요한 SDK를 사용하여 PodFile을 업데이트했습니다.
- AppDelegate에 등록된 확장입니다.
- 개발 AppId를 사용하도록 MobileCore를 구성했습니다.
- 가져온 SDK.
- 위의 변경 사항을 포함하여 앱을 빌드하고 실행했습니다.
학습 목표
이 단원에서는 다음 작업을 수행합니다.
- 스키마를 기반으로 XDM 데이터를 구성하는 방법을 이해합니다.
- 표준 필드 그룹을 기반으로 XDM 이벤트를 전송합니다.
- 사용자 지정 필드 그룹을 기반으로 XDM 이벤트를 보냅니다.
- XDM 구매 이벤트를 보냅니다.
- Assurance를 사용하여 확인합니다.
경험 이벤트 구성
Adobe Experience Platform Edge 확장은 이전에 정의한 XDM 스키마 다음에 오는 이벤트를 Adobe Experience Platform Edge Network로 전송할 수 있습니다.
프로세스는 다음과 같습니다.
-
추적하려는 모바일 앱 상호 작용을 식별합니다.
-
스키마를 검토하고 적절한 이벤트를 식별합니다.
-
스키마를 검토하고 이벤트를 설명하는 데 사용해야 하는 추가 필드를 식별합니다.
-
데이터 개체를 구성하고 채웁니다.
-
이벤트를 만들고 전송합니다.
-
유효성 검사.
몇 가지 예를 살펴보겠습니다.
예 #1 - 표준 필드 그룹
샘플 앱에서 구현하지 않고 다음 예를 검토하십시오.
-
스키마에서 수집하려는 이벤트를 식별합니다. 이 예제에서는 제품 보기를 추적합니다.
-
객체 구성을 시작합니다.
var xdmData: [String: Any] = [ "eventType": "commerce.productViews", "commerce": [ "productViews": [ "value": 1 ] ] ]- eventType: 발생한 이벤트를 설명합니다. 알려진 값 가능한 경우
- commerce.productViews.value: 이벤트의 숫자 값을 제공합니다. 부울(또는 Adobe Analytics의 "카운터")인 경우 값은 항상 1이 됩니다. 숫자 또는 통화 이벤트인 경우 값은 1보다 클 수 있습니다.
-
스키마에서 이벤트와 연결된 추가 데이터를 식별합니다. 이 예에서는 다음을 포함합니다
productListItems- 상거래 관련 이벤트와 함께 사용되는 표준 필드 세트입니다.
- 주의:
productListItems는 여러 제품을 제공할 수 있는 배열입니다.
- 주의:
-
보조 데이터를 포함하도록 xdmData 개체를 확장합니다.
var xdmData: [String: Any] = [ "eventType": "commerce.productViews", "commerce": [ "productViews": [ "value": 1 ] ], "productListItems": [ [ "name": productName, "SKU": sku, "priceTotal": priceString, "quantity": 1 ] ] ] -
데이터 구조를 사용하여
ExperienceEvent:let productViewEvent = ExperienceEvent(xdm: xdmData) -
Platform Edge Network에 이벤트 및 데이터 보내기:
Edge.sendEvent(experienceEvent: productViewEvent)
예제 #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 ] ] ] ] -
데이터 구조를 사용하여
ExperienceEvent.let appInteractionEvent = ExperienceEvent(xdm: xdmData) -
Platform Edge Network에 이벤트 및 데이터를 전송합니다.
Edge.sendEvent(experienceEvent: appInteractionEvent)
Luma 앱에 화면 보기 추적 추가
위의 예는 XDM 데이터 개체를 구성할 때 사고 프로세스를 설명했으리라 기대됩니다. 다음으로 Luma 앱에 화면 보기 추적을 추가합니다.
-
다음으로 이동
Home.swift. -
에 다음 코드를 추가합니다
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) -
앱의 각 화면에 대해 반복, 업데이트
stateName당신이 갈 때.
유효성 검사
- 리뷰 설치 지침 시뮬레이터 또는 장치를 Assurance에 연결하고 연결합니다.
- 작업을 수행하고 다음을 찾습니다
hitReceived다음에서 이벤트 발생com.adobe.edge.konductor공급업체. - 이벤트를 선택하고 의 XDM 데이터를 검토합니다.
messages개체.
예 #3 - 구매
이 예에서는 사용자가 성공적으로 다음 구매를 수행했다고 가정합니다.
- 제품 #1 - 요가 매트.
- US$49.99 x1
- SKU: 5829
- 제품 #2 - 물병.
- US$10.00 x3
- SKU: 9841
- 주문 합계: $79.99
- 고유 주문 ID: 298234720
- 결제 유형: Visa 신용 카드
- 고유 결제 거래 Id: 847361
스키마
다음은 사용할 관련 스키마 필드입니다.
- eventType: "commerce.purchases"
- commerce.purchases
- commerce.order
- productsListItems
- _techmarketingdemos.appStateDetails (custom)
사용자 정의 필드 그룹은 항상 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
- 장바구니에서 제거: productListRemovals
- 체크아웃 시작: 체크아웃
- 장바구니 보기: productListViews
- 위시리스트에 추가: saveForLaters
- 구매: 구매, 주문
리뷰 완전히 구현된 앱 추가 예제를 보려면 다음을 수행하십시오.
유효성 검사
-
리뷰 설치 지침 시뮬레이터 또는 장치를 Assurance에 연결하고 연결합니다.
-
작업을 수행하고 다음을 찾습니다
hitReceived다음에서 이벤트 발생com.adobe.edge.konductor공급업체. -
이벤트를 선택하고 의 XDM 데이터를 검토합니다.
messages개체.
Analytics 및 Platform에 이벤트 보내기
이제 이벤트를 수집하여 Platform Edge Network로 전송했으므로 데이터스트림. 이후 단원에서는 이 데이터를 다음에 매핑합니다. Adobe Analytics 및 Adobe Experience Platform.
다음: 웹 보기 수
Adobe Experience Platform Mobile SDK에 대해 학습하는 데 시간을 투자해 주셔서 감사합니다. 질문이 있거나, 일반적인 피드백을 공유하거나, 향후 콘텐츠에 대한 제안이 있는 경우 이에 대해 공유하십시오. Experience League 커뮤니티 토론 게시물
Business.Adobe.com 리소스
