蜜豆视频

Input and output in Customer AI

The following document outlines the different required events, inputs, and outputs utilized in Customer AI.

Getting started getting-started

Here are the steps to build propensity models and identify target audiences for personalized marketing in Customer AI:

  1. Outline use cases: How would propensity models help to identify target audiences for personalized marketing? What are my business goals and corresponding tactics to achieve the goal? Where can propensity modeling fit in this process?

  2. Prioritize use cases: Which are the highest priorities for the business?

  3. Build models in Customer AI: Watch this quick tutorial and refer to our UI guide for a step-by-step process to build a model.

  4. Build segments using model results.

  5. Take targeted business actions based on these segments. Monitor the results and iterate over the actions to improve.

Here are example configurations for your first model. The example model, built in this document, uses a Customer AI model to predict who is likely to convert for a retail business in the next 30 days. The input dataset is an 蜜豆视频 Analytics dataset.

Step
Definition
Example
Set Up
Specify basic information about the model.
Name: Pencil purchase propensity model
Model Type: Conversion
Select Data
Specify the datasets used to build the model.
Dataset: 蜜豆视频 Analytics dataset
Identity: Ensure the identity column for each dataset is set to be a common identity.
Define Goal
Define the goal, eligible population, custom events, and profile attributes.
Prediction Goal: Select commerce.purchases.value equals to pencil
Outcome window: 30 days.
Set Options
Set up the schedule for model refresh and enable scores for Profile
Schedule: Weekly
Enable for profile: This must be enabled for the model output to be used in segmentation.

Data overview data-overview

The following sections outline the different required events, inputs, and outputs utilized in Customer AI.

Customer AI works by analyzing the following datasets to predict churn (when a customer is likely to stop using the product) or conversion (when a customer is likely to make a purchase) propensity scores:

You can add multiple datasets from different sources if each of the datasets share the same identity type (namespace) such as an ECID. For more information on adding multiple datasets, visit the Customer AI user guide.

IMPORTANT
Source connectors take up to four weeks to backfill data. If you recently set up a connector you should verify that the dataset has the minimum length of data required for Customer AI. Please review the historical data section to verify you have enough data for your prediction goal.

The following table outlines some common terminology used in this document:

Term
Definition
Experience Data Model (XDM)
XDM is the foundational framework that allows 蜜豆视频 Experience Cloud, powered by 蜜豆视频 Experience Platform, to deliver the right message to the right person, on the right channel, at exactly the right moment. Platform uses XDM System to organize data in a certain way that makes it easier to use for Platform services.
XDM Schema
Experience Platform uses schemas to describe the structure of data in a consistent and reusable way. By defining data consistently across systems, it becomes easier to retain meaning and therefore gain value from data. Before data can be ingested into Platform, a schema must be composed to describe the data鈥檚 structure and provide constraints to the type of data that can be contained within each field. Schemas consist of a base XDM class and zero or more schema field groups.
XDM class
All XDM schemas describe data that can be categorized as Experience Event. The data behavior of a schema is defined by the schema鈥檚 class, which is assigned to a schema when it is first created. XDM classes describe the smallest number of properties a schema must contain in order to represent a particular data behavior.
Field groups
A component that defines one or more fields in a schema. Field groups enforce how their fields appear in the schema鈥檚 hierarchy, and therefore exhibit the same structure in every schema that they are included in. Field groups are only compatible with specific classes, as identified by their meta:intendedToExtend attribute.
Data type
A component that can also provide one or more fields for a schema. However, unlike field groups, data types are not constrained to a particular class. This makes data types a more flexible option to describe common data structures that are reusable across multiple schemas with potentially different classes. The data types outlined in this document are supported by both the CEE and 蜜豆视频 Analytics schemas.
Real-time Customer Profile
Real-time Customer Profile provides a centralized consumer profile for targeted and personalized experience management. Each profile contains data that is aggregated across all systems, as well as actionable timestamped accounts of events involving the individual that have taken place in any of the systems you use with Experience Platform.

Customer AI input data customer-ai-input-data

For input datasets, like 蜜豆视频 Analytics and 蜜豆视频 Audience Manager, the respective source connectors directly map the events in these standard field groups (Commerce, Web, Application, and Search) by default during the connection process. The table below shows the event fields in the default standard field groups for Customer AI.

For more information on mapping 蜜豆视频 Analytics data or Audience Manager data, visit the Analytics field mappings or Audience Manager field mappings guide.

