Create ad group and ad group ad

Page Summary

Smart campaigns are limited to a single ad group.
The ad group type for a Smart campaign must be set to AdGroupTypeEnum.SMART_CAMPAIGN_ADS.
A Smart campaign ad group can contain multiple ads, with headlines and descriptions potentially combined dynamically.
Smart campaign ads must have their type set to AdTypeEnum.SMART_CAMPAIGN_AD.
Smart campaign ads can have a maximum of three headlines and two descriptions.

This document explains how to create an ad group, and an ad that belongs to an ad group.

Create an ad group

Similar to the Campaign created in previous steps, this ad group requires minimal configuration because it is optimized automatically.

Key requirements for Smart campaign ad groups:

A Smart campaign can have only one ad group.
The type must be set to AdGroupTypeEnum.SMART_CAMPAIGN_ADS.

This example sets the campaign field to the temporary resource name used to create a campaign in earlier steps.

Java

private MutateOperation createAdGroupOperation(long customerId) {
  MutateOperation.Builder builder = MutateOperation.newBuilder();
  builder
      .getAdGroupOperationBuilder()
      .getCreateBuilder()
      .setResourceName(ResourceNames.adGroup(customerId, AD_GROUP_TEMPORARY_ID))
      .setName("Smart campaign ad group " + CodeSampleHelper.getShortPrintableDateTime())
      .setCampaign(ResourceNames.campaign(customerId, SMART_CAMPAIGN_TEMPORARY_ID))
      .setType(AdGroupType.SMART_CAMPAIGN_ADS);
  return builder.build();
}AddSmartCampaign.java

C#

/// <summary>
/// Creates a MutateOperation that creates a new ad group.
/// A temporary ID will be used in the campaign resource name for this ad group to
/// associate it with the Smart campaign created in earlier steps. A temporary ID will
/// also be used for its own resource name so that we can associate an ad group ad with
/// it later in the process.
/// Only one ad group can be created for a given Smart campaign.
/// </summary>
/// <param name="customerId">The Google Ads customer ID.</param>
/// <returns>A MutateOperation that creates a new ad group.</returns>
private MutateOperation CreateAdGroupOperation(long customerId)
{
    return new MutateOperation
    {
        AdGroupOperation = new AdGroupOperation
        {
            Create = new AdGroup
            {
                // Set the ad group ID to a temporary ID.
                ResourceName = ResourceNames.AdGroup(customerId, AD_GROUP_TEMPORARY_ID),
                Name = $"Smart campaign ad group #{ExampleUtilities.GetRandomString()}",
                // Set the campaign ID to a temporary ID.
                Campaign = ResourceNames.Campaign(customerId, SMART_CAMPAIGN_TEMPORARY_ID),
                // The ad group type must be SmartCampaignAds.
                Type = AdGroupType.SmartCampaignAds
            }
        }
    };
}AddSmartCampaign.cs

PHP

private static function createAdGroupOperation(int $customerId): MutateOperation
{
    // Creates the ad group object.
    $adGroup = new AdGroup([
        // Sets the ad group ID to a temporary ID.
        'resource_name' => ResourceNames::forAdGroup($customerId, self::AD_GROUP_TEMPORARY_ID),
        'name' => "Smart campaign ad group #" . Helper::getPrintableDatetime(),
        // Sets the campaign ID to a temporary ID.
        'campaign' =>
            ResourceNames::forCampaign($customerId, self::SMART_CAMPAIGN_TEMPORARY_ID),
        // The ad group type must be set to SMART_CAMPAIGN_ADS.
        'type' => AdGroupType::SMART_CAMPAIGN_ADS
    ]);

    // Creates the MutateOperation that creates the ad group.
    return new MutateOperation([
        'ad_group_operation' => new AdGroupOperation(['create' => $adGroup])
    ]);
}AddSmartCampaign.php

