Export (0) Print
Expand All
Ad
Bid
Expand Minimize

Target Data Object

Defines the types of targeting that you can use to target your ads to users. For example, you can target your ads based on the geographic location of the user, the day of the week, or the time of the day.

When adding or updating a target, at least one target type must be specified. When attempting to retrieve targets for a campaign or ad group, the Target element could be nil. For more information, see Default Target Settings.

<xs:complexType name="Target">
  <xs:sequence>
    <xs:element minOccurs="0" name="Age" nillable="true" type="tns:AgeTarget" />
    <xs:element minOccurs="0" name="Day" nillable="true" type="tns:DayTarget" />
    <xs:element minOccurs="0" name="DeviceOS" nillable="true" type="tns:DeviceOSTarget" />
    <xs:element minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q19:ArrayOfKeyValuePairOfstringstring" xmlns:q19="http://schemas.datacontract.org/2004/07/System.Collections.Generic" />
    <xs:element minOccurs="0" name="Gender" nillable="true" type="tns:GenderTarget" />
    <xs:element minOccurs="0" name="Hour" nillable="true" type="tns:HourTarget" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="IsLibraryTarget" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="Location" nillable="true" type="tns:LocationTarget" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elements

Element

Description

Data Type

Add

Update

Age

Targets ads to users within one or more age ranges.

AgeTarget

Optional

Optional

Day

Targets ads to run on specific days of the week.

System_CLiX_noteNote

The DayTimeTarget will combine the Day and Hour elements of this target, and is available in the new Target2 object.

Once you or another application set the DayTime element of a new Target2 object, then the Day and Hour elements of this Target object will be nil when retrieved. Any subsequent Day and Hour element updates via UpdateTargetsInLibrary will be accepted and overwrite a previously specified DayTime setting.

DayTarget

Optional

Optional

DeviceOS

Targets ads to serve on specific devices.

DeviceOSTarget

Optional

Optional

ForwardCompatibilityMap

The list of key and value strings for forward compatibility. This element can be used to avoid otherwise breaking changes when new elements are added in future releases.

Key

Value

Description

IsAdScheduleInNewFormat

The only possible read-only value is True.

If not True, this key and value pair will not be returned.

If True, the value indicates that DayTimeTarget for this target has been set, either through the Target2 object or another application such as the Bing Ads web application.

You should understand the potential impact to the Day and Hour elements. For more information, see DayTarget and HourTarget.

If the DayTimeTarget has not been set, this key and value pair will not be returned.

KeyValuePairOfstringstring array

Optional

Optional

Gender

Targets ads to men only or women only.

GenderTarget

Optional

Optional

Hour

Targets ads to run at specific times of the day.

System_CLiX_noteNote

The DayTimeTarget will combine the Day and Hour elements of this target, and is available in the new Target2 object.

Once you set the DayTime element of a new Target2 object, then the Day and Hour elements of this Target object will be nil when retrieved. Any subsequent Day and Hour element updates via UpdateTargetsInLibrary will be accepted and overwrite a previously specified DayTime setting.

HourTarget

Optional

Optional

Id

A system-generated identifier that identifies this target object.

long

Read-only

Required

IsLibraryTarget

Determines whether the target library contains this target object.

boolean

Read-only

Read-only

Location

Targets ads to users within a specific location; for example, users within a certain radius of your business or within a specific state.

LocationTarget

Optional

Optional

Name

The name of the target. The name can contain a maximum of 50 characters.

If you do not specify a target name, the operation generates one for you. However, you should always provide a name so you can easily identify the target if you call the GetTargetsInfoFromLibrary operation, which returns a list of target identifiers and names.

string

Optional

Optional

Requirements

CampaignManagementService.svc v9

Namespace: https://bingads.microsoft.com/CampaignManagement/v9

Community Additions

ADD
Show:
© 2014 Microsoft