You can use Experience Event or Consumer Experience Event XDM schemas for input datasets that are not populated via one of the above connectors. Additional XDM field groups can be added during the schema creation process. The field groups can be provided by 蜜豆视频 like the standard field groups or a custom field group, which matches the data representation in the Platform.

IMPORTANT
You must ensure that data is being populated into these input datasets. If no events from standard field groups are found in the input datasets, you must add custom events during the configuration workflow. Please see details about custom events.

Standard field groups used by Customer AI standard-events

Experience Events are used for determining various customer behaviors. Depending on how your data is structured, the event types listed below may not encompass all of your customer鈥檚 behaviors. It is up to you to determine what fields have the necessary data that is needed to identify web or other channel-specific user activity clearly and unambiguously. Depending on your prediction goal, the required fields that are needed can change.

NOTE
If you are using 蜜豆视频 Analytics or 蜜豆视频 Audience Manager data, the schema is created automatically with the required standard events that are needed to capture your data. If you are creating your own custom EE schema to capture data, you need to consider what field groups are needed to capture your data.

Customer AI uses the events in these four standard field groups by default: Commerce, Web, Application, and Search. It is not necessary to have data for each event in the standard field groups listed below but certain events are required for certain scenarios. If you have any events in the standard field groups available, it is recommended that you include it in your schema. For example, if you wanted to create a Customer AI model for predicting purchase events, it is useful to have data from the Commerce and Web page details field groups.

To view a field group in the Platform UI, select the Schemas tab on the left-rail followed by selecting the Field groups tab.

Field group
Event type
XDM field path
Commerce Details
order
  • commerce.order.purchaseID

  • productListItems.SKU

productListViews
  • commerce.productListViews.value

  • productListItems.SKU

checkouts
  • commerce.checkouts.value

  • productListItems.SKU

purchases
  • commerce.purchases.value

  • productListItems.SKU

productListRemovals
  • commerce.productListRemovals.value

  • productListItems.SKU

productListOpens
  • commerce.productListOpens.value

  • productListItems.SKU

productViews
  • commerce.productViews.value

  • productListItems.SKU

Web Details
webVisit
web.webPageDetails.name
webInteraction
web.webInteraction.linkClicks.value
Application Details
applicationCloses
  • application.applicationCloses.value

  • application.name

applicationCrashes
  • application.crashes.value

  • application.name

applicationFeatureUsages
  • application.featureUsages.value

  • application.name

applicationFirstLaunches
  • application.firstLaunches.value

  • application.name

applicationInstalls
  • application.installs.value

  • application.name

applicationLaunches
  • application.launches.value

  • application.name

applicationUpgrades
  • application.upgrades.value

  • application.name

Search Details
search
search.keywords

Additionally, Customer AI can use subscription data to build better churn models. Subscription data is needed for each profile using the Subscription data type format. Most of the fields are optional, however, for an optimal churn model it is highly recommended that you provide data for as many fields as possible such as, startDate, endDate, and any other relevant details. Please reach out to your account team for additional support on this feature.

Adding custom events and profile attributes add-custom-events

If you have information you wish to include in addition to the default standard event fields used by Customer AI, you can use the custom event configuration to augment the data used by the model.

When to use custom events

Custom events are necessary when the datasets chosen in the dataset selection step contain none of the default event fields used by Customer AI. Customer AI needs information about at least one user behavior event other than the outcome.

Custom events are helpful for:

  • Incorporating domain knowledge or prior expertise into the model.

  • Improving the predictive model quality.

  • Gaining additional insights and interpretations.

The best candidates for custom events are data that contain domain knowledge that may be predictive of the outcome. Some general examples of custom events include:

  • Register for account

  • Subscribe to newsletter

  • Make a call to customer service

The following are a selection of industry-specific custom event examples:

Industry
Custom events
Retail
In-store transaction
Sign up for club card
Clip mobile coupon.
Entertainment
Purchase season membership
Stream video.
Hospitality
Make restaurant reservation
Purchase loyalty points.
Travel
Add known traveler info Purchase miles.
Communications
Upgrade/downgrade/cancel plan.

Custom events must represent user-initiated actions in order to be selected. For example, 鈥淓mail Send鈥 is an action initiated by a marketer and not by the user, so it shouldn鈥檛 be used as a custom event.

Historical data

Customer AI requires historical data for model training. The required duration for data to exist within the system is determined by two key elements: the outcome window and eligible population.

