Common Trafficking Tasks

This page outlines how to perform some of the most common trafficking tasks using the DCM/DFA Reporting and Trafficking API.

General coding tips

Required and optional properties and parameters- See the reference documentation to find out whether a property or parameter is required for an API call.
Wildcard name searches- You can use the asterisk (*) wildcard when searching on names for objects . An asterisk matches zero or more of any character. The API also supports an implied substring search, so a search for "abc" will implicitly search for "*abc*".
Updating vs. patching- To modify an existing object, you have two options:
1. Updating- When updating an object, all fields will be overwritten on insert. It's important to load the object you'd like to update and make any changes to that object. Otherwise, any fields that are not present in the update request will be unset.
2. Patching- When patching, only the fields specified will be overwritten on insert. In this case, you can create a new object, assign it the same ID as the object to update, set the fields to be updated, and execute the patch request.
Sizes- Physical dimensions are represented by a Size object defined by the sizes service . The account supplies a set of standard sizes, and you can add your own custom sizes to this list.
Dates and times- You can save dates/times in RFC 3339 format using local time zones; all values returned by the API are in UTC. This differs from the website where dates and times are shown in your configured timezone (America/New York time, by default).

Create an advertiser

C#

Create an

 Advertiser

object and set it's required name and status properties.

 // Create the advertiser structure. 
 Advertiser 
  
 advertiser 
  
 = 
  
 new 
  
 Advertiser 
 (); 
 advertiser 
 . 
 Name 
  
 = 
  
 advertiserName 
 ; 
 advertiser 
 . 
 Status 
  
 = 
  
 "APPROVED" 
 ;

Call

 advertisers.insert()

to save the advertiser.

 // Create the advertiser. 
 Advertiser 
  
 result 
  
 = 
  
 service 
 . 
 Advertisers 
 . 
 Insert 
 ( 
 advertiser 
 , 
  
 profileId 
 ). 
 Execute 
 ();

Java

Create an

 Advertiser

object and set it's required name and status properties.

 // Create the advertiser structure. 
 Advertiser 
  
 advertiser 
  
 = 
  
 new 
  
 Advertiser 
 (); 
 advertiser 
 . 
 setName 
 ( 
 advertiserName 
 ); 
 advertiser 
 . 
 setStatus 
 ( 
 "APPROVED" 
 );

Call

 advertisers.insert()

to save the advertiser.

 // Create the advertiser. 
 Advertiser 
  
 result 
  
 = 
  
 reporting 
 . 
 advertisers 
 (). 
 insert 
 ( 
 profileId 
 , 
  
 advertiser 
 ). 
 execute 
 ();

PHP

Create an

 Advertiser

object and set it's required name and status properties.

 $advertiser = new Google_Service_Dfareporting_Advertiser(); 
 $advertiser->setName($values['advertiser_name']); 
 $advertiser->setStatus('APPROVED');

Call

 advertisers.insert()

to save the advertiser.

 $result = $this->service->advertisers->insert( 
 $values['user_profile_id'], 
 $advertiser 
 );

Python

Create an

 Advertiser

object and set it's required name and status properties.

 # Construct and save advertiser. 
 advertiser 
 = 
 { 
 'name' 
 : 
 'Test Advertiser' 
 , 
 'status' 
 : 
 'APPROVED' 
 }

Call

 advertisers.insert()

to save the advertiser.

 request 
 = 
 service 
 . 
 advertisers 
 () 
 . 
 insert 
 ( 
 profileId 
 = 
 profile_id 
 , 
 body 
 = 
 advertiser 
 ) 
 # Execute request and print response. 
 response 
 = 
 request 
 . 
 execute 
 ()

Ruby

Create an

 Advertiser

object and set it's required name and status properties.

 # Create a new advertiser resource to insert. 
 advertiser 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 Advertiser 
 . 
 new 
 ( 
  
 name 
 : 
  
 format 
 ( 
 'Example Advertiser #%s' 
 , 
  
 SecureRandom 
 . 
 hex 
 ( 
 3 
 )), 
  
 status 
 : 
  
 'APPROVED' 
 )

Call

 advertisers.insert()

to save the advertiser.

 # Insert the advertiser. 
 result 
  
 = 
  
 service 
 . 
 insert_advertiser 
 ( 
 profile_id 
 , 
  
 advertiser 
 )

Create a campaign

C#

Create a Campaign object and set it's required properties:

advertiserId - The advertiser with which to associate this campaign.
name - This must be unique across all campaigns for this advertiser.
defaultLandingPageId - A landing page to which users will be directed when they click on an ad in this campaign, if one isn't assigned to that ad. You can look up existing landing pages by calling advertiserLandingPages.list or create a new one by calling advertiserLandingPages.insert .
Start and end dates - These must be in the future, and can be accurate down to the day. See the dates and times bullet in General coding information for more details. Individual ad dates can exceed the end date, to enable a publisher to try to fulfill a contract for a specified number of actions, if it hasn't been filled by the given campaign end date.

 // Locate an advertiser landing page to use as a default. 
 LandingPage 
  
 defaultLandingPage 
  
 = 
  
 getAdvertiserLandingPage 
 ( 
 service 
 , 
  
 profileId 
 , 
  
 advertiserId 
 ); 
 // Create the campaign structure. 
 Campaign 
  
 campaign 
  
 = 
  
 new 
  
 Campaign 
 (); 
 campaign 
 . 
 Name 
  
 = 
  
 campaignName 
 ; 
 campaign 
 . 
 AdvertiserId 
  
 = 
  
 advertiserId 
 ; 
 campaign 
 . 
 Archived 
  
 = 
  
 false 
 ; 
 campaign 
 . 
 DefaultLandingPageId 
  
 = 
  
 defaultLandingPage 
 . 
 Id 
 ; 
 // Set the campaign start date. This example uses today's date. 
 campaign 
 . 
 StartDate 
  
 = 
  
 DfaReportingDateConverterUtil 
 . 
 convertToDateString 
 ( 
 DateTime 
 . 
 Now 
 ); 
 // Set the campaign end date. This example uses one month from today's date. 
 campaign 
 . 
 EndDate 
  
 = 
  
 DfaReportingDateConverterUtil 
 . 
 convertToDateString 
 ( 
 DateTime 
 . 
 Now 
 . 
 AddMonths 
 ( 
 1 
 ));

Call campaigns.insert() to save the campaign.

 // Insert the campaign. 
 Campaign 
  
 result 
  
 = 
  
 service 
 . 
 Campaigns 
 . 
 Insert 
 ( 
 campaign 
 , 
  
 profileId 
 ). 
 Execute 
 ();

Java

Create a Campaign object and set it's required properties:

advertiserId - The advertiser with which to associate this campaign.
name - This must be unique across all campaigns for this advertiser.
defaultLandingPageId - A landing page to which users will be directed when they click on an ad in this campaign, if one isn't assigned to that ad. You can look up existing landing pages by calling advertiserLandingPages.list or create a new one by calling advertiserLandingPages.insert .
Start and end dates - These must be in the future, and can be accurate down to the day. See the dates and times bullet in General coding information for more details. Individual ad dates can exceed the end date, to enable a publisher to try to fulfill a contract for a specified number of actions, if it hasn't been filled by the given campaign end date.

 // Locate an advertiser landing page to use as a default. 
 LandingPage 
  
 defaultLandingPage 
  
 = 
  
 getAdvertiserLandingPage 
 ( 
 reporting 
 , 
  
 profileId 
 , 
  
 advertiserId 
 ); 
 // Create the campaign structure. 
 Campaign 
  
 campaign 
  
 = 
  
 new 
  
 Campaign 
 (); 
 campaign 
 . 
 setName 
 ( 
 campaignName 
 ); 
 campaign 
 . 
 setAdvertiserId 
 ( 
 advertiserId 
 ); 
 campaign 
 . 
 setArchived 
 ( 
 false 
 ); 
 campaign 
 . 
 setDefaultLandingPageId 
 ( 
 defaultLandingPage 
 . 
 getId 
 ()); 
 // Set the campaign start date. This example uses today's date. 
 Calendar 
  
 today 
  
 = 
  
 Calendar 
 . 
 getInstance 
 (); 
 DateTime 
  
 startDate 
  
 = 
  
 new 
  
 DateTime 
 ( 
 true 
 , 
  
 today 
 . 
 getTimeInMillis 
 (), 
  
 null 
 ); 
 campaign 
 . 
 setStartDate 
 ( 
 startDate 
 ); 
 // Set the campaign end date. This example uses one month from today's date. 
 Calendar 
  
 nextMonth 
  
 = 
  
 Calendar 
 . 
 getInstance 
 (); 
 nextMonth 
 . 
 add 
 ( 
 Calendar 
 . 
 MONTH 
 , 
  
 1 
 ); 
 DateTime 
  
 endDate 
  
 = 
  
 new 
  
 DateTime 
 ( 
 true 
 , 
  
 nextMonth 
 . 
 getTimeInMillis 
 (), 
  
 null 
 ); 
 campaign 
 . 
 setEndDate 
 ( 
 endDate 
 );

Call campaigns.insert() to save the campaign.

 // Insert the campaign. 
 Campaign 
  
 result 
  
 = 
  
 reporting 
 . 
 campaigns 
 (). 
 insert 
 ( 
 profileId 
 , 
  
 campaign 
 ). 
 execute 
 ();

PHP

Create a Campaign object and set it's required properties:
- advertiserId - The advertiser with which to associate this campaign.
- name - This must be unique across all campaigns for this advertiser.
- defaultLandingPageId - A landing page to which users will be directed when they click on an ad in this campaign, if one isn't assigned to that ad. You can look up existing landing pages by calling advertiserLandingPages.list or create a new one by calling advertiserLandingPages.insert .
- Start and end dates - These must be in the future, and can be accurate down to the day. See the dates and times bullet in General coding information for more details. Individual ad dates can exceed the end date, to enable a publisher to try to fulfill a contract for a specified number of actions, if it hasn't been filled by the given campaign end date.
```
 $startDate = new DateTime('today'); 
 $endDate = new DateTime('+1 month'); 
 $campaign = new Google_Service_Dfareporting_Campaign(); 
 $campaign->setAdvertiserId($values['advertiser_id']); 
 $campaign->setDefaultLandingPageId($values['default_landing_page_id']); 
 $campaign->setName($values['campaign_name']); 
 $campaign->setStartDate($startDate->format('Y-m-d')); 
 $campaign->setEndDate($endDate->format('Y-m-d')); 
```

Call campaigns.insert() to save the campaign.

 $result = $this->service->campaigns->insert( 
 $values['user_profile_id'], 
 $campaign 
 );

Python

Create a Campaign object and set it's required properties:
- advertiserId - The advertiser with which to associate this campaign.
- name - This must be unique across all campaigns for this advertiser.
- defaultLandingPageId - A landing page to which users will be directed when they click on an ad in this campaign, if one isn't assigned to that ad. You can look up existing landing pages by calling advertiserLandingPages.list or create a new one by calling advertiserLandingPages.insert .
- Start and end dates - These must be in the future, and can be accurate down to the day. See the dates and times bullet in General coding information for more details. Individual ad dates can exceed the end date, to enable a publisher to try to fulfill a contract for a specified number of actions, if it hasn't been filled by the given campaign end date.
```
 # Locate an advertiser landing page to use as a default. 
 default_landing_page 
 = 
 get_advertiser_landing_page 
 ( 
 service 
 , 
 profile_id 
 , 
 advertiser_id 
 ) 
 # Construct and save campaign. 
 campaign 
 = 
 { 
 'name' 
 : 
 'Test Campaign # 
 %s 
 ' 
 % 
 uuid 
 . 
 uuid4 
 (), 
 'advertiserId' 
 : 
 advertiser_id 
 , 
 'archived' 
 : 
 'false' 
 , 
 'defaultLandingPageId' 
 : 
 default_landing_page 
 [ 
 'id' 
 ], 
 'startDate' 
 : 
 '2015-01-01' 
 , 
 'endDate' 
 : 
 '2020-01-01' 
 } 
```

Call campaigns.insert() to save the campaign.

 request 
 = 
 service 
 . 
 campaigns 
 () 
 . 
 insert 
 ( 
 profileId 
 = 
 profile_id 
 , 
 body 
 = 
 campaign 
 ) 
 # Execute request and print response. 
 response 
 = 
 request 
 . 
 execute 
 ()

Ruby

Create a Campaign object and set it's required properties:

advertiserId - The advertiser with which to associate this campaign.
name - This must be unique across all campaigns for this advertiser.
defaultLandingPageId - A landing page to which users will be directed when they click on an ad in this campaign, if one isn't assigned to that ad. You can look up existing landing pages by calling advertiserLandingPages.list or create a new one by calling advertiserLandingPages.insert .
Start and end dates - These must be in the future, and can be accurate down to the day. See the dates and times bullet in General coding information for more details. Individual ad dates can exceed the end date, to enable a publisher to try to fulfill a contract for a specified number of actions, if it hasn't been filled by the given campaign end date.

 # Locate an advertiser landing page to use as a default. 
 default_landing_page 
  
 = 
  
 get_advertiser_landing_page 
 ( 
 service 
 , 
  
 profile_id 
 , 
  
 advertiser_id 
 ) 
 # Create a new campaign resource to insert. 
 campaign 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 Campaign 
 . 
 new 
 ( 
  
 advertiser_id 
 : 
  
 advertiser_id 
 , 
  
 archived 
 : 
  
 false 
 , 
  
 default_landing_page_id 
 : 
  
 default_landing_page 
 . 
 id 
 , 
  
 name 
 : 
  
 format 
 ( 
 'Example Campaign #%s' 
 , 
  
 SecureRandom 
 . 
 hex 
 ( 
 3 
 )), 
  
 start_date 
 : 
  
 '2014-01-01' 
 , 
  
 end_date 
 : 
  
 '2020-01-01' 
 )

Call campaigns.insert() to save the campaign.

 # Insert the campaign. 
 result 
  
 = 
  
 service 
 . 
 insert_campaign 
 ( 
 profile_id 
 , 
  
 campaign 
 )

Create a placement

C#

Create a

 Placement

object and set the required placement properties (including

 campaignId

and

 siteId

). Also, be sure to set the placement type and size accurately for the placement that you have negotiated with your website.

 // Create the placement. 
 Placement 
  
 placement 
  
 = 
  
 new 
  
 Placement 
 (); 
 placement 
 . 
 Name 
  
 = 
  
 placementName 
 ; 
 placement 
 . 
 CampaignId 
  
 = 
  
 campaignId 
 ; 
 placement 
 . 
 Compatibility 
  
 = 
  
 "DISPLAY" 
 ; 
 placement 
 . 
 PaymentSource 
  
 = 
  
 "PLACEMENT_AGENCY_PAID" 
 ; 
 placement 
 . 
 SiteId 
  
 = 
  
 dfaSiteId 
 ; 
 placement 
 . 
 TagFormats 
  
 = 
  
 new 
  
 List<string> 
 () 
  
 { 
  
 "PLACEMENT_TAG_STANDARD" 
  
 }; 
 // Set the size of the placement. 
 Size 
  
 size 
  
 = 
  
 new 
  
 Size 
 (); 
 size 
 . 
 Id 
  
 = 
  
 sizeId 
 ; 
 placement 
 . 
 Size 
  
 = 
  
 size 
 ;

Create a new

 PricingSchedule

object to assign to the placement.

 // Set the pricing schedule for the placement. 
 PricingSchedule 
  
 pricingSchedule 
  
 = 
  
 new 
  
 PricingSchedule 
 (); 
 pricingSchedule 
 . 
 EndDate 
  
 = 
  
 campaign 
 . 
 EndDate 
 ; 
 pricingSchedule 
 . 
 PricingType 
  
 = 
  
 "PRICING_TYPE_CPM" 
 ; 
 pricingSchedule 
 . 
 StartDate 
  
 = 
  
 campaign 
 . 
 StartDate 
 ; 
 placement 
 . 
 PricingSchedule 
  
 = 
  
 pricingSchedule 
 ;

Save the Placement object by calling

 placements.insert()

. Be sure to store the returned ID if you want to use it to assign to an Ad or Creative.

 // Insert the placement. 
 Placement 
  
 result 
  
 = 
  
 service 
 . 
 Placements 
 . 
 Insert 
 ( 
 placement 
 , 
  
 profileId 
 ). 
 Execute 
 ();

Java

Create a

 Placement

object and set the required placement properties (including

 campaignId

and

 siteId

). Also, be sure to set the placement type and size accurately for the placement that you have negotiated with your website.

 // Create the placement. 
 Placement 
  
 placement 
  
 = 
  
 new 
  
 Placement 
 (); 
 placement 
 . 
 setName 
 ( 
 placementName 
 ); 
 placement 
 . 
 setCampaignId 
 ( 
 campaignId 
 ); 
 placement 
 . 
 setCompatibility 
 ( 
 "DISPLAY" 
 ); 
 placement 
 . 
 setPaymentSource 
 ( 
 "PLACEMENT_AGENCY_PAID" 
 ); 
 placement 
 . 
 setSiteId 
 ( 
 dfaSiteId 
 ); 
 placement 
 . 
 setTagFormats 
 ( 
 ImmutableList 
 . 
 of 
 ( 
 "PLACEMENT_TAG_STANDARD" 
 )); 
 // Set the size of the placement. 
 Size 
  
 size 
  
 = 
  
 new 
  
 Size 
 (); 
 size 
 . 
 setId 
 ( 
 sizeId 
 ); 
 placement 
 . 
 setSize 
 ( 
 size 
 );

Create a new

 PricingSchedule

object to assign to the placement.

 // Set the pricing schedule for the placement. 
 PricingSchedule 
  
 pricingSchedule 
  
 = 
  
 new 
  
 PricingSchedule 
 (); 
 pricingSchedule 
 . 
 setEndDate 
 ( 
 campaign 
 . 
 getEndDate 
 ()); 
 pricingSchedule 
 . 
 setPricingType 
 ( 
 "PRICING_TYPE_CPM" 
 ); 
 pricingSchedule 
 . 
 setStartDate 
 ( 
 campaign 
 . 
 getStartDate 
 ()); 
 placement 
 . 
 setPricingSchedule 
 ( 
 pricingSchedule 
 );

Save the Placement object by calling

 placements.insert()

. Be sure to store the returned ID if you want to use it to assign to an Ad or Creative.

 // Insert the placement. 
 Placement 
  
 result 
  
 = 
  
 reporting 
 . 
 placements 
 (). 
 insert 
 ( 
 profileId 
 , 
  
 placement 
 ). 
 execute 
 ();

PHP

Create a

 Placement

object and set the required placement properties (including

 campaignId

and

 siteId

). Also, be sure to set the placement type and size accurately for the placement that you have negotiated with your website.

 $placement = new Google_Service_Dfareporting_Placement(); 
 $placement->setCampaignId($values['campaign_id']); 
 $placement->setCompatibility('DISPLAY'); 
 $placement->setName($values['placement_name']); 
 $placement->setPaymentSource('PLACEMENT_AGENCY_PAID'); 
 $placement->setSiteId($values['site_id']); 
 $placement->setTagFormats(['PLACEMENT_TAG_STANDARD']); 
 // Set the size of the placement. 
 $size = new Google_Service_Dfareporting_Size(); 
 $size->setId($values['size_id']); 
 $placement->setSize($size);

Create a new

 PricingSchedule

object to assign to the placement.

 // Set the pricing schedule for the placement. 
 $pricingSchedule = new Google_Service_Dfareporting_PricingSchedule(); 
 $pricingSchedule->setEndDate($campaign->getEndDate()); 
 $pricingSchedule->setPricingType('PRICING_TYPE_CPM'); 
 $pricingSchedule->setStartDate($campaign->getStartDate()); 
 $placement->setPricingSchedule($pricingSchedule);

Save the Placement object by calling placements.insert() . Be sure to store the returned ID if you want to use it to assign to an Ad or Creative.
```
 // Insert the placement. 
 $result = $this->service->placements->insert( 
 $values['user_profile_id'], 
 $placement 
 ); 
```

Python

Create a

 Placement

object and set the required placement properties (including

 campaignId

and

 siteId

). Also, be sure to set the placement type and size accurately for the placement that you have negotiated with your website.

 # Construct and save placement. 
 placement 
 = 
 { 
 'name' 
 : 
 'Test Placement' 
 , 
 'campaignId' 
 : 
 campaign_id 
 , 
 'compatibility' 
 : 
 'DISPLAY' 
 , 
 'siteId' 
 : 
 site_id 
 , 
 'size' 
 : 
 { 
 'height' 
 : 
 '1' 
 , 
 'width' 
 : 
 '1' 
 }, 
 'paymentSource' 
 : 
 'PLACEMENT_AGENCY_PAID' 
 , 
 'tagFormats' 
 : 
 [ 
 'PLACEMENT_TAG_STANDARD' 
 ] 
 }

Create a new

 PricingSchedule

object to assign to the placement.

 # Set the pricing schedule for the placement. 
 placement 
 [ 
 'pricingSchedule' 
 ] 
 = 
 { 
 'startDate' 
 : 
 campaign 
 [ 
 'startDate' 
 ], 
 'endDate' 
 : 
 campaign 
 [ 
 'endDate' 
 ], 
 'pricingType' 
 : 
 'PRICING_TYPE_CPM' 
 }

Save the Placement object by calling

 placements.insert()

. Be sure to store the returned ID if you want to use it to assign to an Ad or Creative.

 request 
 = 
 service 
 . 
 placements 
 () 
 . 
 insert 
 ( 
 profileId 
 = 
 profile_id 
 , 
 body 
 = 
 placement 
 ) 
 # Execute request and print response. 
 response 
 = 
 request 
 . 
 execute 
 ()

Ruby

Create a

 Placement

object and set the required placement properties (including

 campaignId

and

 siteId

). Also, be sure to set the placement type and size accurately for the placement that you have negotiated with your website.

 # Create a new placement resource to insert. 
 placement 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 Placement 
 . 
 new 
 ( 
  
 campaign_id 
 : 
  
 campaign_id 
 , 
  
 compatibility 
 : 
  
 'DISPLAY' 
 , 
  
 name 
 : 
  
 'Example Placement' 
 , 
  
 payment_source 
 : 
  
 'PLACEMENT_AGENCY_PAID' 
 , 
  
 site_id 
 : 
  
 site_id 
 , 
  
 size 
 : 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 Size 
 . 
 new 
 ( 
  
 height 
 : 
  
 1 
 , 
  
 width 
 : 
  
 1 
  
 ), 
  
 tag_formats 
 : 
  
 [ 
 'PLACEMENT_TAG_STANDARD' 
 ] 
 )

Create a new

 PricingSchedule

object to assign to the placement.

 # Set the pricing schedule for the placement. 
 placement 
 . 
 pricing_schedule 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 PricingSchedule 
 . 
 new 
 ( 
  
 end_date 
 : 
  
 campaign 
 . 
 end_date 
 , 
  
 pricing_type 
 : 
  
 'PRICING_TYPE_CPM' 
 , 
  
 start_date 
 : 
  
 campaign 
 . 
 start_date 
  
 )

Save the Placement object by calling

 placements.insert()

. Be sure to store the returned ID if you want to use it to assign to an Ad or Creative.

 # Insert the placement strategy. 
 result 
  
 = 
  
 service 
 . 
 insert_placement 
 ( 
 profile_id 
 , 
  
 placement 
 )

Upload assets

You can upload many types of asset via a process known as media upload . Although this process is similar for all creative types, some types may require specific properties to be passed as metadata, in order for them to be used properly.

C#

Create an assetIdentifier object and set the required properties. All assets, no matter what type or how used, are required to specify an assetIdentifier . When assigning the asset to a creative, this object will be used to refer back to the asset. The following properties are required:
- The name property, which will be the name of the asset on the server. The name must include an extension that indicates the file type such as .png, or .gif, and will be exposed to the browser as the asset name, but it does not have to be the same as the original file name. Note that this name might be changed by Campaign Manager 360 to make it unique on the server; check the return value to see if it has been changed.
- The type property, which identifies the type of asset. This property will dictate the types of creatives this asset can be associated with.
```
 // Create the creative asset ID and Metadata. 
 CreativeAssetId 
  
 assetId 
  
 = 
  
 new 
  
 CreativeAssetId 
 (); 
 assetId 
 . 
 Name 
  
 = 
  
 Path 
 . 
 GetFileName 
 ( 
 assetFile 
 ); 
 assetId 
 . 
 Type 
  
 = 
  
 assetType 
 ; 
```

