CustomerShare Data Object - Campaign Management

Defines a shareable audience or UET tag that a customer owns.

Tip

For an overview of sharing audiences and UET tags in an account hierarchy, see the Share Audiences and UET Tags technical guide.

Syntax

<xs:complexType name="CustomerShare" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CustomerAccountShares" nillable="true" type="tns:ArrayOfCustomerAccountShare" />
    <xs:element minOccurs="0" name="OwnerCustomerId" nillable="true" type="xs:long" />
  </xs:sequence>
</xs:complexType>

Elements

The CustomerShare object has the following elements: CustomerAccountShares, OwnerCustomerId.

Element Description Data Type
CustomerAccountShares Determines the list of customers and accounts that share the audience or UET tag. Details include audience association counts.

When the audience or UET tag has not yet been shared, this element will be nil or empty. Once an audience or UET tag is shared, a CustomerAccountShare object is returned for each customer that can use the share, including one list item for the owner.

Add: Required
Update: Optional. Once you create this CustomerShare object, the existing CustomerAccountShare list will be removed or replaced. To remove all existing customer account shares create this CustomerShare object and set the CustomerAccountShares element to nil. To replace or append to the list of customer account shares, create this CustomerShare object and assign to the CustomerAccountShares element a new list of CustomerAccountShare objects, including any previous customer account shares that you want to retain. To retain all of the existing customer account shares, set the element that uses this CustomerShare object to nil. For example set the CustomerShare element of a RemarketingList to nil if you do not want to update any of the customer account shares.
CustomerAccountShare array
OwnerCustomerId The customer who owns the share.

Add: Read-only
Update: Read-only
long

Requirements

Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Used By

Audience
UetTag