Skip to content

Latest commit

 

History

History
466 lines (294 loc) · 15.5 KB

consumer-experienceevent.schema.md

File metadata and controls

466 lines (294 loc) · 15.5 KB

Consumer ExperienceEvent Field Group Schema

https://ns.adobe.com/experience/consumer-experienceevent

A set of standard fields to describe the behavior of an individual. This field group can be used to express behavior of a consumer related to digital content consumption (web, mobile app), online or off-line purchases. The use of this standard represention allows for a single representation for data producers and consumers of consumer behavior in Experience Platform

Abstract Extensible Status Identifiable Custom Properties Additional Properties Defined In
Can be instantiated Yes Deprecated No Forbidden Permitted adobe/experience/consumer-experienceevent.schema.json

Schema Hierarchy

Consumer ExperienceEvent Field Group Example

{
  "@id": "https://data.adobe.io/experienceid-123456",
  "xdm:dataSource": {
    "@id": "https://data.adobe.io/datasources/datasource-123",
    "xdm:code": "DataSourceIntegrationCode-123"
  },
  "xdm:timestamp": "2017-09-26T15:52:25+00:00",
  "xdm:identityMap": {
    "ECID": [
      {
        "id": "68519882713298129995549973016107434638",
        "primary": true
      }
    ],
    "AVID": [
      {
        "id": "2dfb7d8e00003ba4-056de00000000085",
        "primary": false
      }
    ]
  },
  "xdm:channel": {
    "@id": "https://ns.adobe.com/xdm/channels/apns",
    "@type": "https://ns.adobe.com/xdm/channel-types/mobile"
  },
  "xdm:environment": {
    "xdm:type": "browser",
    "xdm:browserDetails": {
      "xdm:name": "Chrome",
      "xdm:version": "63.0.3239",
      "xdm:acceptLanguage": "en",
      "xdm:cookiesEnabled": true,
      "xdm:javaScriptEnabled": true,
      "xdm:javaScriptVersion": "1.8.5",
      "xdm:javaEnabled": true,
      "xdm:javaVersion": "Java SE 8",
      "xdm:viewportHeight": 900,
      "xdm:viewportWidth": 1680
    },
    "xdm:operatingSystem": "MAC OS",
    "xdm:operatingSystemVersion": "10.13",
    "xdm:connectionType": "cable"
  },
  "xdm:productListItems": [
    {
      "xdm:SKU": "1002352692",
      "xdm:lineItemId": "12345678",
      "xdm:name": "24-Watt 8-Light Chrome Integrated LED Bath Light",
      "xdm:currencyCode": "USD",
      "xdm:quantity": 1,
      "xdm:priceTotal": 159
    }
  ],
  "xdm:commerce": {
    "xdm:order": {
      "xdm:purchaseID": "a8g784hjq1mnp3",
      "xdm:purchaseOrderNumber": "123456",
      "xdm:payments": [
        {
          "xdm:transactionID": "transactid-a111",
          "xdm:paymentAmount": 59,
          "xdm:paymentType": "credit_card",
          "xdm:currencyCode": "USD"
        },
        {
          "xdm:transactionId": "transactid-a222",
          "xdm:paymentAmount": 100,
          "xdm:paymentType": "gift_card",
          "xdm:currencyCode": "USD"
        }
      ],
      "xdm:currencyCode": "USD",
      "xdm:priceTotal": 159
    },
    "xdm:purchases": {
      "xdm:value": 1
    }
  },
  "xdm:placeContext": {
    "xdm:localTime": "2017-09-26T15:52:25+13:00",
    "xdm:geo": {
      "@id": "https://data.adobe.io/entities/geo/tokyo",
      "xdm:countryCode": "JP",
      "xdm:stateProvince": "JP-13",
      "xdm:city": "Tōkyō",
      "xdm:postalCode": "141-0032",
      "schema:latitude": 35.6185,
      "schema:longitude": 139.73237
    }
  },
  "xdm:web": {
    "xdm:webPageDetails": {
      "xdm:siteSection": "Shopping Cart",
      "xdm:server": "example.com",
      "xdm:name": "Purchase Confirmation",
      "xdm:URL": "https://www.example.com/orderConf",
      "xdm:errorPage": false,
      "xdm:homePage": false,
      "xdm:pageViews": {
        "xdm:value": 1
      }
    },
    "xdm:webReferrer": {
      "xdm:URL": "https://www.example.com/checkout",
      "xdm:referrerType": "internal"
    }
  },
  "xdm:marketing": {
    "xdm:trackingCode": "marketingcampaign111"
  }
}