Upload the file by calling creativeAssets.insert() . Perform a multipart upload , passing both the assetIdentifier and the file contents as part of the same request. If successful, a CreativeAsset resource will be returned, with an assetIdentifier that you will use to assign this asset to a creative.

 // Prepare an input stream. 
 FileStream 
  
 assetContent 
  
 = 
  
 new 
  
 FileStream 
 ( 
 assetFile 
 , 
  
 FileMode 
 . 
 Open 
 , 
  
 FileAccess 
 . 
 Read 
 ); 
 CreativeAssetMetadata 
  
 metaData 
  
 = 
  
 new 
  
 CreativeAssetMetadata 
 (); 
 metaData 
 . 
 AssetIdentifier 
  
 = 
  
 assetId 
 ; 
 // Insert the creative. 
 String 
  
 mimeType 
  
 = 
  
 determineMimeType 
 ( 
 assetFile 
 , 
  
 assetType 
 ); 
 CreativeAssetsResource 
 . 
 InsertMediaUpload 
  
 request 
  
 = 
  
 Service 
 . 
 CreativeAssets 
 . 
 Insert 
 ( 
 metaData 
 , 
  
 ProfileId 
 , 
  
 AdvertiserId 
 , 
  
 assetContent 
 , 
  
 mimeType 
 ); 
 IUploadProgress 
  
 progress 
  
 = 
  
 request 
 . 
 Upload 
 (); 
 if 
  
 ( 
 UploadStatus 
 . 
 Failed 
 . 
 Equals 
 ( 
 progress 
 . 
 Status 
 )) 
  
 { 
  
 throw 
  
 progress 
 . 
 Exception 
 ; 
 }

Java

Create an assetIdentifier object and set the required properties. All assets, no matter what type or how used, are required to specify an assetIdentifier . When assigning the asset to a creative, this object will be used to refer back to the asset. The following properties are required:
- The name property, which will be the name of the asset on the server. The name must include an extension that indicates the file type such as .png, or .gif, and will be exposed to the browser as the asset name, but it does not have to be the same as the original file name. Note that this name might be changed by Campaign Manager 360 to make it unique on the server; check the return value to see if it has been changed.
- The type property, which identifies the type of asset. This property will dictate the types of creatives this asset can be associated with.
```
 // Create the creative asset ID and Metadata. 
 CreativeAssetId 
  
 assetId 
  
 = 
  
 new 
  
 CreativeAssetId 
 (); 
 assetId 
 . 
 setName 
 ( 
 assetName 
 ); 
 assetId 
 . 
 setType 
 ( 
 assetType 
 ); 
```

 // Open the asset file. 
 File 
  
 file 
  
 = 
  
 new 
  
 File 
 ( 
 assetFile 
 ); 
 // Prepare an input stream. 
 String 
  
 contentType 
  
 = 
  
 getMimeType 
 ( 
 assetFile 
 ); 
 InputStreamContent 
  
 assetContent 
  
 = 
  
 new 
  
 InputStreamContent 
 ( 
 contentType 
 , 
  
 new 
  
 BufferedInputStream 
 ( 
 new 
  
 FileInputStream 
 ( 
 file 
 ))); 
 assetContent 
 . 
 setLength 
 ( 
 file 
 . 
 length 
 ()); 
 CreativeAssetMetadata 
  
 metaData 
  
 = 
  
 new 
  
 CreativeAssetMetadata 
 (); 
 metaData 
 . 
 setAssetIdentifier 
 ( 
 assetId 
 ); 
 // Insert the creative. 
 CreativeAssetMetadata 
  
 result 
  
 = 
  
 reporting 
 . 
 creativeAssets 
 () 
  
 . 
 insert 
 ( 
 profileId 
 , 
  
 advertiserId 
 , 
  
 metaData 
 , 
  
 assetContent 
 ). 
 execute 
 ();

PHP

Create an assetIdentifier object and set the required properties. All assets, no matter what type or how used, are required to specify an assetIdentifier . When assigning the asset to a creative, this object will be used to refer back to the asset. The following properties are required:
- The name property, which will be the name of the asset on the server. The name must include an extension that indicates the file type such as .png, or .gif, and will be exposed to the browser as the asset name, but it does not have to be the same as the original file name. Note that this name might be changed by Campaign Manager 360 to make it unique on the server; check the return value to see if it has been changed.
- The type property, which identifies the type of asset. This property will dictate the types of creatives this asset can be associated with.
```
 $assetId = new Google_Service_Dfareporting_CreativeAssetId(); 
 $assetId->setName($asset['name']); 
 $assetId->setType($type); 
```

 $metadata = new Google_Service_Dfareporting_CreativeAssetMetadata(); 
 $metadata->setAssetIdentifier($assetId); 
 $result = $service->creativeAssets->insert( 
 $userProfileId, 
 $advertiserId, 
 $metadata, 
 ['data' => file_get_contents($asset['tmp_name']), 
 'mimeType' => $asset['type'], 
 'uploadType' => 'multipart'] 
 );

Python

Create an assetIdentifier object and set the required properties. All assets, no matter what type or how used, are required to specify an assetIdentifier . When assigning the asset to a creative, this object will be used to refer back to the asset. The following properties are required:
- The name property, which will be the name of the asset on the server. The name must include an extension that indicates the file type such as .png, or .gif, and will be exposed to the browser as the asset name, but it does not have to be the same as the original file name. Note that this name might be changed by Campaign Manager 360 to make it unique on the server; check the return value to see if it has been changed.
- The type property, which identifies the type of asset. This property will dictate the types of creatives this asset can be associated with.
```
 # Construct the creative asset metadata 
 creative_asset 
 = 
 { 
 'assetIdentifier' 
 : 
 { 
 'name' 
 : 
 asset_name 
 , 
 'type' 
 : 
 asset_type 
 }} 
```

 media 
 = 
 MediaFileUpload 
 ( 
 path_to_asset_file 
 ) 
 if 
 not 
 media 
 . 
 mimetype 
 (): 
 media 
 = 
 MediaFileUpload 
 ( 
 path_to_asset_file 
 , 
 'application/octet-stream' 
 ) 
 response 
 = 
 service 
 . 
 creativeAssets 
 () 
 . 
 insert 
 ( 
 advertiserId 
 = 
 advertiser_id 
 , 
 profileId 
 = 
 profile_id 
 , 
 media_body 
 = 
 media 
 , 
 body 
 = 
 creative_asset 
 ) 
 . 
 execute 
 ()

Ruby

Create an assetIdentifier object and set the required properties. All assets, no matter what type or how used, are required to specify an assetIdentifier . When assigning the asset to a creative, this object will be used to refer back to the asset. The following properties are required:
- The name property, which will be the name of the asset on the server. The name must include an extension that indicates the file type such as .png, or .gif, and will be exposed to the browser as the asset name, but it does not have to be the same as the original file name. Note that this name might be changed by Campaign Manager 360 to make it unique on the server; check the return value to see if it has been changed.
- The type property, which identifies the type of asset. This property will dictate the types of creatives this asset can be associated with.
```
 # Construct the creative asset metadata 
 creative_asset 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 CreativeAsset 
 . 
 new 
 ( 
  
 asset_identifier 
 : 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 CreativeAssetId 
 . 
 new 
 ( 
  
 name 
 : 
  
 asset_name 
 , 
  
 type 
 : 
  
 asset_type 
  
 ) 
 ) 
```

 # Upload the asset. 
 mime_type 
  
 = 
  
 determine_mime_type 
 ( 
 path_to_asset_file 
 , 
  
 asset_type 
 ) 
 result 
  
 = 
  
 @service 
 . 
 insert_creative_asset 
 ( 
  
 @profile_id 
 , 
  
 advertiser_id 
 , 
  
 creative_asset 
 , 
  
 content_type 
 : 
  
 mime_type 
 , 
  
 upload_source 
 : 
  
 path_to_asset_file 
 )

Create a creative

A Creative object wraps an existing asset. Depending on how you will use the creatives on the host page, you can create Creative objects of different creative types. See the reference documentation to determine which type is appropriate for you.

The following example demonstrates how to create a new HTML5 display creative.

C#

Upload the assets. Different creatives require different types and quantities of assets; see Upload Assets for details. Each time you successfully upload an asset, you will get an assetIdenfitier in the response; you will use the stored file name and type to reference these assets in your creative, rather than a traditional ID.

Create a creative and assign appropriate values. Instantiate a Creative and set the proper

 type

; you cannot change a Creative object's type after you save it. Specify the assets by their AssetIdentifier and their

 role

 // Locate an advertiser landing page to use as a default. 
 LandingPage 
  
 defaultLandingPage 
  
 = 
  
 getAdvertiserLandingPage 
 ( 
 service 
 , 
  
 profileId 
 , 
  
 advertiserId 
 ); 
 // Create the creative structure. 
 Creative 
  
 creative 
  
 = 
  
 new 
  
 Creative 
 (); 
 creative 
 . 
 AdvertiserId 
  
 = 
  
 advertiserId 
 ; 
 creative 
 . 
 Name 
  
 = 
  
 "Test HTML5 display creative" 
 ; 
 creative 
 . 
 Size 
  
 = 
  
 new 
  
 Size 
 () 
  
 { 
  
 Id 
  
 = 
  
 sizeId 
  
 }; 
 creative 
 . 
 Type 
  
 = 
  
 "DISPLAY" 
 ; 
 // Upload the HTML5 asset. 
 CreativeAssetUtils 
  
 assetUtils 
  
 = 
  
 new 
  
 CreativeAssetUtils 
 ( 
 service 
 , 
  
 profileId 
 , 
  
 advertiserId 
 ); 
 CreativeAssetId 
  
 html5AssetId 
  
 = 
  
 assetUtils 
 . 
 uploadAsset 
 ( 
 pathToHtml5AssetFile 
 , 
  
 "HTML" 
 ). 
 AssetIdentifier 
 ; 
 CreativeAsset 
  
 html5Asset 
  
 = 
  
 new 
  
 CreativeAsset 
 (); 
 html5Asset 
 . 
 AssetIdentifier 
  
 = 
  
 html5AssetId 
 ; 
 html5Asset 
 . 
 Role 
  
 = 
  
 "PRIMARY" 
 ; 
 // Upload the backup image asset. 
 CreativeAssetId 
  
 imageAssetId 
  
 = 
  
 assetUtils 
 . 
 uploadAsset 
 ( 
 pathToImageAssetFile 
 , 
  
 "HTML_IMAGE" 
 ). 
 AssetIdentifier 
 ; 
 CreativeAsset 
  
 imageAsset 
  
 = 
  
 new 
  
 CreativeAsset 
 (); 
 imageAsset 
 . 
 AssetIdentifier 
  
 = 
  
 imageAssetId 
 ; 
 imageAsset 
 . 
 Role 
  
 = 
  
 "BACKUP_IMAGE" 
 ; 
 // Add the creative assets. 
 creative 
 . 
 CreativeAssets 
  
 = 
  
 new 
  
 List<CreativeAsset> 
 () 
  
 { 
  
 html5Asset 
 , 
  
 imageAsset 
  
 }; 
 // Configure the bacup image. 
 creative 
 . 
 BackupImageClickThroughUrl 
  
 = 
  
 new 
  
 CreativeClickThroughUrl 
 () 
  
 { 
  
 LandingPageId 
  
 = 
  
 defaultLandingPage 
 . 
 Id 
 }; 
 creative 
 . 
 BackupImageReportingLabel 
  
 = 
  
 "backup" 
 ; 
 creative 
 . 
 BackupImageTargetWindow 
  
 = 
  
 new 
  
 TargetWindow 
 () 
  
 { 
  
 TargetWindowOption 
  
 = 
  
 "NEW_WINDOW" 
  
 }; 
 // Add a click tag. 
 ClickTag 
  
 clickTag 
  
 = 
  
 new 
  
 ClickTag 
 (); 
 clickTag 
 . 
 Name 
  
 = 
  
 "clickTag" 
 ; 
 clickTag 
 . 
 EventName 
  
 = 
  
 "exit" 
 ; 
 clickTag 
 . 
 ClickThroughUrl 
  
 = 
  
 new 
  
 CreativeClickThroughUrl 
 () 
  
 { 
  
 LandingPageId 
  
 = 
  
 defaultLandingPage 
 . 
 Id 
 }; 
 creative 
 . 
 ClickTags 
  
 = 
  
 new 
  
 List<ClickTag> 
 () 
  
 { 
  
 clickTag 
  
 };

