Skip to content

Latest commit

 

History

History
1300 lines (674 loc) · 38.5 KB

campaign-experienceevent.schema.md

File metadata and controls

1300 lines (674 loc) · 38.5 KB

Adobe Campaign ExperienceEvent Template Schema

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

Campaign ExperienceEvent field group for use with schemas for Solution data ingestion. Includes the core/standard ExperienceEvent as well as the required Adobe Campaign ExperienceEvent field groups.

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

Schema Hierarchy

Adobe Campaign ExperienceEvent Template Example

{
  "@id": "https://data.adobe.io/experienceid-1234567",
  "xdm:dataSource": {
    "@id": "https://data.adobe.io/datasources/datasource-124",
    "xdm:code": "DataSourceIntegrationCode-124"
  },
  "xdm:timestamp": "2017-09-26T15:52:25+00:00",
  "xdm:identityMap": {
    "ECID": [
      {
        "xdm:id": "68519882713298129995549973016107434638",
        "xdm:primary": true
      }
    ],
    "CPGN": [
      {
        "xdm:id": "https://data.adobe.io/entities/identity/1234567",
        "xdm:primary": true
      }
    ]
  },
  "xdm:directMarketing": {
    "xdm:sends": {
      "xdm:value": 1
    }
  },
  "xdm:channel": {
    "@id": "https://ns.adobe.com/xdm/channels/email"
  },
  "https://ns.adobe.com/experience/campaign/message": {
    "xdm:id": 10000,
    "xdm:profile": {
      "xdm:person": {
        "xdm:birthMonth": 1,
        "xdm:birthDay": 3,
        "xdm:birthYear": 1996,
        "xdm:gender": "female"
      },
      "xdm:workAddress": {
        "@id": "https://ns.adobe.com/entities/address/123",
        "xdm:primary": true,
        "xdm:city": "San Jose",
        "xdm:stateProvinceISO": "CA",
        "xdm:postalCode": "95110",
        "xdm:countryCode": "US"
      },
      "xdm:workEmail": {
        "xdm:primary": true,
        "xdm:address": "[email protected]"
      }
    },
    "xdm:variant": "English",
    "xdm:seedMember": false,
    "xdm:quarantine": false,
    "xdm:proofMember": false,
    "xdm:controlGroupMember": false,
    "xdm:testMember": true,
    "xdm:size": 421,
    "xdm:outboundIP": "10.20.30.40",
    "xdm:externalID": "uuid:00112233-4455-6677-8899-AABBCCDDEEFF"
  },
  "https://ns.adobe.com/experience/campaign/delivery": {
    "xdm:id": 1001,
    "xdm:from": "[email protected]",
    "xdm:testEnabled": true,
    "xdm:messageClass": "continuous",
    "xdm:templateID": 1000,
    "xdm:deliveryName": "DM200",
    "xdm:deliveryLabel": "Birthday Wishes"
  },
  "https://ns.adobe.com/experience/campaign/marketingCampaign": {
    "xdm:id": 100,
    "xdm:campaignName": "CAMP2010"
  },
  "https://ns.adobe.com/experience/campaign/orchestration": {
    "xdm:eventID": "onJourneyEnter"
  },
  "https://ns.adobe.com/experience/campaign/containerID": "customer-stage",
  "https://ns.adobe.com/experience/campaign/eventSource": "pipelined-mta"
}

Adobe Campaign ExperienceEvent Template Properties

Property Type Required Defined by
https://ns.adobe.com/experience/campaign/containerID string Optional Adobe Campaign ExperienceEvent Full Extension
https://ns.adobe.com/experience/campaign/delivery object Optional Adobe Campaign ExperienceEvent Full Extension
https://ns.adobe.com/experience/campaign/eventSource string Optional Adobe Campaign ExperienceEvent Full Extension
https://ns.adobe.com/experience/campaign/link object Optional Adobe Campaign ExperienceEvent Full Extension
https://ns.adobe.com/experience/campaign/marketingCampaign object Optional Adobe Campaign ExperienceEvent Full Extension
https://ns.adobe.com/experience/campaign/medium string Optional Adobe Campaign ExperienceEvent Full Extension
https://ns.adobe.com/experience/campaign/message message.schema Optional Adobe Campaign ExperienceEvent Full Extension
https://ns.adobe.com/experience/campaign/mutation Adobe Campaign Mutation Event Optional Adobe Campaign ExperienceEvent Full Extension
https://ns.adobe.com/experience/campaign/offerOpened Campaign Offer Response Detail Optional Adobe Campaign ExperienceEvent Full Extension
https://ns.adobe.com/experience/campaign/offersProposed Campaign Offer Proposition Detail Optional Adobe Campaign ExperienceEvent Full Extension
https://ns.adobe.com/experience/campaign/orchestration orchestration.schema Optional Adobe Campaign ExperienceEvent Full Extension
https://ns.adobe.com/experience/decisioning/propositionID string Optional Experience Event - Proposition Reference
https://ns.adobe.com/experience/implementations Adobe Experience Platform Implementation Details Optional Adobe Experience Platform Implementation Details
https://ns.adobe.com/experience/profile/originDatasetID string Optional Adobe Unified Profile Service ExperienceEvent Shared Extension
https://ns.adobe.com/experience/target/supplementalDataID string Optional Adobe Target ExperienceEvent Shared Extension
xdm:advertising Advertising Optional Advertising Details
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:directMarketing Direct marketing Optional Direct Marketing Details
xdm:endUserIDs End user IDs Optional End User ID 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:profileStitch Profile stitch Optional Profile Stitch 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

