Audience Manager custom binding

If you want to connect to the Core Service using an endpoint other than the default NetTcpBinding or wsHttpBinding bindings, you can create a custom binding. This topic provides an overview only. For more detailed information, refer to the Core Service documentation itself.

Core Service
The Core Service is an API that interacts with the Content Manager through a web service that uses the Windows Communication Foundation (WCF) standard. Audience Manager connects to the Content Manager through the Core Service. The following diagram shows a standard installation where an Audience Manager WCF client is installed on the same server as the Content Manager Server:
  • The Content Manager Server runs as a web application in Internet Information Services (IIS).
  • The Core Service runs in a virtual directory if you connect to it using HTTP (if you connect using NET.TCP, the Core Service runs as a Windows service).
  • Audience Manager also runs in a virtual directory within the Content Manager server web application.
Audience Manager default connectivity to the Core Service
Audience Manager connects to the Core Service via an endpoint. Audience Manager provides out-of-the-box endpoints for connecting to the Core Service using the NetTcpBinding or wsHttpBinding bindings which use respectively the net.tcp and http protocols to communicate with the Core Service.
Creating a custom binding for Audience Manager
If you want to connect to the Core Service using an endpoint other than the default NetTcpBinding or wsHttpBinding bindings, or if you want to specify your own binding properties for these protocols, you need to develop custom bindings and endpoints.
In web.config, in the <system.serviceModel> section, define an <endpoint> element:
<client>
	<endpoint name="amNetTcp" 
		address="net.tcp://ServerName.Domain:2660/CoreService/201701/netTcp" 
		binding="netTcpBinding" 
		bindingConfiguration="amNetTcp" 
		contract="AudienceManagerCoreServiceProxy.ISessionAwareCoreService" /> 
</client>

where:

  • name specifies the name of the endpoint
  • address specifies the URI where WCF clients can access this Core Service endpoint
  • binding specifies either a default binding such as netTcpBinding or a custom binding
  • bindingConfiguration specifies the name attribute of the binding element used to change the default values of a binding
  • contract specifies the interface that defines the contract. When you develop your own binding to connect to the Core Service for Audience Manager, you need to specify the following endpoint contract:
contract="AudienceManagerCoreServiceProxy.ISessionAwareCoreService"