Save the creative. Do this by calling

 creatives.insert()

. It is required to specify an advertiser ID with which to associate this creative.

 Creative 
  
 result 
  
 = 
  
 service 
 . 
 Creatives 
 . 
 Insert 
 ( 
 creative 
 , 
  
 profileId 
 ). 
 Execute 
 ();

(Optional) Associate the creative with a campaign. This can be done by calling

 campaignCreativeAssociations.insert()

, passing in the campaign and creative IDs.

 // Create the campaign creative association structure. 
 CampaignCreativeAssociation 
  
 association 
  
 = 
  
 new 
  
 CampaignCreativeAssociation 
 (); 
 association 
 . 
 CreativeId 
  
 = 
  
 creativeId 
 ; 
 // Insert the association. 
 CampaignCreativeAssociation 
  
 result 
  
 = 
  
 service 
 . 
 CampaignCreativeAssociations 
 . 
 Insert 
 ( 
 association 
 , 
  
 profileId 
 , 
  
 campaignId 
 ). 
 Execute 
 ();

Java

Upload the assets. Different creatives require different types and quantities of assets; see Upload Assets for details. Each time you successfully upload an asset, you will get an assetIdenfitier in the response; you will use the stored file name and type to reference these assets in your creative, rather than a traditional ID.

Create a creative and assign appropriate values. Instantiate a Creative and set the proper

 type

; you cannot change a Creative object's type after you save it. Specify the assets by their AssetIdentifier and their

 role

 // Locate an advertiser landing page to use as a default. 
 LandingPage 
  
 defaultLandingPage 
  
 = 
  
 getAdvertiserLandingPage 
 ( 
 reporting 
 , 
  
 profileId 
 , 
  
 advertiserId 
 ); 
 // Create the creative structure. 
 Creative 
  
 creative 
  
 = 
  
 new 
  
 Creative 
 (); 
 creative 
 . 
 setAdvertiserId 
 ( 
 advertiserId 
 ); 
 creative 
 . 
 setName 
 ( 
 "Test HTML5 display creative" 
 ); 
 creative 
 . 
 setSize 
 ( 
 new 
  
 Size 
 (). 
 setId 
 ( 
 sizeId 
 )); 
 creative 
 . 
 setType 
 ( 
 "DISPLAY" 
 ); 
 // Upload the HTML5 asset. 
 CreativeAssetId 
  
 html5AssetId 
  
 = 
  
 CreativeAssetUtils 
 . 
 uploadAsset 
 ( 
 reporting 
 , 
  
 profileId 
 , 
  
 advertiserId 
 , 
  
 HTML5_ASSET_NAME 
 , 
  
 PATH_TO_HTML5_ASSET_FILE 
 , 
  
 "HTML" 
 ). 
 getAssetIdentifier 
 (); 
 CreativeAsset 
  
 html5Asset 
  
 = 
  
 new 
  
 CreativeAsset 
 (). 
 setAssetIdentifier 
 ( 
 html5AssetId 
 ). 
 setRole 
 ( 
 "PRIMARY" 
 ); 
 // Upload the backup image asset (note: asset type must be set to HTML_IMAGE). 
 CreativeAssetId 
  
 imageAssetId 
  
 = 
  
 CreativeAssetUtils 
 . 
 uploadAsset 
 ( 
 reporting 
 , 
  
 profileId 
 , 
  
 advertiserId 
 , 
  
 IMAGE_ASSET_NAME 
 , 
  
 PATH_TO_IMAGE_ASSET_FILE 
 , 
  
 "HTML_IMAGE" 
 ) 
  
 . 
 getAssetIdentifier 
 (); 
 CreativeAsset 
  
 backupImageAsset 
  
 = 
  
 new 
  
 CreativeAsset 
 (). 
 setAssetIdentifier 
 ( 
 imageAssetId 
 ). 
 setRole 
 ( 
 "BACKUP_IMAGE" 
 ); 
 // Add the creative assets. 
 creative 
 . 
 setCreativeAssets 
 ( 
 ImmutableList 
 . 
 of 
 ( 
 html5Asset 
 , 
  
 backupImageAsset 
 )); 
 // Configure the backup image. 
 creative 
 . 
 setBackupImageClickThroughUrl 
 ( 
  
 new 
  
 CreativeClickThroughUrl 
 (). 
 setLandingPageId 
 ( 
 defaultLandingPage 
 . 
 getId 
 ())); 
 creative 
 . 
 setBackupImageReportingLabel 
 ( 
 "backup" 
 ); 
 creative 
 . 
 setBackupImageTargetWindow 
 ( 
 new 
  
 TargetWindow 
 (). 
 setTargetWindowOption 
 ( 
 "NEW_WINDOW" 
 )); 
 // Add a click tag. 
 ClickTag 
  
 clickTag 
  
 = 
  
 new 
  
 ClickTag 
 (). 
 setName 
 ( 
 "clickTag" 
 ). 
 setEventName 
 ( 
 "exit" 
 ). 
 setClickThroughUrl 
 ( 
  
 new 
  
 CreativeClickThroughUrl 
 (). 
 setLandingPageId 
 ( 
 defaultLandingPage 
 . 
 getId 
 ())); 
 creative 
 . 
 setClickTags 
 ( 
 ImmutableList 
 . 
 of 
 ( 
 clickTag 
 ));

Save the creative. Do this by calling

 creatives.insert()

. It is required to specify an advertiser ID with which to associate this creative.

 Creative 
  
 result 
  
 = 
  
 reporting 
 . 
 creatives 
 (). 
 insert 
 ( 
 profileId 
 , 
  
 creative 
 ). 
 execute 
 ();

(Optional) Associate the creative with a campaign. This can be done by calling

 campaignCreativeAssociations.insert()

, passing in the campaign and creative IDs.

 // Create the campaign creative association structure. 
 CampaignCreativeAssociation 
  
 association 
  
 = 
  
 new 
  
 CampaignCreativeAssociation 
 (); 
 association 
 . 
 setCreativeId 
 ( 
 creativeId 
 ); 
 // Insert the association. 
 CampaignCreativeAssociation 
  
 result 
  
 = 
  
 reporting 
  
 . 
 campaignCreativeAssociations 
 (). 
 insert 
 ( 
 profileId 
 , 
  
 campaignId 
 , 
  
 association 
 ) 
  
 . 
 execute 
 ();

PHP

Upload the assets. Different creatives require different types and quantities of assets; see Upload Assets for details. Each time you successfully upload an asset, you will get an assetIdenfitier in the response; you will use the stored file name and type to reference these assets in your creative, rather than a traditional ID.

Create a creative and assign appropriate values. Instantiate a Creative and set the proper

 type

; you cannot change a Creative object's type after you save it. Specify the assets by their AssetIdentifier and their

 role

 $creative = new Google_Service_Dfareporting_Creative(); 
 $creative->setAdvertiserId($values['advertiser_id']); 
 $creative->setAutoAdvanceImages(true); 
 $creative->setName('Test HTML5 display creative'); 
 $creative->setType('DISPLAY'); 
 $size = new Google_Service_Dfareporting_Size(); 
 $size->setId($values['size_id']); 
 $creative->setSize($size); 
 // Upload the HTML5 asset. 
 $html = uploadAsset( 
 $this->service, 
 $values['user_profile_id'], 
 $values['advertiser_id'], 
 $values['html_asset_file'], 
 'HTML' 
 ); 
 $htmlAsset = new Google_Service_Dfareporting_CreativeAsset(); 
 $htmlAsset->setAssetIdentifier($html->getAssetIdentifier()); 
 $htmlAsset->setRole('PRIMARY'); 
 // Upload the backup image asset. 
 $image = uploadAsset( 
 $this->service, 
 $values['user_profile_id'], 
 $values['advertiser_id'], 
 $values['image_asset_file'], 
 'HTML_IMAGE' 
 ); 
 $imageAsset = new Google_Service_Dfareporting_CreativeAsset(); 
 $imageAsset->setAssetIdentifier($image->getAssetIdentifier()); 
 $imageAsset->setRole('BACKUP_IMAGE'); 
 // Add the creative assets. 
 $creative->setCreativeAssets([$htmlAsset, $imageAsset]); 
 // Configure the default click-through URL. 
 $clickThroughUrl = 
 new Google_Service_Dfareporting_CreativeClickThroughUrl(); 
 $clickThroughUrl->setLandingPageId($values['landing_page_id']); 
 // Configure the backup image. 
 $creative->setBackupImageClickThroughUrl($clickThroughUrl); 
 $creative->setBackupImageReportingLabel('backup'); 
 $targetWindow = new Google_Service_Dfareporting_TargetWindow(); 
 $targetWindow->setTargetWindowOption('NEW_WINDOW'); 
 $creative->setBackupImageTargetWindow($targetWindow); 
 // Add a click tag. 
 $clickTag = new Google_Service_Dfareporting_ClickTag(); 
 $clickTag->setName('clickTag'); 
 $clickTag->setEventName('exit'); 
 $clickTag->setClickThroughUrl($clickThroughUrl); 
 $creative->setClickTags([$clickTag]);

Save the creative. Do this by calling creatives.insert() . It is required to specify an advertiser ID with which to associate this creative.
```
 $result = $this->service->creatives->insert( 
 $values['user_profile_id'], 
 $creative 
 ); 
```

(Optional) Associate the creative with a campaign. This can be done by calling

 campaignCreativeAssociations.insert()

, passing in the campaign and creative IDs.

 $association = 
 new Google_Service_Dfareporting_CampaignCreativeAssociation(); 
 $association->setCreativeId($values['creative_id']); 
 $result = $this->service->campaignCreativeAssociations->insert( 
 $values['user_profile_id'], 
 $values['campaign_id'], 
 $association 
 );

Python

Upload the assets. Different creatives require different types and quantities of assets; see Upload Assets for details. Each time you successfully upload an asset, you will get an assetIdenfitier in the response; you will use the stored file name and type to reference these assets in your creative, rather than a traditional ID.

Create a creative and assign appropriate values. Instantiate a Creative and set the proper

 type

; you cannot change a Creative object's type after you save it. Specify the assets by their AssetIdentifier and their

 role

 # Locate an advertiser landing page to use as a default. 
 default_landing_page 
 = 
 get_advertiser_landing_page 
 ( 
 service 
 , 
 profile_id 
 , 
 advertiser_id 
 ) 
 # Upload the HTML5 asset 
 html5_asset_id 
 = 
 upload_creative_asset 
 ( 
 service 
 , 
 profile_id 
 , 
 advertiser_id 
 , 
 html5_asset_name 
 , 
 path_to_html5_asset_file 
 , 
 'HTML' 
 ) 
 # Upload the backup image asset 
 backup_image_asset_id 
 = 
 upload_creative_asset 
 ( 
 service 
 , 
 profile_id 
 , 
 advertiser_id 
 , 
 backup_image_name 
 , 
 path_to_backup_image_file 
 , 
 'HTML_IMAGE' 
 ) 
 # Construct the creative structure. 
 creative 
 = 
 { 
 'advertiserId' 
 : 
 advertiser_id 
 , 
 'backupImageClickThroughUrl' 
 : 
 { 
 'landingPageId' 
 : 
 default_landing_page 
 [ 
 'id' 
 ] 
 }, 
 'backupImageReportingLabel' 
 : 
 'backup_image_exit' 
 , 
 'backupImageTargetWindow' 
 : 
 { 
 'targetWindowOption' 
 : 
 'NEW_WINDOW' 
 }, 
 'clickTags' 
 : 
 [{ 
 'eventName' 
 : 
 'exit' 
 , 
 'name' 
 : 
 'click_tag' 
 , 
 'clickThroughUrl' 
 : 
 { 
 'landingPageId' 
 : 
 default_landing_page 
 [ 
 'id' 
 ]} 
 }], 
 'creativeAssets' 
 : 
 [ 
 { 
 'assetIdentifier' 
 : 
 html5_asset_id 
 , 
 'role' 
 : 
 'PRIMARY' 
 }, 
 { 
 'assetIdentifier' 
 : 
 backup_image_asset_id 
 , 
 'role' 
 : 
 'BACKUP_IMAGE' 
 } 
 ], 
 'name' 
 : 
 'Test HTML5 display creative' 
 , 
 'size' 
 : 
 { 
 'id' 
 : 
 size_id 
 }, 
 'type' 
 : 
 'DISPLAY' 
 }