def create_ad_group_operation( client: GoogleAdsClient, customer_id: str ) -> MutateOperation: """Creates a MutateOperation that creates a new ad group. A temporary ID will be used in the campaign resource name for this ad group to associate it with the Smart campaign created in earlier steps. A temporary ID will also be used for its own resource name so that we can associate an ad group ad with it later in the process. Only one ad group can be created for a given Smart campaign. Args: client: an initialized GoogleAdsClient instance. customer_id: a client customer ID. Returns: a MutateOperation that creates a new ad group. """ mutate_operation: MutateOperation = client.get_type("MutateOperation") ad_group_operation: AdGroupOperation = mutate_operation.ad_group_operation ad_group: AdGroup = ad_group_operation.create # Set the ad group ID to a temporary ID. ad_group.resource_name = client.get_service("AdGroupService").ad_group_path( customer_id, _AD_GROUP_TEMPORARY_ID ) ad_group.name = f"Smart campaign ad group #{uuid4()}" # Set the campaign ID to a temporary ID. ad_group.campaign = client.get_service("CampaignService").campaign_path( customer_id, _BUDGET_TEMPORARY_ID ) # The ad group type must be set to SMART_CAMPAIGN_ADS. ad_group.type_ = client.enums.AdGroupTypeEnum.SMART_CAMPAIGN_ADS return mutate_operation

add_smart_campaign

.py

# Creates a mutate_operation that creates a new ad group. # A temporary ID will be used in the campaign resource name for this # ad group to associate it with the Smart campaign created in earlier steps. # A temporary ID will also be used for its own resource name so that we can # associate an ad group ad with it later in the process. # Only one ad group can be created for a given Smart campaign. def create_ad_group_operation(client, customer_id) mutate_operation = client.operation.mutate do |m| m.ad_group_operation = client.operation.create_resource.ad_group do |ag| # Set the ad group ID to a temporary ID. ag.resource_name = client.path.ad_group(customer_id, AD_GROUP_TEMPORARY_ID) ag.name = "Smart campaign ad group ##{(Time.new.to_f * 1000).to_i}" # Set the campaign ID to a temporary ID. ag.campaign = client.path.campaign(customer_id, SMART_CAMPAIGN_TEMPORARY_ID) # The ad group type must be set to SMART_CAMPAIGN_ADS. ag.type = :SMART_CAMPAIGN_ADS end end mutate_operation end

add_smart_campaign

.rb

# Creates a MutateOperation that creates a new ad group. # A temporary ID will be used in the campaign resource name for this ad group to # associate it with the Smart campaign created in earlier steps. A temporary ID # will also be used for its own resource name so that we can associate an ad group ad # with it later in the process. # Only one ad group can be created for a given Smart campaign. sub _create_ad_group_operation { my ($customer_id) = @_; return Google::Ads::GoogleAds::V22::Services::GoogleAdsService::MutateOperation-> new({ adGroupOperation => Google::Ads::GoogleAds::V22::Services::AdGroupService::AdGroupOperation ->new({ create => Google::Ads::GoogleAds::V22::Resources::AdGroup->new({ # Set the ad group ID to a temporary ID. resourceName => Google::Ads::GoogleAds::V22::Utils::ResourceNames::ad_group( $customer_id, AD_GROUP_TEMPORARY_ID ), name => "Smart campaign ad group #" . uniqid(), # Set the campaign ID to a temporary ID. campaign => Google::Ads::GoogleAds::V22::Utils::ResourceNames::campaign( $customer_id, SMART_CAMPAIGN_TEMPORARY_ID ), # The ad group type must be set to SMART_CAMPAIGN_ADS. type => SMART_CAMPAIGN_ADS })})}); }

add_smart_campaign.pl

Create an ad group ad

Although a Smart campaign can contain only a single ad group, that ad group can contain multiple ads. Because the ad text for Smart campaigns is selected dynamically, it's possible that the headlines and descriptions from multiple different ads could be combined.

Key requirements for Smart campaign ads:

The type must be set to AdTypeEnum.SMART_CAMPAIGN_AD.

At most three headlines can be provided.

At most two descriptions can be provided.

In this example, we set the ad_group field to the temporary resource name used to create the ad group above.

