The DoubleClick for Advertisers feature known as Floodlight allows you to gather metrics on specific actions taken by users who visit your site after viewing or clicking on one of your ads.
Setting up Floodlight tracking through the API exposes one notable difference from the UI workflow explored by the Help Center guide: Floodlight settings are tied to a SpotlightConfiguration object, not to an advertiser. These configuration objects can be associated with additional advertisers. A new SpotlightConfiguration is generated every time an advertiser is created, and although they share the same ID number, both objects are distinct from each other.
The first step to sharing settings is to set up the configuration that’s going to be used. The choice of which configuration to use isn’t especially meaningful. You should pick one of the advertisers who’s going to be in the group sharing these settings and use its accompanying configuration. This advertiser willn’t have a special status in the group using the same settings; all of the advertisers use the settings in the same way. Once you’ve picked your configuration, set up all the SpotlightActivities and SpotlightActivityGroups that yo’ll need.
Sharing through the API is simple: Advertisers have a field named spotId which takes in the SpotlightConfiguration’s ID number. You have to fetch your advertisers from the server, change this field to the shared configuration ID number, and then save the advertisers.
Once you’ve got this set up, you can easily share with more advertisers by grabbing any advertiser currently using your configuration and inspecting its spotId field to get your configuration’s ID number.
As a final pointer, if you’re looking for the base configuration settings, you’ll want to modify your SpotlightConfiguration object. Though the UI displays these settings as part of the advertiser, they reside in the SpotlightConfiguration through the API.
More Info: guide on using Floodlight
[Source: DoubleClick For Advertisers API Blog]