Save the creative. Do this by calling

 creatives.insert()

. It is required to specify an advertiser ID with which to associate this creative.

 request 
 = 
 service 
 . 
 creatives 
 () 
 . 
 insert 
 ( 
 profileId 
 = 
 profile_id 
 , 
 body 
 = 
 creative 
 ) 
 # Execute request and print response. 
 response 
 = 
 request 
 . 
 execute 
 ()

(Optional) Associate the creative with a campaign. This can be done by calling

 campaignCreativeAssociations.insert()

, passing in the campaign and creative IDs.

 # Construct the request. 
 association 
 = 
 { 
 'creativeId' 
 : 
 creative_id 
 } 
 request 
 = 
 service 
 . 
 campaignCreativeAssociations 
 () 
 . 
 insert 
 ( 
 profileId 
 = 
 profile_id 
 , 
 campaignId 
 = 
 campaign_id 
 , 
 body 
 = 
 association 
 ) 
 # Execute request and print response. 
 response 
 = 
 request 
 . 
 execute 
 ()

Ruby

Upload the assets. Different creatives require different types and quantities of assets; see Upload Assets for details. Each time you successfully upload an asset, you will get an assetIdenfitier in the response; you will use the stored file name and type to reference these assets in your creative, rather than a traditional ID.

Create a creative and assign appropriate values. Instantiate a Creative and set the proper

 type

; you cannot change a Creative object's type after you save it. Specify the assets by their AssetIdentifier and their

 role

 # Locate an advertiser landing page to use as a default. 
 default_landing_page 
  
 = 
  
 get_advertiser_landing_page 
 ( 
 service 
 , 
  
 profile_id 
 , 
  
 advertiser_id 
 ) 
 # Upload the HTML5 asset. 
 html5_asset_id 
  
 = 
  
 util 
 . 
 upload_asset 
 ( 
 advertiser_id 
 , 
  
 path_to_html5_asset_file 
 , 
  
 'HTML' 
 ) 
 . 
 asset_identifier 
 # Upload the backup image asset. 
 backup_image_asset_id 
  
 = 
  
 util 
 . 
 upload_asset 
 ( 
 advertiser_id 
 , 
  
 path_to_backup_image_file 
 , 
  
 'HTML_IMAGE' 
 ) 
 . 
 asset_identifier 
 # Construct the creative structure. 
 creative 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 Creative 
 . 
 new 
 ( 
  
 advertiser_id 
 : 
  
 advertiser_id 
 , 
  
 backup_image_click_through_url 
 : 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 CreativeClickThroughUrl 
 . 
 new 
 ( 
  
 landing_page_id 
 : 
  
 default_landing_page 
 . 
 id 
  
 ), 
  
 backup_image_reporting_label 
 : 
  
 'backup' 
 , 
  
 backup_image_target_window 
 : 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 TargetWindow 
 . 
 new 
 ( 
  
 target_window_option 
 : 
  
 'NEW_WINDOW' 
  
 ), 
  
 click_tags 
 : 
  
 [ 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 ClickTag 
 . 
 new 
 ( 
  
 event_name 
 : 
  
 'exit' 
 , 
  
 name 
 : 
  
 'click_tag' 
 , 
  
 click_through_url 
 : 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 CreativeClickThroughUrl 
 . 
 new 
 ( 
  
 landing_page_id 
 : 
  
 default_landing_page 
 . 
 id 
  
 ) 
  
 ) 
  
 ] 
 , 
  
 creative_assets 
 : 
  
 [ 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 CreativeAsset 
 . 
 new 
 ( 
  
 asset_identifier 
 : 
  
 html5_asset_id 
 , 
  
 role 
 : 
  
 'PRIMARY' 
  
 ), 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 CreativeAsset 
 . 
 new 
 ( 
  
 asset_identifier 
 : 
  
 backup_image_asset_id 
 , 
  
 role 
 : 
  
 'BACKUP_IMAGE' 
  
 ) 
  
 ] 
 , 
  
 name 
 : 
  
 'Example HTML5 display creative' 
 , 
  
 size 
 : 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 Size 
 . 
 new 
 ( 
 id 
 : 
  
 size_id 
 ), 
  
 type 
 : 
  
 'DISPLAY' 
 )

Save the creative. Do this by calling

 creatives.insert()

. It is required to specify an advertiser ID with which to associate this creative.

 # Insert the creative. 
 result 
  
 = 
  
 service 
 . 
 insert_creative 
 ( 
 profile_id 
 , 
  
 creative 
 )

(Optional) Associate the creative with a campaign. This can be done by calling

 campaignCreativeAssociations.insert()

, passing in the campaign and creative IDs.

 # Create a new creative-campaign association to insert 
 association 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 CampaignCreativeAssociation 
 . 
 new 
 ( 
  
 creative_id 
 : 
  
 creative_id 
  
 ) 
 # Insert the advertiser group. 
 result 
  
 = 
  
 service 
 . 
 insert_campaign_creative_association 
 ( 
 profile_id 
 , 
  
 campaign_id 
 , 
  
 association 
 )

Create an ad

An Ad is the link between a Creative and a Placement . An Ad can be linked to one or more placements, and holds one or more creatives.

You can create an Ad explicitly or implicitly.

Explicitly

C#

Create a CreativeAssignment object for each creative with which this ad should be associated. Be sure to set the

 CreativeAssignment.active

field to true.

 // Create a click-through URL. 
 ClickThroughUrl 
  
 clickThroughUrl 
  
 = 
  
 new 
  
 ClickThroughUrl 
 (); 
 clickThroughUrl 
 . 
 DefaultLandingPage 
  
 = 
  
 true 
 ; 
 // Create a creative assignment. 
 CreativeAssignment 
  
 creativeAssignment 
  
 = 
  
 new 
  
 CreativeAssignment 
 (); 
 creativeAssignment 
 . 
 Active 
  
 = 
  
 true 
 ; 
 creativeAssignment 
 . 
 CreativeId 
  
 = 
  
 creativeId 
 ; 
 creativeAssignment 
 . 
 ClickThroughUrl 
  
 = 
  
 clickThroughUrl 
 ;

Create a CreativeRotation object to store the CreativeAssignment s. If creating a rotation group, be sure to set the other required creative rotation fields.

 // Create a creative rotation. 
 CreativeRotation 
  
 creativeRotation 
  
 = 
  
 new 
  
 CreativeRotation 
 (); 
 creativeRotation 
 . 
 CreativeAssignments 
  
 = 
  
 new 
  
 List<CreativeAssignment> 
 () 
  
 { 
  
 creativeAssignment 
 };

Create a PlacementAssignment object for each placement with which this ad should be associated. Be sure to set the

 PlacementAssignment.active

field to true.

 // Create a placement assignment. 
 PlacementAssignment 
  
 placementAssignment 
  
 = 
  
 new 
  
 PlacementAssignment 
 (); 
 placementAssignment 
 . 
 Active 
  
 = 
  
 true 
 ; 
 placementAssignment 
 . 
 PlacementId 
  
 = 
  
 placementId 
 ;

Create an Ad object. Set the creativeRotation into the Ad object's

 creativeRotation

field and the placementAssignments into the Ad object's

 placementAssignments

array.

 // Create a delivery schedule. 
 DeliverySchedule 
  
 deliverySchedule 
  
 = 
  
 new 
  
 DeliverySchedule 
 (); 
 deliverySchedule 
 . 
 ImpressionRatio 
  
 = 
  
 1 
 ; 
 deliverySchedule 
 . 
 Priority 
  
 = 
  
 "AD_PRIORITY_01" 
 ; 
 DateTime 
  
 startDate 
  
 = 
  
 DateTime 
 . 
 Now 
 ; 
 DateTime 
  
 endDate 
  
 = 
  
 Convert 
 . 
 ToDateTime 
 ( 
 campaign 
 . 
 EndDate 
 ); 
 // Create a rotation group. 
 Ad 
  
 rotationGroup 
  
 = 
  
 new 
  
 Ad 
 (); 
 rotationGroup 
 . 
 Active 
  
 = 
  
 true 
 ; 
 rotationGroup 
 . 
 CampaignId 
  
 = 
  
 campaignId 
 ; 
 rotationGroup 
 . 
 CreativeRotation 
  
 = 
  
 creativeRotation 
 ; 
 rotationGroup 
 . 
 DeliverySchedule 
  
 = 
  
 deliverySchedule 
 ; 
 rotationGroup 
 . 
 StartTime 
  
 = 
  
 startDate 
 ; 
 rotationGroup 
 . 
 EndTime 
  
 = 
  
 endDate 
 ; 
 rotationGroup 
 . 
 Name 
  
 = 
  
 adName 
 ; 
 rotationGroup 
 . 
 PlacementAssignments 
  
 = 
  
 new 
  
 List<PlacementAssignment> 
 () 
  
 { 
  
 placementAssignment 
 }; 
 rotationGroup 
 . 
 Type 
  
 = 
  
 "AD_SERVING_STANDARD_AD" 
 ;

Save the ad by calling

 ads.insert()

 // Insert the rotation group. 
 Ad 
  
 result 
  
 = 
  
 service 
 . 
 Ads 
 . 
 Insert 
 ( 
 rotationGroup 
 , 
  
 profileId 
 ). 
 Execute 
 ();

Java

Create a CreativeAssignment object for each creative with which this ad should be associated. Be sure to set the

 CreativeAssignment.active

field to true.

 // Create a click-through URL. 
 ClickThroughUrl 
  
 clickThroughUrl 
  
 = 
  
 new 
  
 ClickThroughUrl 
 (); 
 clickThroughUrl 
 . 
 setDefaultLandingPage 
 ( 
 true 
 ); 
 // Create a creative assignment. 
 CreativeAssignment 
  
 creativeAssignment 
  
 = 
  
 new 
  
 CreativeAssignment 
 (); 
 creativeAssignment 
 . 
 setActive 
 ( 
 true 
 ); 
 creativeAssignment 
 . 
 setCreativeId 
 ( 
 creativeId 
 ); 
 creativeAssignment 
 . 
 setClickThroughUrl 
 ( 
 clickThroughUrl 
 );

Create a CreativeRotation object to store the CreativeAssignment s. If creating a rotation group, be sure to set the other required creative rotation fields.

 // Create a creative rotation. 
 CreativeRotation 
  
 creativeRotation 
  
 = 
  
 new 
  
 CreativeRotation 
 (); 
 creativeRotation 
 . 
 setCreativeAssignments 
 ( 
 ImmutableList 
 . 
 of 
 ( 
 creativeAssignment 
 ));

Create a PlacementAssignment object for each placement with which this ad should be associated. Be sure to set the

 PlacementAssignment.active

field to true.

 // Create a placement assignment. 
 PlacementAssignment 
  
 placementAssignment 
  
 = 
  
 new 
  
 PlacementAssignment 
 (); 
 placementAssignment 
 . 
 setActive 
 ( 
 true 
 ); 
 placementAssignment 
 . 
 setPlacementId 
 ( 
 placementId 
 );

Create an Ad object. Set the creativeRotation into the Ad object's

 creativeRotation

field and the placementAssignments into the Ad object's

 placementAssignments

