Creating a Hotel Ad Group Ad

    • Creating a Hotel ad requires two steps: creating an Ad with hotel_ad set to a HotelAdInfo instance, and then creating an AdGroupAd associated with that Ad.

    • To serve Hotel Ads, you need at least one AdGroupAd with its ad set and its status set to ENABLED .

    • It is recommended to create only one AdGroupAd per ad group for easier metric distinction, as impressions are shared among multiple ad group ads within the same ad group.

    Creating a Hotel ad involves two steps:

    1. Creating an Ad and setting its hotel_ad to an instance of HotelAdInfo .

    2. Creating an AdGroupAd and associating the previously created Ad to it.

    Java

     private 
  
 String 
  
 addHotelAdGroupAd 
 ( 
  
 GoogleAdsClient 
  
 googleAdsClient 
 , 
  
 long 
  
 customerId 
 , 
  
 String 
  
 adGroupResourceName 
 ) 
  
 { 
  
 // Creates a new hotel ad. 
  
 Ad 
  
 ad 
  
 = 
  
 Ad 
 . 
 newBuilder 
 (). 
 setHotelAd 
 ( 
 HotelAdInfo 
 . 
 newBuilder 
 (). 
 build 
 ()). 
 build 
 (); 
  
 // Creates a new ad group ad and sets the hotel ad to it. 
  
 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 hotel campaigns.  For hotels 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 a hotel ad group ad with resource name: '%s'%n" 
 , 
  
 mutateAdGroupAdResult 
 . 
 getResourceName 
 ()); 
  
 return 
  
 mutateAdGroupAdResult 
 . 
 getResourceName 
 (); 
  
 } 
 } 
 
      AddHotelAd 
 . 
 java

    C#

     private 
  
 static 
  
 void 
  
 AddHotelAdGroupAd 
 ( 
 GoogleAdsClient 
  
 client 
 , 
  
 long 
  
 customerId 
 , 
  
 string 
  
 adGroupResourceName 
 ) 
 { 
  
 // Get the AdGroupAdService. 
  
 AdGroupAdServiceClient 
  
 service 
  
 = 
  
 client 
 . 
 GetService 
 ( 
 Services 
 . 
 V22 
 . 
 AdGroupAdService 
 ); 
  
 // Create a new ad group ad and sets the hotel ad to it. 
  
 AdGroupAd 
  
 adGroupAd 
  
 = 
  
 new 
  
 AdGroupAd 
 () 
  
 { 
  
 // Create a new hotel ad. 
  
 Ad 
  
 = 
  
 new 
  
 Ad 
 () 
  
 { 
  
 HotelAd 
  
 = 
  
 new 
  
 HotelAdInfo 
 (), 
  
 }, 
  
 // Set the ad group. 
  
 AdGroup 
  
 = 
  
 adGroupResourceName 
 , 
  
 // Set the ad group ad to enabled.  Setting this to paused will cause an error 
  
 // for hotel campaigns.  For hotels pausing should happen at either the ad group or 
  
 // campaign level. 
  
 Status 
  
 = 
  
 AdGroupAdStatus 
 . 
 Enabled 
  
 }; 
  
 // Create an ad group ad operation. 
  
 AdGroupAdOperation 
  
 adGroupAdOperation 
  
 = 
  
 new 
  
 AdGroupAdOperation 
 () 
  
 { 
  
 Create 
  
 = 
  
 adGroupAd 
  
 }; 
  
 // Issue a mutate request to add an ad group ad. 
  
 MutateAdGroupAdsResponse 
  
 response 
  
 = 
  
 service 
 . 
 MutateAdGroupAds 
 ( 
 customerId 
 . 
 ToString 
 (), 
  
 new 
  
 AdGroupAdOperation 
 [] 
  
 { 
  
 adGroupAdOperation 
  
 }); 
  
 MutateAdGroupAdResult 
  
 addedAdGroupAd 
  
 = 
  
 response 
 . 
 Results 
 [ 
 0 
 ]; 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Added a hotel ad group ad with resource name " 
  
 + 
  
 $"{addedAdGroupAd.ResourceName}." 
 ); 
 } 
 
      AddHotelAd 
 . 
 cs

    PHP

     private static function addHotelAdGroupAd( 
 GoogleAdsClient $googleAdsClient, 
 int $customerId, 
 string $adGroupResourceName 
 ) { 
 // Creates a new hotel ad. 
 $ad = new Ad([ 
 'hotel_ad' => new HotelAdInfo(), 
 ]); 
 // Creates a new ad group ad and sets the hotel ad to it. 
 $adGroupAd = new AdGroupAd([ 
 'ad' => $ad, 
 // Set the ad group ad to enabled.  Setting this to paused will cause an error 
 // for hotel campaigns.  For hotels 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 a hotel ad group ad with resource name '%s'.%s", 
 $addedAdGroupAd->getResourceName(), 
 PHP_EOL 
 ); 
 } 
     AddHotelAd.php

    Python

     def 
  
 add_hotel_ad 
 ( 
 client 
 : 
 GoogleAdsClient 
 , 
 customer_id 
 : 
 str 
 , 
 ad_group_resource_name 
 : 
 str 
 ) 
 - 
> str 
 : 
 ad_group_ad_service 
 : 
 AdGroupAdServiceClient 
 = 
 client 
 . 
 get_service 
 ( 
 "AdGroupAdService" 
 ) 
 # Creates a new ad group ad and sets the hotel ad to it. 
 ad_group_ad_operation 
 : 
 AdGroupAdOperation 
 = 
 client 
 . 
 get_type 
 ( 
 "AdGroupAdOperation" 
 ) 
 ad_group_ad 
 : 
 AdGroupAd 
 = 
 ad_group_ad_operation 
 . 
 create 
 ad_group_ad 
 . 
 ad_group 
 = 
 ad_group_resource_name 
 # Set the ad group ad to enabled.  Setting this to paused will cause an error 
 # for hotel campaigns.  For hotels pausing should happen at either the ad group or 
 # campaign level. 
 ad_group_ad 
 . 
 status 
 = 
 client 
 . 
 enums 
 . 
 AdGroupAdStatusEnum 
 . 
 ENABLED 
 client 
 . 
 copy_from 
 ( 
 ad_group_ad 
 . 
 ad 
 . 
 hotel_ad 
 , 
 client 
 . 
 get_type 
 ( 
 "HotelAdInfo" 
 )) 
 # Add the ad group ad. 
 ad_group_ad_response 
 : 
 MutateAdGroupAdsResponse 
 = 
 ( 
 ad_group_ad_service 
 . 
 mutate_ad_group_ads 
 ( 
 customer_id 
 = 
 customer_id 
 , 
 operations 
 = 
 [ 
 ad_group_ad_operation 
 ] 
 ) 
 ) 
 ad_group_ad_resource_name 
 : 
 str 
 = 
 ad_group_ad_response 
 . 
 results 
 [ 
 0 
 ] 
 . 
 resource_name 
 print 
 ( 
 f 
 "Created hotel ad with resource name ' 
 { 
 ad_group_ad_resource_name 
 } 
 '." 
 ) 
 return 
 ad_group_resource_name 
     add_hotel_ad 

     
     
 . 
 py

    Ruby

     def 
  
 add_hotel_ad_group_ad 
 ( 
 client 
 , 
  
 customer_id 
 , 
  
 ad_group_resource 
 ) 
  
 # Create a new hotel ad. 
  
 ad_group_ad_operation 
  
 = 
  
 client 
 . 
 operation 
 . 
 create_resource 
 . 
 ad_group_ad 
  
 do 
  
 | 
 aga 
 | 
  
 # Create a new ad group ad and sets the hotel ad to it. 
  
 aga 
 . 
 ad 
  
 = 
  
 client 
 . 
 resource 
 . 
 ad 
  
 do 
  
 | 
 ad 
 | 
  
 ad 
 . 
 hotel_ad 
  
 = 
  
 client 
 . 
 resource 
 . 
 hotel_ad_info 
  
 end 
  
 # Set the ad group ad to enabled.  Setting this to paused will cause an error 
  
 # for hotel campaigns.  For hotels 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 hotel ad group ad with resource name ' 
 #{ 
 ad_group_ad_resource 
 } 
 '." 
 end 
     add_hotel_ad 

     
     
 . 
 rb

    Perl

     sub 
  
 add_hotel_ad_group_ad 
  
 { 
  
 my 
  
 ( 
 $api_client 
 , 
  
 $customer_id 
 , 
  
 $ad_group_resource_name 
 ) 
  
 = 
  
 @_ 
 ; 
  
 # Create an ad group ad and set a hotel ad to it. 
  
 my 
  
 $ad_group_ad 
  
 = 
  
 Google::Ads::GoogleAds::V22::Resources:: 
 AdGroupAd 
 - 
> new 
 ({ 
  
 # Set the ad group. 
  
 adGroup 
  
 = 
>  
 $ad_group_resource_name 
 , 
  
 # Set the ad to a new shopping product ad. 
  
 ad 
  
 = 
>  
 Google::Ads::GoogleAds::V22::Resources:: 
 Ad 
 - 
> new 
 ({ 
  
 hotelAd 
  
 = 
>  
 Google::Ads::GoogleAds::V22::Common:: 
 HotelAdInfo 
 - 
> new 
 ()} 
  
 ), 
  
 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 a hotel ad group ad with resource name: '%s'.\n" 
 , 
  
 $ad_group_ad_resource_name 
 ; 
  
 return 
  
 $ad_group_ad_resource_name 
 ; 
 } 
 
      add_hotel_ad 
 . 
 pl
    Previous
    Create ad group
    Next
    Create listing groups
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: