|Oracle® Communications Marketing and Advertising Integration Guide
Part Number E20559-01
Oracle Communications Marketing and Advertising offers multiple points of integration for external applications and services that are a part of operator environments. This document provides a description of those integration points.
There are seven main areas that support integration in this product:
To use the Marketing and Advertising Web services, you must deploy the Web service Enterprise Archive (EAR) file, ocma-WebServiceName-ear.ear, in the Oracle WebLogic Server container. By default, the EAR file for each Web service is not deployed by the Marketing and Advertising installation program (except for the Basic Collocated domain configuration).
The EAR file can be found in Oracle_Home /ocma_5.1/applications. You should also have set up appropriate WS-Security for the Web services, using the Administrative console. For more information on deploying applications contained in EAR files, see the Administration Console Online Help at
For information on setting up WS-Security in Oracle WebLogic Server, see:
Oracle WebLogic Server Securing WebLogic Web Services
Oracle WebLogic Server Understanding WebLogic Security
Web Services Security specifications
You can get the WSDL for the Web service either from the WEB-INF directory in the OcmaWebServiceName.war file archived in the ocma-WebServiceName-ear.ear file or from
port point to a running instance of the Web tier of Marketing and Advertising. Determine the
WebServiceName using the WebLogic Administration console.
The following Web services provided with Marketing and Advertising handle common system operations. The Account Manager Web service is used to create and manage organizations and users for the application. Four campaign-related Web service operations are provided for campaign management. The Statistics Manager Web service is used to query statistical information about campaigns. For additional information about each Web service see:
Note:The.ear file that provides these web services,
ocma-ws-ear.ear,is deployed by default only in the Basic collocated domain configuration. In other domain types, it must be deployed manually. The ear file can be found in
<Oracle_Home>/ocma_5.1/applications. For more information on deploying applications in Oracle WebLogic Server, see Administration Console Online Help at
Marketing and Advertising organizations and users can be created using the GUI by system owners and ad service providers, but it may often be useful to integrate these activities into business workflows. The Account Manager Web service allows you to create and manage organizations and users. For more information on this Web service, see "Using the Account Manager Web Service".
For additional information about organizations and users in Marketing and Advertising see Oracle Communications Marketing and Advertising Users and User Organizations in the Oracle Communications Marketing and Advertising Concepts Guide.
Connection configurations act as the messaging pipelines through which campaign messages flow. The connection configuration Web service can create, list and delete connection configurations in Marketing and Advertising. For more information on this Web service, see "Using Web Services to Create and Manage Campaigns".
For additional information about connection configurations in Marketing and Advertising see Connection Configuration in the Oracle Communications Marketing and Advertising Concepts Guide.
A campaign consists of ad content, created by advertisers, and a container for that content called a campaign space. The campaign space, created by ad space owners, is the entity in which ad content is delivered to subscribers. Executing a campaign is a multi-step process with different organizations contributing to the success of the campaign.
Campaign activities can be executed using a set of campaign management Web services. For more information regarding the users, entities and procedures involved in creating and executing a campaign see Oracle Communications Marketing and Advertising Concepts Guide.
The campaign manager Web service creates new campaigns and ad content. This Web service also deletes campaigns and ad content, lists campaigns, campaign categories, subscriber lists and ad content and stops campaigns. For more information on the campaign manager Web service, see "The Campaign Manager Web Service"
The Campaign Space Approval Manager Web service approves or rejects campaign spaces. For more information on the Campaign Space Approval Manager Web service, see "The Campaign Space Approval Manager Web Service".
The Campaign Space Manager Web service creates and manages campaign spaces and also provides additional information related to campaign spaces. For more information on the Campaign Space Manager Web service, see "The Campaign Space Manager Web Service".
Campaign statistical information available in the Marketing and Advertising Web client can also be obtained using the Statistics Manager Web service. Statistical campaign information is valuable for reporting purposes and for determining the success of campaigns.
Organizations that make use of external reporting or dashboard applications may query Marketing and Advertising using the Statistics Manager Web service for campaign information in various formats. For more information on this Web service, see "Using Web Services to Query Campaign Statistics"
For additional information about the statistical information available in Marketing and Advertising see the Statistics section in the Oracle Communications Marketing and Advertising Entities chapter of Oracle Communications Marketing and Advertising Concepts Guide.
Ad content stored in Marketing and Advertising can be retrieved by external applications via the Ad Server Provider Web service for targeted advertising based on Open Mobile Alliance (OMA) Mob-Ad specifications. Marketing and Advertising functions as an ad content server concurrently receiving and tracking campaign statistics generated by an external application. For information on using Marketing and Advertising as a Mob-Ad server see "Using Oracle Communications Marketing and Advertising as an Ad Server".
Organizations utilizing Siebel Enterprise Marketing can integrate with Marketing and Advertising. In such an integration, Siebel delivers marketing offers/campaigns over Web service to Marketing and Advertising for execution. For information on integrating these two applications see "Integrating with Siebel Enterprise Marketing Suite".
Marketing and Advertising queries and displays visual map information available from the Oracle Fusion MapViewer application Web service when integrated. Mapping data can be used in configuring location-based campaigns in a visual manner instead of providing text coordinate data. For information on using the Oracle MapViewer with Marketing and Advertising see "Integrating with Oracle Map Viewer"
Marketing and Advertising can deliver real-time chargeable event information to Oracle Business Activity Monitoring (BAM). BAM gives business executives the ability to monitor their enterprise in real-time by supporting the building of real-time operational dashboards, monitoring and alerting applications over the Web. To see more about integrating with Oracle BAM, see "Integrating with Oracle Business Activity Monitoring".
Marketing and Advertising can produce charging detail records (CDRs) in Diameter Rf format for use with Oracle Communications Billing and Revenue Management or other charging systems that accept Diameter Rf requests. For more information on integrating with billing systems, see "Integrating with Oracle Communications Billing and Revenue Management".
Service operators personalize campaigns and protect their subscribers from unwanted intrusion using Marketing and Advertising integration to subscriber information data sources. Marketing and Advertising provides a highly configurable implementation based on LDAPv3 and Oracle Enterprise Database functionality. Marketing and Advertising also provides a Subscriber Information SPI, to allow operators to create implementations optimized for whatever data sources they wish to use. For more information on the Subscriber Information SPI, see .