array.

 // Create a delivery schedule. 
 DeliverySchedule 
  
 deliverySchedule 
  
 = 
  
 new 
  
 DeliverySchedule 
 (); 
 deliverySchedule 
 . 
 setImpressionRatio 
 ( 
 1L 
 ); 
 deliverySchedule 
 . 
 setPriority 
 ( 
 "AD_PRIORITY_01" 
 ); 
 DateTime 
  
 startDate 
  
 = 
  
 new 
  
 DateTime 
 ( 
 new 
  
 Date 
 ()); 
 DateTime 
  
 endDate 
  
 = 
  
 new 
  
 DateTime 
 ( 
 campaign 
 . 
 getEndDate 
 (). 
 getValue 
 ()); 
 // Create a rotation group. 
 Ad 
  
 rotationGroup 
  
 = 
  
 new 
  
 Ad 
 (); 
 rotationGroup 
 . 
 setActive 
 ( 
 true 
 ); 
 rotationGroup 
 . 
 setCampaignId 
 ( 
 campaignId 
 ); 
 rotationGroup 
 . 
 setCreativeRotation 
 ( 
 creativeRotation 
 ); 
 rotationGroup 
 . 
 setDeliverySchedule 
 ( 
 deliverySchedule 
 ); 
 rotationGroup 
 . 
 setStartTime 
 ( 
 startDate 
 ); 
 rotationGroup 
 . 
 setEndTime 
 ( 
 endDate 
 ); 
 rotationGroup 
 . 
 setName 
 ( 
 adName 
 ); 
 rotationGroup 
 . 
 setPlacementAssignments 
 ( 
 ImmutableList 
 . 
 of 
 ( 
 placementAssignment 
 )); 
 rotationGroup 
 . 
 setType 
 ( 
 "AD_SERVING_STANDARD_AD" 
 );

Save the ad by calling

 ads.insert()

 // Insert the rotation group. 
 Ad 
  
 result 
  
 = 
  
 reporting 
 . 
 ads 
 (). 
 insert 
 ( 
 profileId 
 , 
  
 rotationGroup 
 ). 
 execute 
 ();

PHP

Create a CreativeAssignment object for each creative with which this ad should be associated. Be sure to set the

 CreativeAssignment.active

field to true.

 // Create a click-through URL. 
 $url = new Google_Service_Dfareporting_ClickThroughUrl(); 
 $url->setDefaultLandingPage(true); 
 // Create a creative assignment. 
 $creativeAssignment = 
 new Google_Service_Dfareporting_CreativeAssignment(); 
 $creativeAssignment->setActive(true); 
 $creativeAssignment->setCreativeId($values['creative_id']); 
 $creativeAssignment->setClickThroughUrl($url);

Create a CreativeRotation object to store the CreativeAssignment s. If creating a rotation group, be sure to set the other required creative rotation fields.

 // Create a creative rotation. 
 $creativeRotation = new Google_Service_Dfareporting_CreativeRotation(); 
 $creativeRotation->setCreativeAssignments([$creativeAssignment]);

Create a PlacementAssignment object for each placement with which this ad should be associated. Be sure to set the

 PlacementAssignment.active

field to true.

 // Create a placement assignment. 
 $placementAssignment = 
 new Google_Service_Dfareporting_PlacementAssignment(); 
 $placementAssignment->setActive(true); 
 $placementAssignment->setPlacementId($values['placement_id']);

Create an Ad object. Set the creativeRotation into the Ad object's

 creativeRotation

field and the placementAssignments into the Ad object's

 placementAssignments

array.

 // Create a delivery schedule. 
 $deliverySchedule = new Google_Service_Dfareporting_DeliverySchedule(); 
 $deliverySchedule->setImpressionRatio(1); 
 $deliverySchedule->SetPriority('AD_PRIORITY_01'); 
 $startDate = new DateTime('today'); 
 $endDate = new DateTime($campaign->getEndDate()); 
 // Create a rotation group. 
 $ad = new Google_Service_Dfareporting_Ad(); 
 $ad->setActive(true); 
 $ad->setCampaignId($values['campaign_id']); 
 $ad->setCreativeRotation($creativeRotation); 
 $ad->setDeliverySchedule($deliverySchedule); 
 $ad->setStartTime($startDate->format('Y-m-d') . 'T23:59:59Z'); 
 $ad->setEndTime($endDate->format('Y-m-d') . 'T00:00:00Z'); 
 $ad->setName($values['ad_name']); 
 $ad->setPlacementAssignments([$placementAssignment]); 
 $ad->setType('AD_SERVING_STANDARD_AD');

Save the ad by calling

 ads.insert()

 $result = $this->service->ads->insert($values['user_profile_id'], $ad);

Python

Create a CreativeAssignment object for each creative with which this ad should be associated. Be sure to set the

 CreativeAssignment.active

field to true.

 # Construct creative assignment. 
 creative_assignment 
 = 
 { 
 'active' 
 : 
 'true' 
 , 
 'creativeId' 
 : 
 creative_id 
 , 
 'clickThroughUrl' 
 : 
 { 
 'defaultLandingPage' 
 : 
 'true' 
 } 
 }

Create a CreativeRotation object to store the CreativeAssignment s. If creating a rotation group, be sure to set the other required creative rotation fields.

 # Construct creative rotation. 
 creative_rotation 
 = 
 { 
 'creativeAssignments' 
 : 
 [ 
 creative_assignment 
 ], 
 'type' 
 : 
 'CREATIVE_ROTATION_TYPE_RANDOM' 
 , 
 'weightCalculationStrategy' 
 : 
 'WEIGHT_STRATEGY_OPTIMIZED' 
 }

Create a PlacementAssignment object for each placement with which this ad should be associated. Be sure to set the

 PlacementAssignment.active

field to true.

 # Construct placement assignment. 
 placement_assignment 
 = 
 { 
 'active' 
 : 
 'true' 
 , 
 'placementId' 
 : 
 placement_id 
 , 
 }

Create an Ad object. Set the creativeRotation into the Ad object's

 creativeRotation

field and the placementAssignments into the Ad object's

 placementAssignments

array.

 # Construct delivery schedule. 
 delivery_schedule 
 = 
 { 
 'impressionRatio' 
 : 
 '1' 
 , 
 'priority' 
 : 
 'AD_PRIORITY_01' 
 } 
 # Construct and save ad. 
 ad 
 = 
 { 
 'active' 
 : 
 'true' 
 , 
 'campaignId' 
 : 
 campaign_id 
 , 
 'creativeRotation' 
 : 
 creative_rotation 
 , 
 'deliverySchedule' 
 : 
 delivery_schedule 
 , 
 'endTime' 
 : 
 ' 
 %s 
 T00:00:00Z' 
 % 
 campaign 
 [ 
 'endDate' 
 ], 
 'name' 
 : 
 'Test Rotation Group' 
 , 
 'placementAssignments' 
 : 
 [ 
 placement_assignment 
 ], 
 'startTime' 
 : 
 ' 
 %s 
 T23:59:59Z' 
 % 
 time 
 . 
 strftime 
 ( 
 '%Y-%m- 
 %d 
 ' 
 ), 
 'type' 
 : 
 'AD_SERVING_STANDARD_AD' 
 }

Save the ad by calling

 ads.insert()

 request 
 = 
 service 
 . 
 ads 
 () 
 . 
 insert 
 ( 
 profileId 
 = 
 profile_id 
 , 
 body 
 = 
 ad 
 ) 
 # Execute request and print response. 
 response 
 = 
 request 
 . 
 execute 
 ()

Ruby

Create a CreativeAssignment object for each creative with which this ad should be associated. Be sure to set the

 CreativeAssignment.active

field to true.

 # Construct creative assignment. 
 creative_assignment 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 CreativeAssignment 
 . 
 new 
 ( 
  
 active 
 : 
  
 true 
 , 
  
 creative_id 
 : 
  
 creative_id 
 , 
  
 click_through_url 
 : 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 ClickThroughUrl 
 . 
 new 
 ( 
  
 default_landing_page 
 : 
  
 true 
  
 ) 
  
 )

Create a CreativeRotation object to store the CreativeAssignment s. If creating a rotation group, be sure to set the other required creative rotation fields.

 # Construct creative rotation. 
 creative_rotation 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 CreativeRotation 
 . 
 new 
 ( 
  
 creative_assignments 
 : 
  
 [ 
 creative_assignment 
 ] 
 , 
  
 type 
 : 
  
 'CREATIVE_ROTATION_TYPE_RANDOM' 
 , 
  
 weight_calculation_strategy 
 : 
  
 'WEIGHT_STRATEGY_OPTIMIZED' 
 )

Create a PlacementAssignment object for each placement with which this ad should be associated. Be sure to set the

 PlacementAssignment.active

field to true.

 # Construct placement assignment. 
 placement_assignment 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 PlacementAssignment 
 . 
 new 
 ( 
  
 active 
 : 
  
 true 
 , 
  
 placement_id 
 : 
  
 placement_id 
  
 )

Create an Ad object. Set the creativeRotation into the Ad object's

 creativeRotation

field and the placementAssignments into the Ad object's

 placementAssignments

array.

 # Construct delivery schedule. 
 delivery_schedule 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 DeliverySchedule 
 . 
 new 
 ( 
  
 impression_ratio 
 : 
  
 1 
 , 
  
 priority 
 : 
  
 'AD_PRIORITY_01' 
 ) 
 # Construct and save ad. 
 ad 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 Ad 
 . 
 new 
 ( 
  
 active 
 : 
  
 true 
 , 
  
 campaign_id 
 : 
  
 campaign_id 
 , 
  
 creative_rotation 
 : 
  
 creative_rotation 
 , 
  
 delivery_schedule 
 : 
  
 delivery_schedule 
 , 
  
 end_time 
 : 
  
 format 
 ( 
 '%sT00:00:00Z' 
 , 
  
 campaign 
 . 
 end_date 
 ), 
  
 name 
 : 
  
 'Example Rotation Group' 
 , 
  
 placement_assignments 
 : 
  
 [ 
 placement_assignment 
 ] 
 , 
  
 start_time 
 : 
  
 format 
 ( 
 '%sT23:59:59Z' 
 , 
  
 Time 
 . 
 now 
 . 
 strftime 
 ( 
 '%Y-%m-%d' 
 )), 
  
 type 
 : 
  
 'AD_SERVING_STANDARD_AD' 
 )

Save the ad by calling

 ads.insert()

 result 
  
 = 
  
 service 
 . 
 insert_ad 
 ( 
 profile_id 
 , 
  
 ad 
 )

Implicitly

C#

Create and save a Placement .
Create and save a Creative .

Associate the Creative with the same Campaign used for the Placement by calling

 campaignCreativeAssociations.insert()

(see step 4 in the Creating a creative section). This will create a default ad associated with both the creative and placement.

 // Create the campaign creative association structure. 
 CampaignCreativeAssociation 
  
 association 
  
 = 
  
 new 
  
 CampaignCreativeAssociation 
 (); 
 association 
 . 
 CreativeId 
  
 = 
  
 creativeId 
 ; 
 // Insert the association. 
 CampaignCreativeAssociation 
  
 result 
  
 = 
  
 service 
 . 
 CampaignCreativeAssociations 
 . 
 Insert 
 ( 
 association 
 , 
  
 profileId 
 , 
  
 campaignId 
 ). 
 Execute 
 ();

Java

Create and save a Placement .
Create and save a Creative .

Associate the Creative with the same Campaign used for the Placement by calling

 campaignCreativeAssociations.insert()

(see step 4 in the Creating a creative section). This will create a default ad associated with both the creative and placement.

 // Create the campaign creative association structure. 
 CampaignCreativeAssociation 
  
 association 
  
 = 
  
 new 
  
 CampaignCreativeAssociation 
 (); 
 association 
 . 
 setCreativeId 
 ( 
 creativeId 
 ); 
 // Insert the association. 
 CampaignCreativeAssociation 
  
 result 
  
 = 
  
 reporting 
  
 . 
 campaignCreativeAssociations 
 (). 
 insert 
 ( 
 profileId 
 , 
  
 campaignId 
 , 
  
 association 
 ) 
  
 . 
 execute 
 ();

