Creating a Things to do ad group ad

Page Summary

Creating a Things to do ad involves creating an Ad and setting its travel_ad to an instance of TravelAdInfo.
The second step is to create an AdGroupAd and associate the previously created Ad to it.
To serve ads for your ad group, you need one AdGroupAd whose ad is set and whose status is ENABLED.
It is recommended to create only one ad per ad group to make tracking ad performance easier.

Creating a Things to do ad involves two steps:

Creating an Ad and setting its travel_ad to an instance of TravelAdInfo .
Creating an AdGroupAd and associating the previously created Ad to it.

Java

 private 
  
 String 
  
 addAddGroupAd 
 ( 
  
 GoogleAdsClient 
  
 googleAdsClient 
 , 
  
 long 
  
 customerId 
 , 
  
 String 
  
 adGroupResourceName 
 ) 
  
 { 
  
 // Creates a new travel ad. 
  
 Ad 
  
 ad 
  
 = 
  
 Ad 
 . 
 newBuilder 
 (). 
 setTravelAd 
 ( 
 TravelAdInfo 
 . 
 newBuilder 
 ()). 
 build 
 (); 
  
 // Creates a new ad group ad and sets its ad to the travel ad. 
  
 AdGroupAd 
  
 adGroupAd 
  
 = 
  
 AdGroupAd 
 . 
 newBuilder 
 () 
  
 // Sets the ad to the ad created above. 
  
 . 
 setAd 
 ( 
 ad 
 ) 
  
 // Set the ad group ad to enabled. Setting this to paused will cause an error for 
  
 // Things to do campaigns. Pausing should happen at either the ad group or campaign 
  
 // level. 
  
 . 
 setStatus 
 ( 
 AdGroupAdStatus 
 . 
 ENABLED 
 ) 
  
 // Sets the ad group. 
  
 . 
 setAdGroup 
 ( 
 adGroupResourceName 
 ) 
  
 . 
 build 
 (); 
  
 // Creates an ad group ad operation. 
  
 AdGroupAdOperation 
  
 operation 
  
 = 
  
 AdGroupAdOperation 
 . 
 newBuilder 
 (). 
 setCreate 
 ( 
 adGroupAd 
 ). 
 build 
 (); 
  
 // Issues a mutate request to add an ad group ad. 
  
 try 
  
 ( 
 AdGroupAdServiceClient 
  
 adGroupAdServiceClient 
  
 = 
  
 googleAdsClient 
 . 
 getLatestVersion 
 (). 
 createAdGroupAdServiceClient 
 ()) 
  
 { 
  
 MutateAdGroupAdResult 
  
 mutateAdGroupAdResult 
  
 = 
  
 adGroupAdServiceClient 
  
 . 
 mutateAdGroupAds 
 ( 
 Long 
 . 
 toString 
 ( 
 customerId 
 ), 
  
 Collections 
 . 
 singletonList 
 ( 
 operation 
 )) 
  
 . 
 getResults 
 ( 
 0 
 ); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
  
 "Added an ad group ad with resource name: '%s'%n" 
 , 
  
 mutateAdGroupAdResult 
 . 
 getResourceName 
 ()); 
  
 return 
  
 mutateAdGroupAdResult 
 . 
 getResourceName 
 (); 
  
 } 
 } 
   AddThingsToDoAd 
 . 
 java

C#

 private 
  
 static 
  
 void 
  
 CreateAdGroupAd 
 ( 
 GoogleAdsClient 
  
 client 
 , 
  
 long 
  
 customerId 
 , 
  
 string 
  
 adGroup 
 ) 
 { 
  
 // Get the AdGroupAdService. 
  
 AdGroupAdServiceClient 
  
 adGroupAdService 
  
 = 
  
 client 
 . 
 GetService 
 ( 
 Services 
 . 
 V22 
 . 
 AdGroupAdService 
 ); 
  
 // Creates a new ad group ad and sets a travel ad info. 
  
 AdGroupAd 
  
 adGroupAd 
  
 = 
  
 new 
  
 AdGroupAd 
 () 
  
 { 
  
 Ad 
  
 = 
  
 new 
  
 Ad 
 () 
  
 { 
  
 TravelAd 
  
 = 
  
 new 
  
 TravelAdInfo 
 () 
  
 }, 
  
 // Set the ad group ad to enabled. Setting this to paused will cause an error for 
  
 // Things to do campaigns. Pausing should happen at either the ad group or campaign 
  
 // level. 
  
 Status 
  
 = 
  
 AdGroupAdStatus 
 . 
 Enabled 
 , 
  
 AdGroup 
  
 = 
  
 adGroup 
  
 }; 
  
 MutateAdGroupAdsResponse 
  
 response 
  
 = 
  
 adGroupAdService 
 . 
 MutateAdGroupAds 
 ( 
  
 customerId 
 . 
 ToString 
 (), 
  
 new 
  
 AdGroupAdOperation 
 [] 
  
 { 
  
 new 
  
 AdGroupAdOperation 
 () 
  
 { 
  
 Create 
  
 = 
  
 adGroupAd 
  
 }} 
  
 ); 
  
 string 
  
 adGroupAdResourceName 
  
 = 
  
 response 
 . 
 Results 
 [ 
 0 
 ]. 
 ResourceName 
 ; 
  
 Console 
 . 
 WriteLine 
 ( 
 "Ad group ad with resource name = '{0}' was added." 
 , 
  
 adGroupAdResourceName 
 ); 
 } 
   AddThingsToDoAd 
 . 
 cs

