Required XDM Fields for "First Launch" Event via Adobe Edge API (Without SDK)?

[PavelKr]

Hi Adobe Analytics community,

I need to manually send First Launch events to Adobe Analytics using the Edge Network API (XDM). Could someone clarify the exact XDM fields required to trigger this event correctly? We don't use SDK, so everything needs to be configured manually:

1. Core Fields:

   • Is eventType: "application.launch" required, or is there a reserved event type for first launches?

   • Are application.isInstall and application.sessionDetails.firstLaunch the correct fields to flag a first launch?

2. Session Metadata:

   • Are application.sessionDetails.launches and previousSessionLength mandatory?

Example xdm:

{
  "events": [{
    "xdm": {
      "eventType": "application.launch",
      "application": {
        "isInstall": true,
        "sessionDetails": {
          "firstLaunch": true,
          "launches": 1,
          "previousSessionLength": 0
        }
      },
      "identityMap": {
        "FPID": [{
          "id": "UUID_HERE", 
          "primary": true
        }]
      },
      "timestamp": "2024-02-20T12:00:00Z"
    }
  }]
}

Any insights or official documentation references would be greatly appreciated!

Thank you!
Pavel

[Harveer_SinghGi1 · Accepted solution]

Hi @PavelKr ,

I beleive the fields that you are looking for are xdm.application.isInstall and xdm.application.isUpgrade which contribute towards First Launches when working with Edge Network API.

Cheers!