MedalliaMXO APIs
Automatic API
Get or set the current automatic Interaction tracking configuration using the following:
@property (class, nonatomic, nullable) MXOAutomaticInteractionTrackingConfiguration *automaticInteractionTrackingConfiguration;
To retrieve an automatic Interaction, use the function below:
+ (nullable MXOInteraction *) getAutomaticInteraction:
(UIViewController *)viewController
);
Property | Type | Description |
---|---|---|
viewController | UIViewController | The View Controller to get an automatic Interaction for. |
Automatic Interaction assignment API
Assign an automatic Interaction to a View to be used instead of using the automatic path using the following:
+ (BOOL)assignAutomaticInteraction:
(MXOAutomaticInteractionAssignment *)assignInteraction
error:(NSError *__autoreleasing _Nullable * _Nullable)error
);
Property | Type | Description |
---|---|---|
assignInteraction | MXOAutomaticInteractionAssignment | The Interaction to assign to automatic tracking. |
error | NSError | Used to handle errors. |
Automatic Interaction exclusion API
Exclude a View from automatically being tracked as an Interaction using the following:
+ (BOOL)excludeAutomaticInteraction:(MXOAutomaticInteractionExclusion *)excludeInteration
error:(NSError *__autoreleasing _Nullable * _Nullable)error
);
Parameter | Type | Description |
---|---|---|
excudeInteraction | MXOAutomaticInteractionExclusion | The Interaction to exclude from tracking. |
error | NSError | Used to handle errors. |
Automatic Interaction subscription API
Subscribe to automatic Interaction request responses using the following:
@protocol MXOAutomaticInteractionSubscription;
Use the convenience function to subscribe to automatic Interaction tracking:
+ (nullable id<MXOAutomaticInteractionSubscription>)subscribeToAutomaticInteraction:(MXOAutomaticInteractionSubscriber *)subscriber
error:(NSError *__autoreleasing _Nullable * _Nullable)error
);
Parameter | Type | Description |
---|---|---|
subscriber | MXOAutomaticInteractionSubscriber | The subscriber for an Interaction. |
error | NSError | Used to handle errors. |
Configuration API
Get or set the MXO SDK configuration using the following:
@property (class, nonatomic, nullable) MXOConfiguration *configuration;
Identity APIs
Retrieve the TID of the current user using the following:
+ (nullable NSString *)getTid;
Clear the current user's TID from the SDK using the following:
+ (void)clearTid;
This feature enables the SDK to notify MXO when multiple user's may access the same app on the same device.
Identity Transfer API
Programmatic API to process a deep link to an app that has had the MXO Orchestration Plugin disabled or has had the identity transfer disabled therefore preventing the automatic sending of deep link parameters to MXO.
Get or set the MXO SDK identity transfer configuration using the following:
@property (class, nonatomic, nullable) MXOIdentityTransferConfiguration *identityTransferConfiguration;
Process a URL deep link using the function below:
+ (BOOL)processDeepLink:(NSURL *)url
error:(NSError *__autoreleasing _Nullable * _Nullable)error
);
Parameter | Type | Description |
---|---|---|
url | NSURL | The URL to process. |
error | NSError | Used to handle errors. |
Generate a URL with a tid
query parameter using the function below:
+ (nullable NSURL *)generateIdentityTransferUrl:(NSURL *)url
error:(NSError *__autoreleasing _Nullable * _Nullable)error;
Parameter | Type | Description |
---|---|---|
url | NSURL | The URL to generate. |
error | NSError | Used to handle errors. |
Interaction APIs
Send Interactions to MXO using the following:
+ (BOOL)sendInteraction:(MXOInteractionRequest *)request
error:(NSError *__autoreleasing _Nullable * _Nullable)error
);
Parameter | Type | Description |
---|---|---|
request | MXOInteractionRequest | The Interaction request to be sent. |
error | NSError | Used to handle errors. |
Send Properties to MXO using the following:
+ (BOOL)sendProperties:(MXOInteractionRequest *)request
error:(NSError *__autoreleasing _Nullable * _Nullable)error
);
Parameter | Type | Description |
---|---|---|
request | MXOInteractionRequest | The Interaction request to be sent. |
error | NSError | Used to handle errors. |
Send response code to MXO using the following:
+ (BOOL)sendInteractionResponseCode:(MXOResponseCodeRequest *)request
error:(NSError *__autoreleasing _Nullable * _Nullable)error
);
Parameter | Type | Description |
---|---|---|
request | MXOResponseCodeRequest | The response code to be sent. |
error | NSError | Used to handle errors. |
Generate a URL for outbound link tracking using the function below:
+ (BOOL)sendInteractionForOutboundLink:(NSURL *)link
error:(NSError *__autoreleasing _Nullable * _Nullable)error
);
Parameter | Type | Description |
---|---|---|
link | URL | The URL for outbound link tracking. |
error | NSError | Used to handle errors. |
Process the response returned from sending an Interaction using the following:
+ (BOOL)processResponse:(MXOInteractionResponse *)response
error:(NSError *__autoreleasing _Nullable * _Nullable)error
);
Parameter | Type | Description |
---|---|---|
response | MXOInteractionResponse | The Interaction response to process. |
error | NSError | Used to handle errors. |
Location API
Inform the MXO SDK about location details using the following:
+ (BOOL)processLocation:(CLLocation *)location
error:(NSError *__autoreleasing _Nullable * _Nullable)error
);
Parameter | Type | Description |
---|---|---|
location | CLLocation | The device location to send to MXO. |
error | NSError | Used to handle errors. |
Logging API
Get or set the MXO SDK logging configuration using the following:
@property (class, nonatomic, nullable) MXOLoggingConfiguration *loggingConfiguration;
MXOErrorCode
An MXO SDK Runtime exception.
typedef NS_ERROR_ENUM(MXOErrorDomain, MXOErrorCode) {
MXOErrorSDKError = 9000,
MXOErrorAPIError,
MXOErrorInvalidRequestError,
MXOErrorInvalidParamError,
MXOErrorInvalidSubscriberError
};
Enum | Description |
---|---|
MXOErrorSDKError | Used to specify that an SDK error was encountered. |
MXOErrorAPIError | Used to specify that an API error was encountered. |
MXOErrorInvalidRequestError | Used to specify that an invalid request error was encountered. |
MXOErrorInvalidParamError | Used to specify that an invalid param error was encountered. |
MXOErrorInvalidSubscriberError | Used to specify that an invalid subscriber error was encountered. |
Opt Out API
Get or set the optout
settings for compliance with a user's will to be tracked or not using the following:
open class var optOutConfiguration: MXOOptOutConfiguration?
Version API
+ (NSString *)getVersion;