RemarketingList Data Object - Campaign Management

Defines a remarketing list.

Tip

For an implementation overview, see the Universal Event Tracking technical guide.

Note

Microsoft Advertising will automatically generate similar audiences for remarketing lists if you are a pilot participant. You cannot create or edit the similar audience for a remarketing list. Having said that, you can add and delete similar remarketing list associations and exclusions. If you delete the source remarketing list, then the similar audience will also be deleted. If a similar audience is associated with a campaign or ad group, then you cannot delete the source remarketing list. See SimilarRemarketingList for more details.

Syntax

<xs:complexType name="RemarketingList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="Rule" nillable="true" type="tns:RemarketingRule" />
        <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

Element Description Data Type
Rule A rule includes conditions used to determine who to add to your remarketing list.

You can choose one of the four types of rules to target different audiences: CustomEventsRule, PageVisitorsRule, PageVisitorsWhoDidNotVisitAnotherPageRule, and PageVisitorsWhoVisitedAnotherPageRule.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed. If you want to keep any of the previous rule items, then you must explicitly set them again during update. You can choose to change the type of rule during update.
RemarketingRule
TagId The Microsoft Advertising identifier of the Universal Event Tracking (UET) tag that is used with the remarketing list.

Before you take a dependency on the tag ID, please note that the UET tag can be shared with or from another customer. Shared UET tags and audiences are only available for pilot customers. For an overview of sharing audiences and UET tags in a customer hierarchy, see the Share Audiences and UET Tags technical guide.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.
long

The RemarketingList object has Inherited Elements.

Inherited Elements

Inherited Elements from Audience

The RemarketingList object derives from the Audience object, and inherits the following elements. The descriptions below are specific to RemarketingList, and might not apply to other objects that inherit the same elements from the Audience object.

Element Description Data Type
AudienceNetworkSize The total number of people who are active members of this audience in the Audience network. This gives you an idea of how many Audience network users you can target.

The audience needs to have at least 300 people before Microsoft Advertising will use it for optimizations.

Add: Read-only
Update: Read-only
long
CustomerShare Determines the list of customers and accounts that share the audience. Details include audience association counts.

Shared UET tags and audiences are only available for pilot customers. For an overview of sharing audiences and UET tags in a customer hierarchy, see the Share Audiences and UET Tags technical guide.

Add: Optional
Update: Optional. If no value is set for the update, this setting is not changed. Set this element to null or empty to retain any existing customer account shares. To remove all customer account shares, set the CustomerAccountShares element of the CustomerShare object to null or empty. To remove a subset of customer account shares, specify the customer account shares that you want to keep in the CustomerAccountShares element of the CustomerShare object.
CustomerShare
Description The description of the audience. Use a description to help you remember what audience you are targeting.

The description can contain a maximum of 1,024 characters.

Add: Optional
Update: Optional. If no value is set for the update, this setting is not changed.
string
ForwardCompatibilityMap The list of key and value strings for forward compatibility to avoid otherwise breaking changes when new elements are added in the current API version.

Forward compatibility changes will be noted here in future releases. There are currently no forward compatibility changes for the Audience object.
KeyValuePairOfstringstring array
Id The Microsoft Advertising identifier of the audience.

Add: Read-only
Update: Required and read-only
long
MembershipDuration When you create an audience, you can specify how far back in time Microsoft Advertising should look for actions that match your audience definition.

The mimimum duration is 1 day and the maximum duration allowed is 180 days.

Add: Optional. If not specified, the membership duration will be set to 30 by default.
Update: Optional. If no value is set for the update, this setting is not changed.
int
Name The name of the audience. The name can contain a maximum of 128 characters.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.
string
ParentId The Microsoft Advertising identifier of the account or customer.

If the Scope is set to Account, this is the account ID, and otherwise it is the customer ID.

Add: Required
Update: Read-only. You cannot change the parent ID.
long
Scope Scope defines what accounts can use this audience.

If scope is set to Account, the audience can only be associated with campaigns and ad groups in one account i.e., via the ParentId. If scope is set to Customer, the audience can be associated with campaigns and ad groups in all of the customer's accounts.

Add: Required
Update: Optional. You can change the scope from Account to Customer, but you cannot change the scope from Customer to Account.
EntityScope
SearchSize The total number of people who are active members of this audience in the Search network. This gives you an idea of how many search users you can target.

The audience needs to have at least 300 people before Microsoft Advertising will use it for optimizations.

This property will be nil or empty for up to 24 hours while the audience is being built, for example if you add or update the remarketing list membership duration, rule, or tag identifier.

This property will be nil or empty if the UET tag associated with the remarketing list has a status of Unverified or Inactive, because the remarketing list can't receive the customer information from your website that it needs to build the list.

Add: Read-only
Update: Read-only
long
SupportedCampaignTypes The list of campaign types that support this audience.

Supported values are Audience, DynamicSearchAds, Search, and Shopping. New campaign types might be added in the future, so you should not take any dependency on a fixed set of values.

Add: Read-only
Update: Read-only
string array
Type The type of the audience. This value is RemarketingList when you retrieve a remarketing list audience. For more information about audience types, see the Audience Data Object Remarks.

Add: Read-only
Update: Read-only
AudienceType

Requirements

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