Consumer ExperienceEvent Field Group Properties

Property Type Required Defined by
xdm:application Application Optional Application Details
xdm:channel Experience Channel Optional Channel Details
xdm:commerce Commerce Optional Commerce Details
xdm:dataSource Data Source Optional Technical Details
xdm:device Device Optional Environment Details
xdm:environment Environment Optional Environment Details
xdm:marketing Marketing Optional Campaign Marketing Details
xdm:media Media information Optional Media Interaction Details
xdm:placeContext Place context Optional Environment Details
xdm:productListItems Product list item Optional Commerce Details
xdm:receivedTimestamp string Optional Technical Details
xdm:search Search Optional Search Details
xdm:segmentMembership object Optional Segment Membership Details
xdm:segmentMemberships Segment membership item Optional Segment Membership Details
xdm:web Web information Optional Web Details
* any Additional this schema allows additional properties

xdm:application

Application

This fieldgroup is used to capture application information related to an ExperienceEvent, including the name of the application, app version, installs, launches, crashes, and closures. It could be either the application targeted by the event like the send of a push notification or the application originating the event such as a click, or a login.

xdm:application

xdm:application Type

  • Applicationhttps://ns.adobe.com/xdm/context/application

xdm:channel

Experience channel

Experience channel related to the ExperienceEvent.

xdm:channel

xdm:channel Type

xdm:commerce

Commerce

Product returns, warranty registration, and shopping cart/order process.

xdm:commerce

xdm:commerce Type

  • Commercehttps://ns.adobe.com/xdm/context/commerce

xdm:dataSource

Data source

Globally unique identification of a data source.

xdm:dataSource

xdm:dataSource Type

  • Data Sourcehttps://ns.adobe.com/xdm/data/datasource

xdm:device

Device

An identified device, application or device browser instance that is trackable across sessions, normally by cookies.

xdm:device

xdm:device Type

  • Devicehttps://ns.adobe.com/xdm/context/device

xdm:environment

Environment

Information about the surrounding situation the event observation occurred in, specifically detailing transitory information such as the network or software versions.

xdm:environment

xdm:environment Type

  • Environmenthttps://ns.adobe.com/xdm/context/environment

xdm:marketing

Marketing

Tracks offer impression and social network interactions.

xdm:marketing

xdm:marketing Type

  • Marketinghttps://ns.adobe.com/xdm/context/marketing

xdm:media

Media

Media activity information related to the experience event.

xdm:media

xdm:media Type

xdm:placeContext

Place context

The transient circumstances related to the observation. Examples include locale specific information such as weather, local time, traffic, day of the week, workday vs. holiday, and working hours.

xdm:placeContext

xdm:placeContext Type

  • Place contexthttps://ns.adobe.com/xdm/context/placecontext

xdm:productListItems

Product list items

A list of items representing a product selected by a customer with specific options and pricing that are for that usage context at a specific point of time and may differ from the product record.

xdm:productListItems

xdm:productListItems Type

Array type: Product list item

All items must be of the type:

xdm:receivedTimestamp

Received time stamp

The time at which this interaction was received by a server.

xdm:receivedTimestamp

xdm:receivedTimestamp Type

string

xdm:search

Search

The information related to web or mobile search.

xdm:search

xdm:search Type

  • Searchhttps://ns.adobe.com/xdm/context/search

xdm:segmentMembership

Segment Membership Map

xdm:segmentMembership

xdm:segmentMembership Type

object with following properties:

Property Type Required

xdm:segmentMemberships

Segment Memberships

The segments associated with this ExperienceEvent. Deprecated, use xdm:segmentMembership instead.

xdm:segmentMemberships

xdm:segmentMemberships Type

Array type: Segment membership item

All items must be of the type:

xdm:web

Web

Link clicks, web page details, referrer information, and browser details.

xdm:web

  • is optional
  • type: Web information
  • defined in Web Details

xdm:web Type