Export (0) Print
Expand All
Ad
Bid
Expand Minimize

Target2 Data Object

System_CLiX_note Note

Currently this feature is only available for pilot participants, and will be generally available for all advertisers in Q3 2014.

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.

This object includes the DayTimeTarget and LocationTarget2 objects, which are not included in the legacy Target object.

The following service operations are reserved for working with Target2 objects.

The following service operations may be used with either Target or Target2 objects.

The following service operations are reserved for working with the legacy Target objects.

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 Target2 element could be nil. For more information, see Default Target Settings.

<xs:complexType name="Target2">
  <xs:sequence>
    <xs:element minOccurs="0" name="Age" nillable="true" type="tns:AgeTarget" />
    <xs:element minOccurs="0" name="DayTime" nillable="true" type="tns:DayTimeTarget" />
    <xs:element minOccurs="0" name="DeviceOS" nillable="true" type="tns:DeviceOSTarget" />
    <xs:element minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q26:ArrayOfKeyValuePairOfstringstring" xmlns:q26="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="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:LocationTarget2" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Network" nillable="true" type="tns:NetworkTarget" />
  </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

DayTime

Targets ads to run on specific days and hours of the week.

System_CLiX_importantImportant

If you had previously set up your legacy Target object with separate Day and Hour elements, you can get the Target2 object version and it will include the equivalent DayTimeTargetBid objects. For example if you had set the target's DayTargetBid to Monday and its HourTargetBid to ThreeAMToSevenAM, this DayTimeTarget will include seven DayTimeTargetBid objects (one for each day of the week) with FromHour set to 3; FromMinute set to 0; ToHour set to 7; ToMinute set to 0.

The bid adjustment of the DayTimeTargetBid would be set to the multiplied union of the DayTargetBid and HourTargetBid. For example if the Day bid adjustment is 10 and the Hour bid adjustment is 10, the multiplied percentage bid adjustment is 21. For more information about multiplicative bid adjustments, see Bid Adjustments.

Once you or another application set the DayTime element of this Target2 object, then the Day and Hour elements of the legacy 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.

DayTimeTarget

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.

System_CLiX_noteNote

Forward compatibility changes will be noted here in future releases. There are currently no forward compatibility changes for the Target2 object.

KeyValuePairOfstringstring array

Optional

Optional

Gender

Targets ads to men only or women only.

GenderTarget

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.

LocationTarget2

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

Network

Targets ads to users within a specific search network.

System_CLiX_noteNote

Reserved for future use.

NetworkTarget

Optional

Optional

Requirements

CampaignManagementService.svc v9

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

Community Additions

ADD
Show:
© 2014 Microsoft