Marketing Treatment Service

Logical Business Objects

CRM : Marketing : Marketing Treatment

Relationships

The following table describes how this service data object is related to other service data objects or business object services.

Relationship Type	Object or Service
Handles	Delivery Profile Parameter of a Marketing Supplier
Handles	Deprecated - Marketing Treatment
Handles	Delivery Profile of a Marketing Supplier
Handles	Marketing Treatment Product

getDlvProfile

A web service method that queries a single record of an Oracle Fusion Marketing Delivery Profile Object by ID.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
supplierProfileId	long	A required input parameter of the getDlvProfile web service method. It is the row ID of the delivery profile record you want to query for.

Response Payload

Element Name	Type	Description
result	Delivery Profile of a Marketing Supplier	The return value of the getDlvProfile web service method. It includes the full set of attributes of the record.

createDlvProfile

A web service method that creates Oracle Fusion Marketing Delivery Profile Object records.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
dlvProfile	Delivery Profile of a Marketing Supplier	A required input parameter of the createDivProfile web service method. The input Object includes the attribute values that the delivery profile record is created with.

Response Payload

Element Name	Type	Description
result	Delivery Profile of a Marketing Supplier	The return value of the createDivProfile web service method. It includes the full set of attributes of the record.

updateDlvProfile

A web service method that updates an Oracle Fusion Marketing Delivery Profile Object record.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
dlvProfile	Delivery Profile of a Marketing Supplier	A required parameter of the updateDivProfile web service method. The record matching the ID specified in this input delivery profile is updated with the corresponding input attribute values also.

Response Payload

Element Name	Type	Description
result	Delivery Profile of a Marketing Supplier	The return value of the updateDivProfile web service method. It includes the full set of attributes of the record.

deleteDlvProfile

A web service method that delete an Oracle Fusion Marketing Delivery Profile Object record.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
dlvProfile	Delivery Profile of a Marketing Supplier	A required input parameter of the deleteDivProfile web service method. The record matching the input attribute values specified in the delivery profile are deleted.

Response Payload

Element Name	Type	Description
result	void	The parameter is not applicable for the method deleteDlvProfile.

getTreatment

A web service method that queries a single record of an Oracle Fusion Marketing Treatment Object by ID.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
treatmentId	long	A required input parameter of the getTreatment web service method. It is the row ID of the treatment record you want to query for.

Response Payload

Element Name	Type	Description
result	Marketing Treatment	The return value of the getTreatment web service method. It includes the full set of attributes of the record.

createTreatment

A web service method that creates Oracle Fusion Marketing Treatment Object records.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
treatment	Marketing Treatment	A required input parameter of the createTreatment web service method. The input object includes the attribute values that the treatment record is created with.

Response Payload

Element Name	Type	Description
result	Marketing Treatment	The return value of the createTreatment web service method. It includes the full set of attributes and child entities of the record.

updateTreatment

A web service method that updates an Oracle Fusion Marketing Treatment Object record.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
treatment	Marketing Treatment	An input parameter of the updateTreatment web service method. The record matching the ID specified in this input treatment is updated with the corresponding input attribute values also.

Response Payload

Element Name	Type	Description
result	Marketing Treatment	The return value of the updateTreatment web service method. It includes the full set of attributes of the record.

deleteTreatment

A web service method that delete an Oracle Fusion Marketing Treatment Object record.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
treatment	Marketing Treatment	A required input parameter of the deleteTreatment web service method. The record matching the input attribute values specified in the treatment are deleted.

Response Payload

Element Name	Type	Description
result	void	The parameter is not applicable for the method deleteTreatment.

getDfltObjAttrHints

A web service method to retrieve user interface hints, such as the service data object label and Object attribute labels, for the specified service data object and locale. As a prerequisite, invoke the getEntityList operation defined on this service to get the list of possible values for the viewName request payload element.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
viewName	string	The service view usage name, an internal name for the service data object. Specify the value of the <name> element from the getEntityList operation response payload.
localeName	string	The locale to use when evaluating locale-based user interface hints. The localeName is in ISO 639-1 format.

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/adf/svc/types/}ObjAttrHints	The label and user interface hints for the specified service data object and its attributes in a name-value pair format.

getServiceLastUpdateTime

A web service method that returns the date and time when the schema files referenced in the service definition last changed.

Life Cycle Status: Active

Request Payload

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/adf/svc/types/}dateTime-Timestamp	The date and time when the service definition was last updated. The parameter is present in ISO 8601 format.

getEntityList

A web service method to get the list of service data objects defined on this service.

Life Cycle Status: Active

Request Payload

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/adf/svc/types/}ServiceViewInfo	A list of service data objects defined on this service. For each service data object, the result includes the QName, internal name, and Boolean values indicating whether create, update, merge, and delete operations can be performed on the Object.

Security

The following tables list the privileges required to perform the service operations, and the duty roles that each privilege is granted to.

Service Operations to Privileges Mapping