PHP

Create and save a Placement .
Create and save a Creative .

Associate the Creative with the same Campaign used for the Placement by calling

 campaignCreativeAssociations.insert()

(see step 4 in the Creating a creative section). This will create a default ad associated with both the creative and placement.

 $association = 
 new Google_Service_Dfareporting_CampaignCreativeAssociation(); 
 $association->setCreativeId($values['creative_id']); 
 $result = $this->service->campaignCreativeAssociations->insert( 
 $values['user_profile_id'], 
 $values['campaign_id'], 
 $association 
 );

Python

Create and save a Placement .
Create and save a Creative .

Associate the Creative with the same Campaign used for the Placement by calling

 campaignCreativeAssociations.insert()

(see step 4 in the Creating a creative section). This will create a default ad associated with both the creative and placement.

 # Construct the request. 
 association 
 = 
 { 
 'creativeId' 
 : 
 creative_id 
 } 
 request 
 = 
 service 
 . 
 campaignCreativeAssociations 
 () 
 . 
 insert 
 ( 
 profileId 
 = 
 profile_id 
 , 
 campaignId 
 = 
 campaign_id 
 , 
 body 
 = 
 association 
 ) 
 # Execute request and print response. 
 response 
 = 
 request 
 . 
 execute 
 ()

Ruby

Create and save a Placement .
Create and save a Creative .

Associate the Creative with the same Campaign used for the Placement by calling

 campaignCreativeAssociations.insert()

(see step 4 in the Creating a creative section). This will create a default ad associated with both the creative and placement.

 # Create a new creative-campaign association to insert 
 association 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 CampaignCreativeAssociation 
 . 
 new 
 ( 
  
 creative_id 
 : 
  
 creative_id 
  
 ) 
 # Insert the advertiser group. 
 result 
  
 = 
  
 service 
 . 
 insert_campaign_creative_association 
 ( 
 profile_id 
 , 
  
 campaign_id 
 , 
  
 association 
 )

Creating an ad implicitly saves the extra step of creating an Ad . Note that this can only be done if no default ad of the specified size already exists within your campaign.

Search for objects

You can search for objects by calling the list() operation exposed by the service that defines the object to find, specifying optional criteria appropriate for that object type. So, for example, to search for Ad objects, you would call ads.list() . The optional criteria expose a set of properties appropriate for that object; fill out as many properties as you want to search on. The search will return only objects that fulfill all of your criteria; you cannot do a search that matches any criteria. Strings support the * wildcard, are not case-sensitive, and match within larger strings.

To improve performance, partial responses can be requested using the fields parameter. This instructs the server to return only the fields you specify, rather than the full resource representation. More info on this topic can be found in the Performance Tips guide.

Paging

Sometimes it's not desirable to retrieve all of the results for a list() request. For example, you may only be interested in the 10 newest Ads from a pool of thousands. To help with this, many list() methods allow you to request fewer results via a process known as paging.

Methods that support paging return subsets of results in groups called pages . The maximum number of results per page is 1,000 (the default). You can change the number of results per page by setting the maxResults , and you can iterate through pages using the nextPageToken returned in the response:

C#

 // Limit the fields returned. 
 String 
  
 fields 
  
 = 
  
 "nextPageToken,ads(advertiserId,id,name)" 
 ; 
 AdsListResponse 
  
 result 
 ; 
 String 
  
 nextPageToken 
  
 = 
  
 null 
 ; 
 do 
  
 { 
  
 // Create and execute the ad list request. 
  
 AdsResource 
 . 
 ListRequest 
  
 request 
  
 = 
  
 service 
 . 
 Ads 
 . 
 List 
 ( 
 profileId 
 ); 
  
 request 
 . 
 Active 
  
 = 
  
 true 
 ; 
  
 request 
 . 
 Fields 
  
 = 
  
 fields 
 ; 
  
 request 
 . 
 PageToken 
  
 = 
  
 nextPageToken 
 ; 
  
 result 
  
 = 
  
 request 
 . 
 Execute 
 (); 
  
 foreach 
  
 ( 
 Ad 
  
 ad 
  
 in 
  
 result 
 . 
 Ads 
 ) 
  
 { 
  
 Console 
 . 
 WriteLine 
 ( 
  
 "Ad with ID {0} and name \"{1}\" is associated with advertiser" 
  
 + 
  
 " ID {2}." 
 , 
  
 ad 
 . 
 Id 
 , 
  
 ad 
 . 
 Name 
 , 
  
 ad 
 . 
 AdvertiserId 
 ); 
  
 } 
  
 // Update the next page token. 
  
 nextPageToken 
  
 = 
  
 result 
 . 
 NextPageToken 
 ; 
 } 
  
 while 
  
 ( 
 result 
 . 
 Ads 
 . 
 Any 
 () 
 && 
 ! 
 String 
 . 
 IsNullOrEmpty 
 ( 
 nextPageToken 
 ));

Java

 // Limit the fields returned. 
 String 
  
 fields 
  
 = 
  
 "nextPageToken,ads(advertiserId,id,name)" 
 ; 
 AdsListResponse 
  
 result 
 ; 
 String 
  
 nextPageToken 
  
 = 
  
 null 
 ; 
 do 
  
 { 
  
 // Create and execute the ad list request. 
  
 result 
  
 = 
  
 reporting 
 . 
 ads 
 (). 
 list 
 ( 
 profileId 
 ). 
 setActive 
 ( 
 true 
 ). 
 setFields 
 ( 
 fields 
 ) 
  
 . 
 setPageToken 
 ( 
 nextPageToken 
 ). 
 execute 
 (); 
  
 for 
  
 ( 
 Ad 
  
 ad 
  
 : 
  
 result 
 . 
 getAds 
 ()) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
  
 "Ad with ID %d and name \"%s\" is associated with advertiser ID %d.%n" 
 , 
  
 ad 
 . 
 getId 
 (), 
  
 ad 
 . 
 getName 
 (), 
  
 ad 
 . 
 getAdvertiserId 
 ()); 
  
 } 
  
 // Update the next page token. 
  
 nextPageToken 
  
 = 
  
 result 
 . 
 getNextPageToken 
 (); 
 } 
  
 while 
  
 ( 
 ! 
 result 
 . 
 getAds 
 (). 
 isEmpty 
 () 
 && 
 ! 
 Strings 
 . 
 isNullOrEmpty 
 ( 
 nextPageToken 
 ));

PHP

 $response = null; 
 $pageToken = null; 
 do { 
 // Create and execute the ads list request. 
 $response = $this->service->ads->listAds( 
 $values['user_profile_id'], 
 ['active' => true, 'pageToken' => $pageToken] 
 ); 
 foreach ($response->getAds() as $ads) { 
 $this->printResultsTableRow($ads); 
 } 
 // Update the next page token. 
 $pageToken = $response->getNextPageToken(); 
 } while (!empty($response->getAds()) && !empty($pageToken));

Python

 # Construct the request. 
 request 
 = 
 service 
 . 
 ads 
 () 
 . 
 list 
 ( 
 profileId 
 = 
 profile_id 
 , 
 active 
 = 
 True 
 ) 
 while 
 True 
 : 
 # Execute request and print response. 
 response 
 = 
 request 
 . 
 execute 
 () 
 for 
 ad 
 in 
 response 
 [ 
 'ads' 
 ]: 
 print 
 'Found ad with ID 
 %s 
 and name " 
 %s 
 ".' 
 % 
 ( 
 ad 
 [ 
 'id' 
 ], 
 ad 
 [ 
 'name' 
 ]) 
 if 
 response 
 [ 
 'ads' 
 ] 
 and 
 response 
 [ 
 'nextPageToken' 
 ]: 
 request 
 = 
 service 
 . 
 ads 
 () 
 . 
 list_next 
 ( 
 request 
 , 
 response 
 ) 
 else 
 : 
 break

Ruby

 token 
  
 = 
  
 nil 
 loop 
  
 do 
  
 result 
  
 = 
  
 service 
 . 
 list_ads 
 ( 
 profile_id 
 , 
  
 page_token 
 : 
  
 token 
 , 
  
 fields 
 : 
  
 'nextPageToken,ads(id,name)' 
 ) 
  
 # Display results. 
  
 if 
  
 result 
 . 
 ads 
 . 
 any? 
  
 result 
 . 
 ads 
 . 
 each 
  
 do 
  
 | 
 ad 
 | 
  
 puts 
  
 format 
 ( 
 'Found ad with ID %d and name "%s".' 
 , 
  
 ad 
 . 
 id 
 , 
  
 ad 
 . 
 name 
 ) 
  
 end 
  
 token 
  
 = 
  
 result 
 . 
 next_page_token 
  
 else 
  
 # Stop paging if there are no more results. 
  
 token 
  
 = 
  
 nil 
  
 end 
  
 break 
  
 if 
  
 token 
 . 
 to_s 
 . 
 empty? 
 end

Generate floodlight tags

Floodlight tags are HTML tags embedded in a page, which are used to track user actions (e.g., purchases) within a site. To generate floodlight tags, you need a FloodlightActivity that belongs to a FloodlightActivityGroup :

C#

Create a new floodlight activity group, passing in values for

 name

 type

, and

 floodlightConfigurationId

 // Create the floodlight activity group. 
 FloodlightActivityGroup 
  
 floodlightActivityGroup 
  
 = 
  
 new 
  
 FloodlightActivityGroup 
 (); 
 floodlightActivityGroup 
 . 
 Name 
  
 = 
  
 groupName 
 ; 
 floodlightActivityGroup 
 . 
 FloodlightConfigurationId 
  
 = 
  
 floodlightConfigurationId 
 ; 
 floodlightActivityGroup 
 . 
 Type 
  
 = 
  
 "COUNTER" 
 ;

Save the floodlight activity group by calling

 floodlightActivityGroups.insert()

, which will return the ID of the new group.

 // Insert the activity group. 
 FloodlightActivityGroup 
  
 result 
  
 = 
  
 service 
 . 
 FloodlightActivityGroups 
 . 
 Insert 
 ( 
 floodlightActivityGroup 
 , 
  
 profileId 
 ). 
 Execute 
 ();

Create a new floodlight activity, and assign it the ID of the floodlight activity group that you just created, as well as all other required fields.

 // Set floodlight activity structure. 
 FloodlightActivity 
  
 activity 
  
 = 
  
 new 
  
 FloodlightActivity 
 (); 
 activity 
 . 
 CountingMethod 
  
 = 
  
 "STANDARD_COUNTING" 
 ; 
 activity 
 . 
 Name 
  
 = 
  
 activityName 
 ; 
 activity 
 . 
 FloodlightActivityGroupId 
  
 = 
  
 activityGroupId 
 ; 
 activity 
 . 
 FloodlightTagType 
  
 = 
  
 "GLOBAL_SITE_TAG" 
 ; 
 activity 
 . 
 ExpectedUrl 
  
 = 
  
 url 
 ;

Save the new activity by calling

 floodlightActivities.insert()

, which will return the ID of the new activity.

 // Create the floodlight tag activity. 
 FloodlightActivity 
  
 result 
  
 = 
  
 service 
 . 
 FloodlightActivities 
 . 
 Insert 
 ( 
 activity 
 , 
  
 profileId 
 ). 
 Execute 
 ();

Generate the tags by calling

 floodlightActivities.generatetag()

with the floodlightActivityId of your new activity. Send the tags to the webmaster at the advertiser's website.

 // Generate the floodlight activity tag. 
 FloodlightActivitiesResource 
 . 
 GeneratetagRequest 
  
 request 
  
 = 
  
 service 
 . 
 FloodlightActivities 
 . 
 Generatetag 
 ( 
 profileId 
 ); 
 request 
 . 
 FloodlightActivityId 
  
 = 
  
 activityId 
 ; 
 FloodlightActivitiesGenerateTagResponse 
  
 response 
  
 = 
  
 request 
 . 
 Execute 
 ();

Java

Create a new floodlight activity group, passing in values for

 name

 type