PHP

 private static function addAdGroupAd( 
 GoogleAdsClient $googleAdsClient, 
 int $customerId, 
 string $adGroupResourceName 
 ) { 
 // Creates a new ad group ad and sets a travel ad info. 
 $adGroupAd = new AdGroupAd([ 
 'ad' => new Ad(['travel_ad' => new TravelAdInfo()]), 
 // Set the ad group ad to enabled. Setting this to paused will cause an error for Things 
 // to do campaigns. Pausing should happen at either the ad group or campaign level. 
 'status' => AdGroupAdStatus::ENABLED, 
 // Sets the ad group. 
 'ad_group' => $adGroupResourceName 
 ]); 
 // Creates an ad group ad operation. 
 $adGroupAdOperation = new AdGroupAdOperation(); 
 $adGroupAdOperation->setCreate($adGroupAd); 
 // Issues a mutate request to add an ad group ad. 
 $adGroupAdServiceClient = $googleAdsClient->getAdGroupAdServiceClient(); 
 $response = $adGroupAdServiceClient->mutateAdGroupAds( 
 MutateAdGroupAdsRequest::build($customerId, [$adGroupAdOperation]) 
 ); 
 /** @var AdGroupAd $addedAdGroupAd */ 
 $addedAdGroupAd = $response->getResults()[0]; 
 printf( 
 "Added an ad group ad with resource name '%s'.%s", 
 $addedAdGroupAd->getResourceName(), 
 PHP_EOL 
 ); 
 }  AddThingsToDoAd.php

def add_ad_group_ad ( client : GoogleAdsClient , customer_id : str , ad_group_resource_name : str ) - > None : """Creates a new ad group ad in the specified ad group. Args: client: an initialized GoogleAdsClient instance. customer_id: a client customer ID. ad_group_resource_name: the resource name of ad group that a new ad group ad will belong to. """ # Creates an ad group ad operation. operation : AdGroupAdOperation = client . get_type ( "AdGroupAdOperation" ) # Creates a new ad group ad and sets a travel ad info. ad_group_ad : AdGroupAd = operation . create # Sets the ad group ad to enabled. Setting this to paused will cause an error # for Things to do campaigns. Pausing should happen at either the ad group # or campaign level. ad_group_ad . status = client . enums . AdGroupAdStatusEnum . ENABLED ad_group_ad . ad . travel_ad = client . get_type ( "TravelAdInfo" ) # Sets the ad group. ad_group_ad . ad_group = ad_group_resource_name # Issues a mutate request to add an ad group ad. ad_group_ad_service : AdGroupAdServiceClient = client . get_service ( "AdGroupAdService" ) response : MutateAdGroupAdsResponse = ( ad_group_ad_service . mutate_ad_group_ads ( customer_id = customer_id , operations = [ operation ] ) ) resource_name : str = response . results [ 0 ] . resource_name print ( f "Added an ad group ad with resource name: ' { resource_name } '." )

add_things_to_do_ad . py

def add_ad_group_ad ( client , customer_id , ad_group_resource ) # Creates a new ad group ad and sets a travel ad info. ad_group_ad_operation = client . operation . create_resource . ad_group_ad do | aga | aga . ad = client . resource . ad do | ad | ad . travel_ad = client . resource . travel_ad_info end # Set the ad group ad to enabled. Setting this to paused will cause an error # for Things to Do campaigns. Pausing should happen at either the ad group # or campaign level. aga . status = :ENABLED # Set the ad group. aga . ad_group = ad_group_resource end # Issue a mutate request to add the ad group ad. ad_group_ad_service = client . service . ad_group_ad response = ad_group_ad_service . mutate_ad_group_ads ( customer_id : customer_id , operations : [ ad_group_ad_operation ] , ) # Fetch the new ad group ad's resource name. ad_group_ad_resource = response . results . first . resource_name puts "Added an ad group ad with resource name ' #{ ad_group_ad_resource } '." end

add_things_to_do_ad

. rb

sub add_ad_group_ad { my ( $api_client , $customer_id , $ad_group_resource_name ) = @_ ; # Create an ad group ad and set a travel ad info. my $ad_group_ad = Google::Ads::GoogleAds::V22::Resources:: AdGroupAd - > new ({ # Set the ad group. adGroup = > $ad_group_resource_name , ad = > Google::Ads::GoogleAds::V22::Resources:: Ad - > new ({ travelAd = > Google::Ads::GoogleAds::V22::Common:: TravelAdInfo - > new ()} ), # Set the ad group to enabled. Setting this to paused will cause an error # for Things to do campaigns. Pausing should happen at either the ad group # or campaign level. status = > Google::Ads::GoogleAds::V22::Enums::AdGroupAdStatusEnum:: ENABLED }); # Create an ad group ad operation. my $ad_group_ad_operation = Google::Ads::GoogleAds::V22::Services::AdGroupAdService:: AdGroupAdOperation - > new ({ create = > $ad_group_ad }); # Add the ad group ad. my $ad_group_ad_resource_name = $api_client - > AdGroupAdService () - > mutate ({ customerId = > $customer_id , operations = > [ $ad_group_ad_operation ]}) - > { results }[ 0 ]{ resourceName }; printf "Added an ad group ad with resource name: '%s'.\n" , $ad_group_ad_resource_name ; return $ad_group_ad_resource_name ; }

add_things_to_do_ad . pl

Creating a Things to do ad group ad

Page Summary

Java

C#

PHP

Python

Ruby

Perl

Creating a Things to do ad group ad Stay organized with collections Save and categorize content based on your preferences.

Page Summary

Java

C#

PHP

Python

Ruby

Perl

Creating a Things to do ad group ad