Operation Name	Privilege Code	Privilege Name	Privilege Description
All Operations	MKT_CREATE_MARKETING_TREATMENT_PRIV	Create Marketing Treatment	Allows creating marketing treatments that provide channel specific marketing promotions, message, and fulfillment instructions for campaigns.
All Operations	MKT_MANAGE_MARKETING_TREATMENT_PRIV	Manage Marketing Treatment	For internal use only. Allows web services management of marketing treatments.
All Operations	MKT_VIEW_MARKETING_TREATMENT_PRIV	View Marketing Treatment	Allows viewing marketing treatments that provide channel specific marketing promotions, message, and fulfillment instructions for campaigns.
All Operations	MKT_CREATE_SALES_CAMPAIGN_PRIV	Create Sales Campaign	Allows creating sales campaigns and tracking of customer responses. A sales campaign is an e-mail promoting products or events to specific customers, that can include personalized information and links where the customer can respond.
All Operations	MKT_UPDATE_SALES_CAMPAIGN_PRIV	Update Sales Campaign	Allows updating sales campaigns and tracking of customer responses. A sales campaign is an e-mail promoting products or events to specific customers, that can include personalized information and links where the customer can respond.

Privileges to Duty Roles Mapping

Privilege Code	Granted to Duty Role Code	Granted to Duty Role Name	Granted To Duty Role Description
MKT_VIEW_MARKETING_TREATMENT_PRIV	ORA_MKL_SALES_LEAD_QUALIFIER_JOB	Sales Lead Qualifier	Identifies, generates and qualifies sales leads and ensures that they are successfully closed within established time objectives. Includes the ability to deliver reports, ensure a healthy sales pipeline volume, help shorten sales cycles, shape lead generation strategies, and provide effective guidance to the rest of the lead qualification team. Other supporting roles include territory development, event and webinar strategies.
MKT_VIEW_MARKETING_TREATMENT_PRIV	ORA_MKT_MARKETING_ANALYSIS_DUTY	Marketing Analysis	Analyzes marketing effectiveness across the enterprise by viewing detailed marketing campaign, list, segment, and treatment information from the audience and campaign work areas.
MKT_VIEW_MARKETING_TREATMENT_PRIV	ORA_MKT_MARKETING_CAMPAIGN_MANAGEMENT_DUTY	Marketing Campaign Management	Manages secured marketing campaigns from planning to design and execution. Defines and maintains secured marketing treatments, lists, segments, and content.
MKT_UPDATE_SALES_CAMPAIGN_PRIV	ORA_MKT_PERSONAL_CAMPAIGN_MANAGEMENT_DUTY	Personal Campaign Management	Manages secured personal campaigns used to promote products or events to specific customers.
MKT_MANAGE_MARKETING_TREATMENT_PRIV	ORA_MKT_MARKETING_CAMPAIGN_MANAGEMENT_DUTY	Marketing Campaign Management	Manages secured marketing campaigns from planning to design and execution. Defines and maintains secured marketing treatments, lists, segments, and content.
MKT_CREATE_MARKETING_TREATMENT_PRIV	ORA_MKT_MARKETING_CAMPAIGN_MANAGEMENT_DUTY	Marketing Campaign Management	Manages secured marketing campaigns from planning to design and execution. Defines and maintains secured marketing treatments, lists, segments, and content.
MKT_CREATE_SALES_CAMPAIGN_PRIV	ORA_MKT_PERSONAL_CAMPAIGN_MANAGEMENT_DUTY	Personal Campaign Management	Manages secured personal campaigns used to promote products or events to specific customers.

Duty Roles to Duty or Job Roles Mapping

Duty Role Code	Granted to Duty or Job Role Code	Granted to Duty or Job Role Name	Granted To Duty or Job Role Description
ORA_MKL_SALES_LEAD_QUALIFIER_JOB	ORA_ZCA_ACCESS_GROUPS_ENABLEMENT_DUTY	Access Groups Enablement	Enables the Access Groups functionality.
ORA_MKL_SALES_LEAD_QUALIFIER_JOB	ORA_MKL_LEAD_REGISTRATION_PROCESSING_DUTY	Lead Registration Processing	Reviews, accepts, and rejects sales lead registrations. Includes the ability to view sales lead details and update internal attributes.
ORA_MKL_SALES_LEAD_QUALIFIER_JOB	ORA_ZCM_MKTG_SALES_PARTY_MANAGEMENT_DUTY	Marketing Sales Party Management	Manages creation and maintenance of the sales organizations and consumers for internal marketing users. Additional duties include viewing of appointments, interactions, and customer contacts.
ORA_MKL_SALES_LEAD_QUALIFIER_JOB	ORA_HZ_RESOURCE_ABSTRACT	Resource	Identifies the person as front office personnel.
ORA_MKL_SALES_LEAD_QUALIFIER_JOB	ORA_MKL_SALES_LEAD_QUALIFICATION_DUTY	Sales Lead Qualification	Qualifies sales leads to determine the sales readiness of the lead.
ORA_MKL_SALES_LEAD_QUALIFIER_JOB	ORA_ZCM_SALES_PARTY_ADMINISTRATION_DUTY	Sales Party Administration	Manages named sales accounts, sales account import scheduler and the flagging of existing accounts. Additional duties include managing sales parties, functional setups, customer center objects, and relationship information inquiries.