By default, Customer AI looks for a user to have had activity in the last 45 days if no eligible population definition is provided during the application configuration. Additionally, Customer AI requires a minimum of 500 qualifying and 500 non-qualifying events (1000 total) from historical data based on a predicted goal definition.

The following examples demonstrate the use of a simple formula which helps you determine the minimum amount of data required. If you have more data than the minimum requirement, your model is likely to provide more accurate results. If you have less than the minimum amount required, the model will fail, as there is not enough data for model training.

Customer AI employs a survival model to estimate the probability of an event occurring at a given time and identify influencing factors, alongside supervised learning which defines positive and negative populations, and decision-based trees like lightgbm to generate a probability score.

Formula:

To decide the minimum required duration of data existing within the system:

  • The minimum data required to create features is 30 days. Compare the eligibility lookback window with 30 days:

    • If the eligibility lookback window is greater than 30 days, the data requirement = eligibility lookback window + outcome window.

    • Otherwise, the data requirement = 30 days + outcome window.

** If there is more than one condition for defining the eligible population, the eligibility lookback window is the longest one.

NOTE
30 is the minimum number of days required for eligible population. If this is not provided the default is 45 days.

Examples:

  • You want to predict whether a customer is likely to purchase a watch in the next 30 days for those who have some web activity in the last 60 days.

    • Eligibility lookback window = 60 days

    • Outcome window = 30 days

    • Data required = 60 days + 30 days = 90 days

  • You want to predict whether the user is likely to purchase a watch in the next 7 days without providing an explicit eligible population. In this case, the eligible population defaults to 鈥渢hose who have had activity in the last 45 days鈥 and the outcome window is 7 days.

    • Eligibility lookback window = 45 days

    • Outcome window = 7 days

    • Data required = 45 days + 7 days = 52 days

  • You want to predict whether the customer is likely to purchase a watch in the next 7 days for those who have some web activity in the last 7 days.

    • Eligibility lookback window = 7 days

    • Minimum data required to create features = 30 days

    • Outcome window = 7 days

    • Data required = 30 days + 7 days = 37 days

Although Customer AI requires a minimum period of time for the data to exist within the system, it also works best with recent data. By using more recent behavioral data, Customer AI is likely to yield a more accurate prediction of a user鈥檚 future behavior.

Customer AI output data customer-ai-output-data

Customer AI generates several attributes for individual profiles that are deemed eligible. There are two ways to consume the score (output) based on what you have provisioned. If you have a Real-time Customer Profile-enabled dataset, you can consume insights from Real-time Customer Profile in the Segment Builder. If you don鈥檛 have a Profile-enabled dataset, you can download the Customer AI output dataset available on the data lake.

You can find the output dataset in the Platform Datasets workspace. All Customer AI output datasets start with the name Customer AI Scores - NAME_OF_APP. Similarly, all Customer AI output schemas start with the name Customer AI Schema - Name_of_app.

Name of the output datasets in Customer AI

The table below describes the various attributes found in the output of Customer AI:

Attribute
Description
Score
The relative likelihood for a customer to achieve the predicted goal within the defined time frame. This value is not to be treated as a probability percentage but rather the likelihood of an individual compared to the overall population. This score ranges from 0 to 100.
Probability
This attribute is the true probability of a profile for achieving the predicted goal within the defined time frame. When comparing outputs across different goals, you are recommended to consider probability over percentile or score. Probability should always be used when determining the average probability across the eligible population, as the probability tends to be on the lower side for events that do not occur frequently. Values for the probability range between 0 and 1.
Percentile
This value provides information regarding the performance of a profile relative to other similarly scored profiles. For example, a profile with a percentile rank of 99 for churn indicates that it is at a higher risk of churning compared to 99% of all other profiles that were scored. The percentiles range from 1 to 100.
Propensity type
The selected propensity type.
Score date
The date on which scoring occurred.
Influential factors

These are predicted reasons as to why a profile is likely to convert or churn. These factors are comprised of the following attributes:

  • Code: The profile or behavioral attribute which positively influences a profile鈥檚 predicted score.
  • Value: The value of the profile or behavioral attribute.
  • Importance: Indicates the weight of the profile or behavioral attribute has on the predicted score (low, medium, high)

Next steps next-steps

Once you prepare your data and ensure that all your credentials and schemas are in place, refer to the Configure a Customer AI Instance guide, which walks you through a step-by-step tutorial to create a Customer AI instance.

recommendation-more-help
8959a20a-a58f-4057-9f82-870706c576e9