Container Identifier

The identifier denoting the container with which Campaign ExperienceEvent is associated.

https://ns.adobe.com/experience/campaign/containerID

string

The campaign activity originating a message to a recipient.

https://ns.adobe.com/experience/campaign/delivery

object with following properties:

Property Type Required Default
xdm:deliveryLabel string Optional
xdm:deliveryName string Optional
xdm:from string Optional
xdm:id integer Optional
xdm:messageClass string Optional "one_time"
xdm:templateID integer Optional
xdm:templateName string Optional
xdm:testEnabled boolean Optional false

xdm:deliveryLabel

Delivery Label

A human-friendly name of the campaign activity which is originating this message.

xdm:deliveryLabel

  • is optional
  • type: string
xdm:deliveryLabel Type

string

xdm:deliveryName

Delivery Internal Name

A human-friendly identifier of the campaign activity which is originating this message.

xdm:deliveryName

  • is optional
  • type: string
xdm:deliveryName Type

string

xdm:from

From

Address used as a from/sender/caller address. Depending on the communication channel, the address has a different format.

  • email: an email address.
  • textMessage or phone: a shortcode or phone number.

xdm:from

  • is optional
  • type: string
xdm:from Type

string

xdm:id

Delivery ID

The campaign activity originating this message.

xdm:id

  • is optional
  • type: integer
xdm:id Type

integer

xdm:messageClass

Message Class

Mode of delivery for the messages sent.

xdm:messageClass

  • is optional
  • type: string
  • default: "one_time"
xdm:messageClass Type

string

xdm:messageClass Known Values
Value Description
one_time Marketing (One Time)
continuous Recurring
event_based Transactional (Event-based)

xdm:templateID

Identifier of the Template

The delivery template's ID used to initialize this delivery.

The type the template used in Adobe Campaign can be identified using the messageClass.

  • messageClass = oneTime: the template is standard delivery template.
  • messageClass = continuous: the template is a recurring delivery.
  • messageClass = transactional: the template is a transactional message template.

xdm:templateID

  • is optional
  • type: integer
xdm:templateID Type

integer

xdm:templateName

Delivery Template's Internal Name

A human-friendly identifier of the the parent entity (in case of event_based or continuous message Class) of the campaign activity originating this message.

xdm:templateName

  • is optional
  • type: string
xdm:templateName Type

string

xdm:testEnabled

Test Enabled

Specify whether campaign activity is of type A/B testing.

xdm:testEnabled

  • is optional
  • type: boolean
  • default: false
xdm:testEnabled Type

boolean

Event Source

A human-friendly name of the campaign activity which is originating this message.

https://ns.adobe.com/experience/campaign/eventSource

string

Value Description
replay-pipelined-mta This event was generated via Replay Utility tool generated from Pipelined
replay-pipelined-inMail This event was generated via Replay Utility tool generated from Pipelined
replay-pipelined-trackinglogd This event was generated via Replay Utility tool generated from Pipelined
replay-pipelined-pipelined This event was generated via Replay Utility tool generated from Pipelined
pipelined-mta This event was generated via Pipelined generated from mta
pipelined-inMail This event was generated via Pipelined generated from inMail
pipelined-trackinglogd This event was generated via Pipelined generated from trackinglogd
pipelined-pipelined This event was generated via Pipelined generated from Pipelined
replay This event was generated via Replay Utility tool which did not have any event source
pipelined-tracker This event was generated via Pipelined generated from TrackeR

The campaign activity originating a message to a recipient.

https://ns.adobe.com/experience/campaign/link

object with following properties:

Property Type Required Default
xdm:category string Optional
xdm:description string Optional
xdm:id string Optional
xdm:inAppMessageAction string Optional
xdm:inAppMessageButtonText string Optional
xdm:label string Optional
xdm:occurrence integer Optional 1
xdm:url string Optional

xdm:category

URL Category

The category of the link. It may be subscription, or a user-defined category.

xdm:category

  • is optional
  • type: string
xdm:category Type

string

xdm:description

Tracking URL Description

A human-friendly description of the link.

xdm:description

  • is optional
  • type: string
xdm:description Type

string

xdm:id

Tracking URL ID

Unique Identifier of the Link