, and

 floodlightConfigurationId

 // Create the floodlight activity group. 
 FloodlightActivityGroup 
  
 floodlightActivityGroup 
  
 = 
  
 new 
  
 FloodlightActivityGroup 
 (); 
 floodlightActivityGroup 
 . 
 setName 
 ( 
 groupName 
 ); 
 floodlightActivityGroup 
 . 
 setFloodlightConfigurationId 
 ( 
 floodlightConfigurationId 
 ); 
 floodlightActivityGroup 
 . 
 setType 
 ( 
 "COUNTER" 
 );

Save the floodlight activity group by calling

 floodlightActivityGroups.insert()

, which will return the ID of the new group.

 // Insert the activity group. 
 FloodlightActivityGroup 
  
 result 
  
 = 
  
 reporting 
 . 
 floodlightActivityGroups 
 (). 
 insert 
 ( 
 profileId 
 , 
  
 floodlightActivityGroup 
 ). 
 execute 
 ();

Create a new floodlight activity, and assign it the ID of the floodlight activity group that you just created, as well as all other required fields.

 // Set floodlight activity structure. 
 FloodlightActivity 
  
 activity 
  
 = 
  
 new 
  
 FloodlightActivity 
 (); 
 activity 
 . 
 setName 
 ( 
 activityName 
 ); 
 activity 
 . 
 setCountingMethod 
 ( 
 "STANDARD_COUNTING" 
 ); 
 activity 
 . 
 setExpectedUrl 
 ( 
 url 
 ); 
 activity 
 . 
 setFloodlightActivityGroupId 
 ( 
 activityGroupId 
 ); 
 activity 
 . 
 setFloodlightTagType 
 ( 
 "GLOBAL_SITE_TAG" 
 );

Save the new activity by calling

 floodlightActivities.insert()

, which will return the ID of the new activity.

 // Create the floodlight tag activity. 
 FloodlightActivity 
  
 result 
  
 = 
  
 reporting 
 . 
 floodlightActivities 
 (). 
 insert 
 ( 
 profileId 
 , 
  
 activity 
 ). 
 execute 
 ();

Generate the tags by calling

 floodlightActivities.generatetag()

with the floodlightActivityId of your new activity. Send the tags to the webmaster at the advertiser's website.

 // Generate the floodlight activity tag. 
 Generatetag 
  
 request 
  
 = 
  
 reporting 
 . 
 floodlightActivities 
 (). 
 generatetag 
 ( 
 profileId 
 ); 
 request 
 . 
 setFloodlightActivityId 
 ( 
 activityId 
 ); 
 FloodlightActivitiesGenerateTagResponse 
  
 response 
  
 = 
  
 request 
 . 
 execute 
 ();

PHP

Create a new floodlight activity group, passing in values for

 name

 type

, and

 floodlightConfigurationId

 $group = new Google_Service_Dfareporting_FloodlightActivityGroup(); 
 $group->setFloodlightConfigurationId($values['configuration_id']); 
 $group->setName($values['group_name']); 
 $group->setType('COUNTER');

Save the floodlight activity group by calling floodlightActivityGroups.insert() , which will return the ID of the new group.
```
 $result = $this->service->floodlightActivityGroups->insert( 
 $values['user_profile_id'], 
 $group 
 ); 
```

Create a new floodlight activity, and assign it the ID of the floodlight activity group that you just created, as well as all other required fields.

 $activity = new Google_Service_Dfareporting_FloodlightActivity(); 
 $activity->setCountingMethod('STANDARD_COUNTING'); 
 $activity->setExpectedUrl($values['url']); 
 $activity->setFloodlightActivityGroupId($values['activity_group_id']); 
 $activity->setFloodlightTagType('GLOBAL_SITE_TAG'); 
 $activity->setName($values['activity_name']);

Save the new activity by calling

 floodlightActivities.insert()

, which will return the ID of the new activity.

 $result = $this->service->floodlightActivities->insert( 
 $values['user_profile_id'], 
 $activity 
 );

Generate the tags by calling floodlightActivities.generatetag() with the floodlightActivityId of your new activity. Send the tags to the webmaster at the advertiser's website.
```
 $result = $this->service->floodlightActivities->generatetag( 
 $values['user_profile_id'], 
 ['floodlightActivityId' => $values['activity_id']] 
 ); 
```

Python

Create a new floodlight activity group, passing in values for

 name

 type

, and

 floodlightConfigurationId

 # Construct and save floodlight activity group. 
 activity_group 
 = 
 { 
 'name' 
 : 
 'Test Floodlight Activity Group' 
 , 
 'floodlightConfigurationId' 
 : 
 floodlight_config_id 
 , 
 'type' 
 : 
 'COUNTER' 
 }

Save the floodlight activity group by calling

 floodlightActivityGroups.insert()

, which will return the ID of the new group.

 request 
 = 
 service 
 . 
 floodlightActivityGroups 
 () 
 . 
 insert 
 ( 
 profileId 
 = 
 profile_id 
 , 
 body 
 = 
 activity_group 
 )

Create a new floodlight activity, and assign it the ID of the floodlight activity group that you just created, as well as all other required fields.

 # Construct and save floodlight activity. 
 floodlight_activity 
 = 
 { 
 'countingMethod' 
 : 
 'STANDARD_COUNTING' 
 , 
 'expectedUrl' 
 : 
 'http://www.google.com' 
 , 
 'floodlightActivityGroupId' 
 : 
 activity_group_id 
 , 
 'floodlightTagType' 
 : 
 'GLOBAL_SITE_TAG' 
 , 
 'name' 
 : 
 'Test Floodlight Activity' 
 }

Save the new activity by calling

 floodlightActivities.insert()

, which will return the ID of the new activity.

 request 
 = 
 service 
 . 
 floodlightActivities 
 () 
 . 
 insert 
 ( 
 profileId 
 = 
 profile_id 
 , 
 body 
 = 
 floodlight_activity 
 )

Generate the tags by calling

 floodlightActivities.generatetag()

with the floodlightActivityId of your new activity. Send the tags to the webmaster at the advertiser's website.

 # Construct the request. 
 request 
 = 
 service 
 . 
 floodlightActivities 
 () 
 . 
 generatetag 
 ( 
 profileId 
 = 
 profile_id 
 , 
 floodlightActivityId 
 = 
 activity_id 
 ) 
 # Execute request and print response. 
 response 
 = 
 request 
 . 
 execute 
 ()

Ruby

Create a new floodlight activity group, passing in values for

 name

 type

, and

 floodlightConfigurationId

 # Create a new floodlight activity group resource to insert. 
 activity_group 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 FloodlightActivityGroup 
 . 
 new 
 ( 
  
 floodlight_configuration_id 
 : 
  
 floodlight_config_id 
 , 
  
 name 
 : 
  
 format 
 ( 
 'Example Floodlight Activity Group #%s' 
 , 
  
 SecureRandom 
 . 
 hex 
 ( 
 3 
 )), 
  
 type 
 : 
  
 'COUNTER' 
  
 )

Save the floodlight activity group by calling

 floodlightActivityGroups.insert()

, which will return the ID of the new group.

 # Insert the floodlight activity group. 
 result 
  
 = 
  
 service 
 . 
 insert_floodlight_activity_group 
 ( 
 profile_id 
 , 
  
 activity_group 
 )

Create a new floodlight activity, and assign it the ID of the floodlight activity group that you just created, as well as all other required fields.

 # Create a new floodlight activity resource to insert. 
 activity 
  
 = 
  
 DfareportingUtils 
 :: 
 API_NAMESPACE 
 :: 
 FloodlightActivity 
 . 
 new 
 ( 
  
 counting_method 
 : 
  
 'STANDARD_COUNTING' 
 , 
  
 expected_url 
 : 
  
 'http://www.google.com' 
 , 
  
 floodlight_activity_group_id 
 : 
  
 activity_group_id 
 , 
  
 floodlight_tag_type 
 : 
  
 'GLOBAL_SITE_TAG' 
 , 
  
 name 
 : 
  
 format 
 ( 
 'Example Floodlight Activity #%s' 
 , 
  
 SecureRandom 
 . 
 hex 
 ( 
 3 
 )) 
 )

Save the new activity by calling

 floodlightActivities.insert()

, which will return the ID of the new activity.

 # Insert the floodlight activity. 
 result 
  
 = 
  
 service 
 . 
 insert_floodlight_activity 
 ( 
 profile_id 
 , 
  
 activity 
 )

Generate the tags by calling

 floodlightActivities.generatetag()

with the floodlightActivityId of your new activity. Send the tags to the webmaster at the advertiser's website.

 # Construct the request. 
 result 
  
 = 
  
 service 
 . 
 generatetag_floodlight_activity 
 ( 
 profile_id 
 , 
  
 floodlight_activity_id 
 : 
  
 activity_id 
 )

Generate placement tags

The last step is generating HTML tags to send to the publisher in order to display your ads. To generate the tags via the API, make a request to placements.generatetags() , specifying a set of placementIds and tagFormats .

C#

 // Generate the placement activity tags. 
 PlacementsResource 
 . 
 GeneratetagsRequest 
  
 request 
  
 = 
  
 service 
 . 
 Placements 
 . 
 Generatetags 
 ( 
 profileId 
 ); 
 request 
 . 
 CampaignId 
  
 = 
  
 campaignId 
 ; 
 request 
 . 
 TagFormats 
  
 = 
  
 PlacementsResource 
 . 
 GeneratetagsRequest 
 . 
 TagFormatsEnum 
 . 
 PLACEMENTTAGIFRAMEJAVASCRIPT 
 ; 
 request 
 . 
 PlacementIds 
  
 = 
  
 placementId 
 . 
 ToString 
 (); 
 PlacementsGenerateTagsResponse 
  
 response 
  
 = 
  
 request 
 . 
 Execute 
 ();

Java

 // Generate the placement activity tags. 
 Generatetags 
  
 request 
  
 = 
  
 reporting 
 . 
 placements 
 (). 
 generatetags 
 ( 
 profileId 
 ); 
 request 
 . 
 setCampaignId 
 ( 
 campaignId 
 ); 
 request 
 . 
 setTagFormats 
 ( 
 tagFormats 
 ); 
 request 
 . 
 setPlacementIds 
 ( 
 ImmutableList 
 . 
 of 
 ( 
 placementId 
 )); 
 PlacementsGenerateTagsResponse 
  
 response 
  
 = 
  
 request 
 . 
 execute 
 ();

PHP

 $placementTags = $this->service->placements->generatetags( 
 $values['user_profile_id'], 
 ['campaignId' => $values['campaign_id'], 
 'placementIds' => [$values['placement_id']], 
 'tagFormats' => ['PLACEMENT_TAG_STANDARD', 
 'PLACEMENT_TAG_IFRAME_JAVASCRIPT', 
 'PLACEMENT_TAG_INTERNAL_REDIRECT'] 
 ] 
 );

Python

 # Construct the request. 
 request 
 = 
 service 
 . 
 placements 
 () 
 . 
 generatetags 
 ( 
 profileId 
 = 
 profile_id 
 , 
 campaignId 
 = 
 campaign_id 
 , 
 placementIds 
 = 
 [ 
 placement_id 
 ]) 
 # Execute request and print response. 
 response 
 = 
 request 
 . 
 execute 
 ()

Ruby

 # Construct the request. 
 result 
  
 = 
  
 service 
 . 
 generate_placement_tags 
 ( 
 profile_id 
 , 
  
 campaign_id 
 : 
  
 campaign_id 
 , 
  
 placement_ids 
 : 
  
 [ 
 placement_id 
 ] 
 )

Common Trafficking Tasks Stay organized with collections Save and categorize content based on your preferences.

General coding tips

Create an advertiser

C#

Java

PHP

Python

Ruby

Create a campaign

C#

Java

PHP

Python

Ruby

Create a placement

C#

Java

PHP

Python

Ruby

Upload assets

C#

Java

PHP

Python

Ruby

Create a creative

C#

Java

PHP

Python

Ruby

Create an ad

Explicitly

C#

Java

PHP

Python

Ruby

Implicitly

C#

Java

PHP

Python

Ruby

Search for objects

Paging

C#

Java

PHP

Python

Ruby

Generate floodlight tags

C#

Java

PHP

Python

Ruby

Generate placement tags

C#

Java

PHP

Python

Ruby

Common Trafficking Tasks