com.medallia.mxo.interactions
All of APIs listed on this page are in the com.medallia.mxo.interactions
package.
MXOAction
Actions are the objects, or containers, that hold the messages, marketing content, agent scripts, app alerts, and so on that you want to present to visitors to customers to your Touchpoints. Actions are the things that MXO does in order to affect the customer's experience. MXO provides both online and offline Actions.
public data class MXOAction(
public val name: String? = null,
public val asset: MXOAsset? = null,
public val proposition: MXOProposition? = null,
)
Property | Type | Description |
---|---|---|
name | String? | The name of the Action. |
asset | MXOAsset? | The Asset for this Action. |
proposition | MXOProposition? | The optional Proposition for this Action. |
MXOAsset
Assets are the content, or bundles of content, that are delivered to the customer via an MXO Action. Assets can be graphics, HTML files, XML, text, or external Assets that are available for display.
public data class MXOAsset(
public val markup: String? = null,
public val responses: Set<MXOAssetResponse> = emptySet(),
public val mimeType: MXOMimeType = MXOMimeType.UNKNOWN,
public val contentUrl: URI? = null,
)
Property | Type | Description |
---|---|---|
markup | String? | The language markup for presenting the Asset. |
responses | Set<MXOAssetResponse> | The optional responses for informing MXO of a user Interaction with the Asset. |
mimeType | MXOMimeType | The markup language type. |
contentUrl | URI? | A remote location the Asset represents. |
MXOAssetResponse
MXO Asset response for tracking.
public data class MXOAssetResponse(
public val code: MXOResponseCode? = null,
public val sentiment: MXOAssetResponseSentiment = MXOAssetResponseSentiment.UNKNOWN,
public val label: MXOAssetResponseLabel? = null,
public val imageUrl: URI? = null,
public val targetUrl: URI? = null,
public val target: MXOAssetResponseTarget? = null,
)
Property | Type | Description |
---|---|---|
code | MXOResponseCode? | The code to send to MXO when an Asset is responded to. |
sentiment | MXOAssetResponseSentiment | The type of response to track. |
label | MXOAssetResponseLabel? | The label to show if desired. |
imageUrl | URI? | The image to load if desired. |
targetUrl | URI? | The target URL to load if desired. |
target | MXOAssetResponseTarget? | The location the sentiment should send the user. |
MXOAssetResponseLabel
Optional Label to display for an asset response.
public data class MXOAssetResponseLabel(
public val value: String,
)
Property | Type | Description |
---|---|---|
value | String | The label for the Asset. |
MXOAssetResponseSentiment
This is how a user responded to an MXO Asset response.
public enum class MXOAssetResponseSentiment {
POSITIVE,
NEUTRAL,
NEGATIVE,
UNKNOWN,
}
Enum | Description |
---|---|
POSITIVE | The positive tap on an Asset. |
NEUTRAL | The Asset is dismissed or ignored. |
NEGATIVE | The Asset is rejected. |
UNKNOWN | Unknown response. |
MXOAssetResponseTarget
The location of an MXO Asset response.
public enum class MXOAssetResponseTarget {
IN_APP,
EXTERNAL,
CONTEXT,
UNKNOWN,
}
Enum | Description |
---|---|
IN_APP | The Asset is targeted to the same app. |
EXTERNAL | The Asset is targeted to an external URL. |
CONTEXT | The Asset is targeted to an Action context. |
UNKNOWN | Unknown response. |
MXOCaptureActivityPoint
Capture user Activity when they interact with an MXO Interaction.
public data class MXOCaptureActivityPoint(
public val id: String? = null,
public val path: String? = null,
)
Property | Type | Description |
---|---|---|
id | String? | The internal MXO id of the point. |
path | String? | The location of Activity to capture, such as a button click. |
MXOCaptureAttributePoint
Capture user Attribute when they interact with an MXO Interaction.
public data class MXOCaptureAttributePoint(
public val id: String? = null,
public val path: String? = null,
public val elementType: MXOCaptureElementType? = null,
public val elementName: String? = null,
public val elementAttributeName: String? = null,
public val captureDelay: Int = 0,
public val captureType: MXOCaptureType? = null,
public val capturePhase: MXOCapturePhase? = null,
)
Property | Type | Description |
---|---|---|
id | String? | The internal MXO id of the point. |
path | String? | The location of Attribute to capture, such as a button click. |
elementType | MXOCaptureElementType? | The type of the element. |
elementName | String? | The name of the element. |
elementAttributeName | String? | The name of the element Attribute to capture. |
captureDelay | Int | How long to wait to capture the value. |
captureType | MXOCaptureType? | The type of capture. |
capturePhase | MXOCapturePhase? | The lifecycle time to capture the value. |
MXOCaptureElementType
The type of an element.
public enum class MXOCaptureElementType {
TEXT_FIELD,
CHECKBOX_RADIO,
DISPLAY_ELEM,
DROP_DOWN,
}
Enum | Description |
---|---|
TEXT_FIELD | Input value for the text or search field. |
CHECKBOX_RADIO | Input value for the selected checkbox/radio button. |
DISPLAY_ELEM | Display value for the selected display element. |
DROP_DOWN | Input value for the selected dropdown list. |
MXOCapturePhase
The phase in which to capture an Attribute.
public enum class MXOCapturePhase {
LOAD,
ON_CLICK,
PARAMETER,
}
Enum | Description |
---|---|
LOAD | The Attribute is captured whenever a page is loaded. |
ON_CLICK | The Attribute is captured once clicked or tapped. |
PARAMETER | The Attribute is captured for a query parameter. |
MXOCaptureType
The type of value to capture from an element.
public enum class MXOCaptureType {
ATTRIBUTE,
TEXT,
VALUE,
COOKIE,
}
Enum | Description |
---|---|
ATTRIBUTE | Name of the Attribute. |
TEXT | Captures a text. |
VALUE | Captures a Boolean value. |
COOKIE | Captures data from a cookie on the current page. |
MXOInteraction
Interactions are the key elements of the customer experience, representing the ongoing conversation between your customer and your organization at any of your Touchpoints. Interaction Points let you to capture customer Activity, capture customer input, and return optimized content to your customer during those interactions.
In a mobile app, an Interaction Point represents an individual screen or context.
public data class MXOInteraction(
public val value: URI,
)
Property | Type | Description |
---|---|---|
value | URI | The URI representation of the Interaction. |
MXOIntractionRequest
The Interaction request object for sending interaction data from the MXO SDK.
public data class MXOInteractionRequest(
public val interaction: MXOInteraction = MXOInteraction(URI.create("/")),
public val properties: Map<String, String>? = mapOf(),
)
Property | Type | Description |
---|---|---|
interaction | URI | The URI value containing the Interaction path. |
properties | Map<String, String> | Properties map to be sent with the Interaction. |
Create an instance using the Builder as shown below:
@JvmSynthetic
public inline fun mxoInteractionRequest(
initializer: MXOIntractionRequest.Builder.() -> Unit = { },
): MXOInteractionRequest
MXOIntractionResponse
MXO Interaction response data.
public data class MXOInteractionResponse(
public val interaction: MXOInteraction = MXOInteraction(URI.create("")),
public val tid: String? = null,
){
public val isSuccess: Boolean = true,
public val optimizationPoints: Set<MXOOptimizationPoint> = null,
public val captureActivityPoints: Set<MXOCaptureActivityPoint> = null,
public val captureAttributePoints: Set<MXOCaptureAttributePoint> = null,
}
Property | Type | Description |
---|---|---|
interaction | MXOInteraction | The interaction this response is for. |
tid | String? | The unique id for this user's interaction. |
isSuccess | Boolean | If the MXO request was successful. |
optimizationPoints | Set<MXOOptimizationPoint> | The MXO Interaction Response for Optimization Points. |
captureActivityPoints | Set<MXOCaptureActivityPoint> | The MXO Interaction Response for Activity Points. |
captureAttributePoints | Set<MXOCaptureAttributePoint> | The MXO Interaction Response for Attribute Points. |
MXOMimeType
Possible types of MXO Assets.
public enum class MXOMimeType {
JSON,
TXT,
HTML,
XML,
EXTERNAL,
UNKNOWN,
}
Enum | Description |
---|---|
JSON | The Asset of a json type. |
TXT | The Asset of a text type. |
HTML | The Asset of a html type. |
XML | The Asset of a xml type. |
EXTERNAL | The Asset of a external type. |
UNKNOWN | Unknown Asset type. |
MXOOptimizationPoint
MXO Interaction response data.
public data class MXOOptimizationPoint(
public val path: String? = null,
public val actions: Set<MXOAction> = emptySet(),
public val directives: MXOOptimizationPointDirectives? = null,
)
Property | Type | Description |
---|---|---|
path | String? | The location to optimize. |
actions | Set<MXOAction> | The set of MXO Actions available to take for the Optimization. |
directives | MXOOptimizationPointDirectives? | The position of the Optimization. |
MXOOptimizationPointDirectives
The position to place an Optimization.
public enum class MXOOptimizationPointDirectives {
REPLACE,
BEFORE,
AFTER,
}
Enum | Description |
---|---|
REPLACE | The Asset replaces the content area. |
BEFORE | The Asset is inserted before the content area. |
AFTER | The Asset is inserted after the content area. |
MXOProposition
Propositions are the products or services that you want to promote to customers. For example, a 0% balance transfer offer on credit cards.
Use Propositions to set up the long-term and short-term campaigns, offers, invitations, and parent-child hierarchies to use for your marketing initiatives.
public data class MXOProposition(
public val name: String? = null,
public val code: String? = null,
public val type: MXOPropositionType = MXOPropositionType.PRODUCT,
)
Property | Type | Description |
---|---|---|
name | String? | The proposition name. |
code | String? | The business code associated with the proposition. |
type | MXOPropositionType | The type of proposition. |
MXOPropositionType
The type of a proposition.
Products are typically items you can see and touch, such as computers, cars (or any of the parts of a car), credit cards, car insurance, mobile phones, and so on.
Services are typically provided for you by other people, such as customer service, support, and so on.
Products and services can have parent-child relationships. For example, a product such as a credit card might have other products nested below it, such as different credit card types like platinum, gold, silver, and prepaid.
public enum class MXOPropositionType {
PRODUCT,
SERVICE,
}
Enum | Description |
---|---|
PRODUCT | The product Proposition. |
SERVICE | The service Proposition. |
MXOResponseCode
The response code object containing the response code value. This is used as part of the MXOResponseCodeRequest
object. Response code values is sent to the MXO API as a property value.
public data class MXOResponseCode(
public val value: String,
)
Property | Type | Description |
---|---|---|
value | String | The response code string value. |
MXOResponseCodeRequest
The response code request object for sending the response code to the MXO SDK.
public data class MXOResponseCodeRequest(
public val interaction: MXOInteraction = MXOInteraction(URI.create("")),
public val responseCode: MXOResponseCode = MXOResponseCode(""),
)
Property | Type | Description |
---|---|---|
interaction | MXOInteraction | The URI value containing the Interaction path. |
responseCode | MXOResponseCode | Response code object containing the response code value. |
Create an instance using the Builder as shown below:
@JvmSynthetic
public inline fun mxoResponseCodeRequest(
initializer: MXOResponseCodeRequest.Builder.() -> Unit = { },
): MXOResponseCodeRequest