def create_ad_group_ad_operation( client: GoogleAdsClient, customer_id: str, ad_suggestions: SmartCampaignAdInfo, ) -> MutateOperation: """Creates a MutateOperation that creates a new ad group ad. A temporary ID will be used in the ad group resource name for this ad group ad to associate it with the ad group created in earlier steps. Args: client: an initialized GoogleAdsClient instance. customer_id: a client customer ID. ad_suggestions: a SmartCampaignAdInfo object with ad creative suggestions. Returns: a MutateOperation that creates a new ad group ad. """ mutate_operation: MutateOperation = client.get_type("MutateOperation") ad_group_ad_operation: AdGroupAdOperation = ( mutate_operation.ad_group_ad_operation ) ad_group_ad: AdGroupAd = ad_group_ad_operation.create # Set the ad group ID to a temporary ID. ad_group_ad.ad_group = client.get_service("AdGroupService").ad_group_path( customer_id, _AD_GROUP_TEMPORARY_ID ) # Set the type to SMART_CAMPAIGN_AD. ad_group_ad.ad.type_ = client.enums.AdTypeEnum.SMART_CAMPAIGN_AD ad: SmartCampaignAdInfo = ad_group_ad.ad.smart_campaign_ad # The SmartCampaignAdInfo object includes headlines and descriptions # retrieved from the SmartCampaignSuggestService.SuggestSmartCampaignAd # method. It's recommended that users review and approve or update these # creatives before they're set on the ad. It's possible that some or all of # these assets may contain empty texts, which should not be set on the ad # and instead should be replaced with meaningful texts from the user. Below # we just accept the creatives that were suggested while filtering out empty # assets. If no headlines or descriptions were suggested, then we manually # add some, otherwise this operation will generate an INVALID_ARGUMENT # error. Individual workflows will likely vary here. ad.headlines.extend( [asset for asset in ad_suggestions.headlines if asset.text] ) num_missing_headlines: int = _REQUIRED_NUM_HEADLINES - len(ad.headlines) # If there are fewer headlines than are required, we manually add additional # headlines to make up for the difference. for i in range(num_missing_headlines): headline: AdTextAsset = client.get_type("AdTextAsset") headline.text = f"placeholder headline {i}" ad.headlines.append(headline) ad.descriptions.extend( asset for asset in ad_suggestions.descriptions if asset.text ) num_missing_descriptions: int = _REQUIRED_NUM_DESCRIPTIONS - len( ad.descriptions ) # If there are fewer descriptions than are required, we manually add # additional descriptions to make up for the difference. for i in range(num_missing_descriptions): description: AdTextAsset = client.get_type("AdTextAsset") description.text = f"placeholder description {i}" ad.descriptions.append(description) return mutate_operation

add_smart_campaign

.py

# Creates a mutate_operation that creates a new ad group ad. # A temporary ID will be used in the ad group resource name for this # ad group ad to associate it with the ad group created in earlier steps. def create_ad_group_ad_operation(client, customer_id, ad_suggestions) mutate_operation = client.operation.mutate do |m| m.ad_group_ad_operation = client.operation.create_resource.ad_group_ad do |aga| # Set the ad group ID to a temporary ID. aga.ad_group = client.path.ad_group(customer_id, AD_GROUP_TEMPORARY_ID) aga.ad = client.resource.ad do |ad| # Set the type to SMART_CAMPAIGN_AD. ad.type = :SMART_CAMPAIGN_AD ad.smart_campaign_ad = client.resource.smart_campaign_ad_info do |sca| # The SmartCampaignAdInfo object includes headlines and descriptions # retrieved from the SmartCampaignSuggestService.SuggestSmartCampaignAd # method. It's recommended that users review and approve or update these # creatives before they're set on the ad. It's possible that some or all of # these assets may contain empty texts, which should not be set on the ad # and instead should be replaced with meaningful texts from the user. Below # we just accept the creatives that were suggested while filtering out empty # assets. If no headlines or descriptions were suggested, then we manually # add some, otherwise this operation will generate an INVALID_ARGUMENT # error. Individual workflows will likely vary here. sca.headlines += ad_suggestions.headlines.filter(&:text) if ad_suggestions if sca.headlines.size < REQUIRED_NUM_HEADLINES (REQUIRED_NUM_HEADLINES - sca.headlines.size).times do |i| sca.headlines << client.resource.ad_text_asset do |asset| asset.text = "placeholder headline #{i}" end end end sca.descriptions += ad_suggestions.descriptions.filter(&:text) if ad_suggestions if sca.descriptions.size < REQUIRED_NUM_DESCRIPTIONS (REQUIRED_NUM_DESCRIPTIONS - sca.descriptions.size).times do |i| sca.descriptions << client.resource.ad_text_asset do |asset| asset.text = "placeholder description #{i}" end end end end end end end mutate_operation end