xdm:id

  • is optional
  • type: string
xdm:id Type

string

xdm:inAppMessageAction

In-App Message Action

Actions on the In-App message delivered, e.g. action on primary button, secondary button or close button.

xdm:inAppMessageAction

  • is optional
  • type: string
xdm:inAppMessageAction Type

string

xdm:inAppMessageAction Known Values
Value Description
primary Primary action
secondary Secondary action
dismiss Dismiss action

xdm:inAppMessageButtonText

In-App Message Button Text

The user-friendly text on the button.

xdm:inAppMessageButtonText

  • is optional
  • type: string
xdm:inAppMessageButtonText Type

string

xdm:label

URL Label

The user-friendly label clicking on which the link opens.

xdm:label

  • is optional
  • type: string
xdm:label Type

string

xdm:occurrence

Occurrence

URL occurrence index in the content (first is 1). When the same URL is available several times in the same content, its is necessary to track which occurrence of the URL has been clicked on.

xdm:occurrence

  • is optional
  • type: integer
  • default: 1
xdm:occurrence Type

integer

  • minimum value: 1
  • maximum value: 32767

xdm:url

URL

URL of the Link.

xdm:url

  • is optional
  • type: string
xdm:url Type

string

  • format: uri – Uniformous Resource Identifier (according to RFC3986)

The campaign activity originating a message to a recipient.

https://ns.adobe.com/experience/campaign/marketingCampaign

object with following properties:

Property Type Required
xdm:campaignName string Optional
xdm:id integer Optional

xdm:campaignName

Campaign Internal Name

A human-friendly identifier of the marketing campaign which is originating this message.

xdm:campaignName

  • is optional
  • type: string
xdm:campaignName Type

string

xdm:id

Campaign ID

Identifier of the marketing campaign to which activity originating this message belongs to.

xdm:id

  • is optional
  • type: integer
xdm:id Type

integer

Medium

The medium is a combination of the source of the event (message, web, ...) and its format if applicable.

https://ns.adobe.com/experience/campaign/medium

string

Value Description
message_text The source of the event is message in a text format.
message_html The source of the event is message in a html format.
message_line The source of the event is a line message.
web The source of the event is web tracking tag in a web page.
offer The source of the event is an offer.

A single message sent to a recipient.

https://ns.adobe.com/experience/campaign/message

Mutated Fields from Previous ExperienceEvent.

Information of the fields that have changed since the previous ExperienceEvent to keep track of the state changes across events. For e.g. if when an email gets sent, an ExperienceEvent with metric sends will be sent. This may get bounced and an ExperienceEvent with metric bounces will be sent then. It may be important for a downstream application to know that the previous ExperienceEvent with metric sends is now to be invalidated. This field will contain the values from the previous ExperienceEvent that have a different value in the current ExperienceEvent.

https://ns.adobe.com/experience/campaign/mutation

Offer Opened

The offer in the message for an 'offer opened' event.

https://ns.adobe.com/experience/campaign/offerOpened

Offer Propositions

The offers in the message of a 'email-send' event.

https://ns.adobe.com/experience/campaign/offersProposed

Array type: Campaign Offer Proposition Detail

All items must be of the type:

Campaign Orchestration for creating user journey.

https://ns.adobe.com/experience/campaign/orchestration

Proposition Identifier

A unique identifier for the proposition event referenced by another "XDM ExperienceEvent". It is the expectation that applications use this "propositionID" in every experience event that was influenced by the set of propositions. An individual profile's proposition-response history is maintained with these proposition identifiers.

https://ns.adobe.com/experience/decisioning/propositionID

string

  • format: uri-reference – URI Reference (according to RFC3986)

https://ns.adobe.com/experience/implementations

Origin Dataset ID

Identity of the dataset that the Unified Profile Service ingested the data from. Usage is reserved for the Unified Profile Service.

https://ns.adobe.com/experience/profile/originDatasetID

string

Supplemental Data Identifier

Identifier used to stitch Target events with Analytics events

https://ns.adobe.com/experience/target/supplementalDataID

string

xdm:advertising

Advertising

Information related to advertising impressions, clickthroughs, and attribution.

xdm:advertising

xdm:advertising Type

  • Advertisinghttps://ns.adobe.com/xdm/context/advertising

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:directMarketing

Direct marketing

Events and properties related to direct and outbound marketing such as email, direct mail, texts, and in-app notifications.

xdm:directMarketing

xdm:directMarketing Type

xdm:endUserIDs

EndUserIDs

Condensed, normalized encapsulation of end user identifiers asserted for this ExperienceEvent.

xdm:endUserIDs

xdm:endUserIDs Type

  • End user IDshttps://ns.adobe.com/xdm/context/enduserids

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:profileStitch

Profile stitch

Details about the IDs that were joined by profile stitching.

xdm:profileStitch

xdm:profileStitch Type

Array type: Profile stitch

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