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,
)
PropertyTypeDescription
nameString?The name of the Action.
assetMXOAsset?The Asset for this Action.
propositionMXOProposition?The optional Proposition for this Action.
Note: For more information, see how to retrieve an Interaction response.

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,
)
PropertyTypeDescription
markupString?The language markup for presenting the Asset.
responsesSet<MXOAssetResponse>The optional responses for informing MXO of a user Interaction with the Asset.
mimeTypeMXOMimeTypeThe markup language type.
contentUrlURI?A remote location the Asset represents.
Note: For more information, see how to retrieve an Interaction response.

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,
)
PropertyTypeDescription
codeMXOResponseCode?The code to send to MXO when an Asset is responded to.
sentimentMXOAssetResponseSentimentThe type of response to track.
labelMXOAssetResponseLabel?The label to show if desired.
imageUrlURI?The image to load if desired.
targetUrlURI?The target URL to load if desired.
targetMXOAssetResponseTarget?The location the sentiment should send the user.
Note: For more information, see how to retrieve an Interaction response.

MXOAssetResponseLabel

Optional Label to display for an asset response.

public data class MXOAssetResponseLabel(
	public val value: String,
)
PropertyTypeDescription
valueStringThe label for the Asset.
Note: For more information, see how to retrieve an Interaction response.

MXOAssetResponseSentiment

This is how a user responded to an MXO Asset response.

public enum class MXOAssetResponseSentiment {
	POSITIVE, 
	NEUTRAL, 
	NEGATIVE, 
	UNKNOWN,
}
EnumDescription
POSITIVEThe positive tap on an Asset.
NEUTRALThe Asset is dismissed or ignored.
NEGATIVEThe Asset is rejected.
UNKNOWNUnknown response.
Note: For more information, see how to retrieve an Interaction response.

MXOAssetResponseTarget

The location of an MXO Asset response.

public enum class MXOAssetResponseTarget {
    	IN_APP, 
	EXTERNAL, 
	CONTEXT, 
	UNKNOWN,
}
EnumDescription
IN_APPThe Asset is targeted to the same app.
EXTERNALThe Asset is targeted to an external URL.
CONTEXTThe Asset is targeted to an Action context.
UNKNOWNUnknown response.
Note: For more information, see how to retrieve an Interaction 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,
)
PropertyTypeDescription
idString?The internal MXO id of the point.
pathString?The location of Activity to capture, such as a button click.
Note: For more information, see how to retrieve an Interaction response.

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,
)
PropertyTypeDescription
idString?The internal MXO id of the point.
pathString?The location of Attribute to capture, such as a button click.
elementTypeMXOCaptureElementType?The type of the element.
elementNameString?The name of the element.
elementAttributeNameString?The name of the element Attribute to capture.
captureDelayIntHow long to wait to capture the value.
captureTypeMXOCaptureType?The type of capture.
capturePhaseMXOCapturePhase?The lifecycle time to capture the value.
Note: For more information, see how to retrieve an Interaction response.

MXOCaptureElementType

The type of an element.

public enum class MXOCaptureElementType {
    	TEXT_FIELD,
    	CHECKBOX_RADIO,
    	DISPLAY_ELEM,
    	DROP_DOWN,
}
EnumDescription
TEXT_FIELDInput value for the text or search field.
CHECKBOX_RADIOInput value for the selected checkbox/radio button.
DISPLAY_ELEMDisplay value for the selected display element.
DROP_DOWNInput value for the selected dropdown list.
Note: For more information, see how to retrieve an Interaction response.

MXOCapturePhase

The phase in which to capture an Attribute.

public enum class MXOCapturePhase {
    	LOAD,
	ON_CLICK,
    	PARAMETER,
}
EnumDescription
LOADThe Attribute is captured whenever a page is loaded.
ON_CLICKThe Attribute is captured once clicked or tapped.
PARAMETERThe Attribute is captured for a query parameter.
Note: For more information, see how to retrieve an Interaction response.

MXOCaptureType

The type of value to capture from an element.

public enum class MXOCaptureType {
    	ATTRIBUTE,
    	TEXT,
    	VALUE,
    	COOKIE,
}
EnumDescription
ATTRIBUTEName of the Attribute.
TEXTCaptures a text.
VALUECaptures a Boolean value.
COOKIECaptures data from a cookie on the current page.
Note: For more information, see how to retrieve an Interaction response.

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,
)
PropertyTypeDescription
valueURIThe URI representation of the Interaction.
Note: For more information, see how to retrieve an Interaction response.

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(),
)
PropertyTypeDescription
interactionURIThe URI value containing the Interaction path.
propertiesMap<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
Note: For more information, see how to retrieve an Interaction response.

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,
}
PropertyTypeDescription
interactionMXOInteractionThe interaction this response is for.
tidString?The unique id for this user's interaction.
isSuccessBooleanIf the MXO request was successful.
optimizationPointsSet<MXOOptimizationPoint>The MXO Interaction Response for Optimization Points.
captureActivityPointsSet<MXOCaptureActivityPoint>The MXO Interaction Response for Activity Points.
captureAttributePointsSet<MXOCaptureAttributePoint>The MXO Interaction Response for Attribute Points.
Note: For more information, see how to retrieve an Interaction response.

MXOMimeType

Possible types of MXO Assets.

public enum class MXOMimeType {
    	JSON, 
	TXT, 
	HTML, 
	XML, 
	EXTERNAL, 
	UNKNOWN,
}
EnumDescription
JSONThe Asset of a json type.
TXTThe Asset of a text type.
HTMLThe Asset of a html type.
XMLThe Asset of a xml type.
EXTERNALThe Asset of a external type.
UNKNOWNUnknown Asset type.
Note: For more information, see how to retrieve an Interaction response.

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,
)
PropertyTypeDescription
pathString?The location to optimize.
actionsSet<MXOAction>The set of MXO Actions available to take for the Optimization.
directivesMXOOptimizationPointDirectives?The position of the Optimization.
Note: For more information, see how to retrieve an Interaction response.

MXOOptimizationPointDirectives

The position to place an Optimization.

public enum class MXOOptimizationPointDirectives {
    	REPLACE, 
	BEFORE, 
	AFTER,
}
EnumDescription
REPLACEThe Asset replaces the content area.
BEFOREThe Asset is inserted before the content area.
AFTERThe Asset is inserted after the content area.
Note: For more information, see how to retrieve an Interaction response

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,
)
PropertyTypeDescription
nameString?The proposition name.
codeString?The business code associated with the proposition.
typeMXOPropositionTypeThe type of proposition.
Note: For more information, see how to retrieve an Interaction response.

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,
}
EnumDescription
PRODUCTThe product Proposition.
SERVICEThe service Proposition.
Note: For more information, see how to retrieve an Interaction response.

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,
)
PropertyTypeDescription
valueStringThe response code string value.
Note: For more information, see how to send a response code.

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(""),
)
PropertyTypeDescription
interactionMXOInteractionThe URI value containing the Interaction path.
responseCodeMXOResponseCodeResponse 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
Note: For more information, see how to send a response cod.