Target an ad group or campaign toward specific categories by using the following steps.

1. Create an instance of the object that represents the desired target, and then assign it to one of the elements of the Target object. For example, to target a specific age ranges, create an instance of the AgeTarget object, specify the target age ranges and incremental bid percentages in the Bids element, and then use the AgeTarget object as the value for the Target.Age element. The following target types are available:
   
   • AgeTarget Data Object
     
   • BehavioralTarget Data Object
     
   • DayTarget Data Object
     
   • GenderTarget Data Object
     
   • HourTarget Data Object
     
   • LocationTarget Data Object
     
   • SegmentTarget Data Object
     
2. When the Target object contains your target bids, call the AddTargetsToLibrary service operation to add the Target object to your library. Preserve the target identifier that is returned by the AddTargetsToLibrary operation.
   
3. To associate the target with an ad group, call the SetTargetToAdGroup service operation, passing the ad group identifier and the target identifier.
   
4. To associate the target with a campaign, call the SetTargetToCampaign service operation, passing the campaign identifier and the target identifier.
   

An ad group or campaign can have only one target association at a time. If you call one of these service operations for an ad group or campaign that already has a target association, an error occurs. You must remove the association first as shown in Deleting Targets.

You can obtain information about the targets that are in your library by using the GetTargetsInfoFromLibrary service operation. This operation returns an array of TargetInfo objects for all targets in your library. The TargetInfo object contains only basic information, such as the target identifier, for the target.

To obtain more detailed information about one or more targets, use the GetTargetsByIds service operation. This operation takes an array of target identifiers and returns the full set of information about the specified targets.

To obtain the targets that are associated with one or more ad groups, use the GetTargetsByAdGroupIds service operation. Similarly, use the GetTargetsByCampaignIds service operation to get the targets that are associated with one or more campaigns.

To update one or more target bids for an ad group or campaign, call the UpdateTargetsInLibrary service operation. This operation will update the target in-place, so you don't have to modify the association between the ad group or campaign and the target.

To remove the target association for an ad group, call the DeleteTargetFromAdGroup service operation, passing the ad group identifier. To remove the target association for a campaign, call the DeleteTargetFromCampaign service operation, passing the campaign identifier. These operations remove only the association between the entity and the target. The target is still retained in the library even if there is no association.

Use the DeleteTargetsFromLibrary service operation to remove a target from your library. This step is not necessary unless you don't plan to use the target again.

For examples of how to target ad groups, see the following examples:

• Target Ad Groups in C#
  
• Create Targets in PHP
  

Concepts