Siebel Marketing Installation and Administration Guide > Installing and Configuring Email Marketing > SOAP Calls for Marketing >

getCounts Method

The getCounts method generates the count numbers for either a segment or a segment tree. Thus, the segmentPath element must be specified in the getCounts element when getCounts is performed on a segment. Otherwise, the treePath element must be specified in the getCounts element when getCounts is performed on a segment tree. Anything else results in an error.

API Definition

<xsd:element name="getCounts">
   <xsd:complexType>
      <xsd:sequence>
         <xsd:element name="segmentPath" type="xsd:string" minOccurs="0" maxOccurs="1" />
         <xsd:element name="treePath" type="xsd:string" minOccurs="0" maxOccurs="1" />
         <xsd:element name="segmentationOptions" type="sawsoap:SegmentationOptions" minOccurs="0" maxOccurs="1" />
         <xsd:element name="sessionID" type="xsd:string" minOccurs="0" maxOccurs="1" />
      </xsd:sequence>
   </xsd:complexType>
</xsd:element>

<xsd:complexType name="SegmentationOptions">
   <xsd:sequence>
      <xsd:element name="removeCacheHits" type="xsd:boolean" default="false" minOccurs="0" maxOccurs="1" />
      <xsd:element name="countOverride" type="sawsoap:OverrideType" default="Default" minOccurs="0" maxOccurs="1" />
      <xsd:element name="cacheOverride" type="sawsoap:OverrideType" default="Default" minOccurs="0" maxOccurs="1" />
      <xsd:element name="samplingFactor" type="xsd:decimal" default="100" minOccurs="0" maxOccurs="1" />
   </xsd:sequence>
</xsd:complexType>

Valid Usage Scenarios

Calculates the count numbers for the segment.

<getCounts>
   <segmentPath>[path to the segment]</segmentPath>
   <segmentationOptions>
      <countOverride>All</countOverride>
   </segmentationOptions>
</getCounts>

Calculates the count numbers for the segment tree.

<getCounts>
   <treePath>[path to the segment tree]</treePath>
   <segmentationOptions>
      <countOverride>All</countOverride>
   </segmentationOptions>
</getCounts>

Usage Options

Segmentation options are used by getCounts to override the default options specified for the segment or segment tree in Marketing Analytics. The usage options for the GetCounts operation are count override, remove cache hits, and sampling factor. These options are specified within the segmentationOptions element.

countOverride

• All
• Default (default value)
• None

The countOverride value must be set to "All" to execute getCounts SOAP method. "All" specifies that count numbers are calculated for all criteria blocks. Otherwise executing getCounts results in an error.

removeCacheHits

• false (default value)
• true

Usually cache entries are refreshed with the latest information when cache entries are expired or does not exist. But set removeCacheHits to true for getCounts to ensure that you query against the most current data. This is achieved by removing all existing cache entries that contain count information for the target segment or segment tree and repopulating the cache with new count number entries calculated by getCounts.

samplingFactor

• 100 (default value)
• 0 to 100

The getCounts calculates the count number of criteria blocks against a subset of the data determined by the samplingFactor value. The default value of 100 determines that the count number is calculated against the entire data set. Set the samplingFactor to indicate the size of the data set for calculating counts.