add_smart_campaign

.rb

# Creates a MutateOperation that creates a new ad group ad. # A temporary ID will be used in the ad group resource name for this ad group ad # to associate it with the ad group created in earlier steps. sub _create_ad_group_ad_operation { my ($customer_id, $ad_suggestions) = @_; my $mutate_operation = Google::Ads::GoogleAds::V22::Services::GoogleAdsService::MutateOperation-> new({ adGroupAdOperation => Google::Ads::GoogleAds::V22::Services::AdGroupAdService::AdGroupAdOperation ->new({ create => Google::Ads::GoogleAds::V22::Resources::AdGroupAd->new({ adGroup => # Set the ad group ID to a temporary ID. Google::Ads::GoogleAds::V22::Utils::ResourceNames::ad_group( $customer_id, AD_GROUP_TEMPORARY_ID ), ad => Google::Ads::GoogleAds::V22::Resources::Ad->new({ # Set the type to SMART_CAMPAIGN_AD. type => SMART_CAMPAIGN_AD, smartCampaignAd => Google::Ads::GoogleAds::V22::Common::SmartCampaignAdInfo-> new({ headlines => [], descriptions => []})})})})}); # The SmartCampaignAdInfo object includes headlines and descriptions # retrieved from the SmartCampaignSuggestService.SuggestSmartCampaignAd # method. It's recommended that users review and approve or update these # creatives before they're set on the ad. It's possible that some or all of # these assets may contain empty texts, which should not be set on the ad # and instead should be replaced with meaningful texts from the user. Below # we just accept the creatives that were suggested while filtering out empty # assets. If no headlines or descriptions were suggested, then we manually # add some, otherwise this operation will generate an INVALID_ARGUMENT # error. Individual workflows will likely vary here. my $smart_campaign_ad = $mutate_operation->{adGroupAdOperation}{create}{ad}{smartCampaignAd}; foreach my $asset (@{$ad_suggestions->{headlines}}) { push @{$smart_campaign_ad->{headlines}}, $asset if defined $asset->{text}; } # If there are fewer headlines than are required, we manually add additional # headlines to make up for the difference. my $num_missing_headlines = REQUIRED_NUM_HEADLINES - scalar @{$smart_campaign_ad->{headlines}}; for (my $i = 0 ; $i < $num_missing_headlines ; $i++) { push @{$smart_campaign_ad->{headlines}}, Google::Ads::GoogleAds::V22::Common::AdTextAsset->new({ text => "placeholder headline " . $i }); } foreach my $asset (@{$ad_suggestions->{descriptions}}) { push @{$smart_campaign_ad->{descriptions}}, $asset if defined $asset->{text}; } # If there are fewer descriptions than are required, we manually add # additional descriptions to make up for the difference. my $num_missing_descriptions = REQUIRED_NUM_DESCRIPTIONS - scalar @{$smart_campaign_ad->{descriptions}}; for (my $i = 0 ; $i < $num_missing_descriptions ; $i++) { push @{$smart_campaign_ad->{descriptions}}, Google::Ads::GoogleAds::V22::Common::AdTextAsset->new({ text => "placeholder description " . $i }); } return $mutate_operation; }

add_smart_campaign.pl

Create ad group and ad group ad

Page Summary

Create an ad group

Java

C#

PHP

Python

Ruby

Perl

Create an ad group ad

/// /// /// /// /// /// /// /// { }

): }
tabindex="-1">Java

Python

Ruby

Perl

Create ad group and ad group ad Stay organized with collections Save and categorize content based on your preferences.

Page Summary

Create an ad group

Java

C#

PHP

Python

Ruby

Perl

Create an ad group ad

/// /// /// /// /// /// /// /// { }

): } tabindex="-1">Java

Python

Ruby

Perl

Create ad group and ad group ad

): }
tabindex="-1">Java