Track event data

Identify the mobile app interaction that you are trying to track.

Review your schema and identify the appropriate event.

Review your schema and identify any additional fields that should be used to describe the event.

Construct & populate the data object.

Create & send event.

Validate.

Navigate to Luma > Luma > Utils > MobileSDK in Xcode Project navigator, and add the following to the func sendCommerceExperienceEvent(commerceEventType: String, product: Product) function.

// 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)

This function takes the commerce experience event type and product as parameters and

• sets up the XDM payload as a dictionary, using the parameters from the function,
• sets up an experience event using the dictionary,
• sends the experience event using the Edge.sendEvent API.

Navigate to Luma > Luma > Views > Products > ProductView in Xcode Project navigator and add various calls to the sendCommerceExperienceEvent function:

1. At the .task modifier, within the ATTrackingManager.trackingAuthorizationStatus closure. This .task modifier is called when product view is initialized and shown, so you want to send a product view event at that specific moment.

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

2. For each of the buttons ( {width="15"}, {width="20"} and {width="20"}) in the toolbar, add the relevant call within the ATTrackingManager.trackingAuthorizationStatus == .authorized closure:

   1. For {width="15"}:

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

   2. For {width="20"}:

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

   3. For {width="20"}:

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

For convenience, you define two functions in MobileSDK. Navigate to Luma > Luma > Utils > MobileSDK in your Xcode Project navigator.

1. One for app interactions. Add this code to the func sendAppInteractionEvent(actionName: String) function:

   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)

   This function uses the action name as a parameter and

   • sets up the XDM payload as a dictionary, using the parameter from the function,
   • sets up an experience event using the dictionary,
   • sends the experience event using the Edge.sendEvent API.

2. And one for screen tracking. Add this code to the func sendTrackScreenEvent(stateName: String) function:

   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)

   This function uses the state name as a parameter and

   • sets up the XDM payload as a dictionary, using the parameter from the function,
   • sets up an experience event using the dictionary,
   • sends the experience event using the Edge.sendEvent API.

Navigate to Luma > Luma > Views > General > LoginSheet.

1. Add the following highlighted code to the Login button closure:

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

2. Add the following highlighted code to onAppear modifier:

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

Review the setup instructions section to connect your simulator or device with Assurance.

1. Move the Assurance icon to the left.

2. Select Home in the tab bar and verify you see an ECID, Email, and CRM ID in the Home screen.

3. Select Products in the tab bar.

4. Select a product.

5. Select {width="15"}.

6. Select {width="20"}.

7. Select {width="15"}.

   {width="300"}

In the Assurance UI, look for the hitReceived events from the com.adobe.edge.konductor vendor.

Select the event and review the XDM data in the messages object. Alternatively, you can use Copy Raw Event and use a text or code editor of your preference to paste and inspect the event.