Receba sugestões de recursos de texto do anúncio, orçamento e tema de palavra-chave

A API Google Ads expõe o SmartCampaignSuggestService para sugerir detalhes de configuração ao criar campanhas inteligentes. Ele usa detalhes sobre a empresa anunciada (na forma de uma instância SmartCampaignSuggestionInfo) para sugerir temas de palavra-chave, um valor de orçamento, além de títulos e descrições de anúncios individuais.

Criar uma instância SmartCampaignSuggestionInfo

Para gerar sugestões de campanhas inteligentes, é preciso usar uma instância SmartCampaignSuggestionInfo com detalhes sobre a empresa anunciada. Como é possível usar a mesma instância SmartCampaignSuggestionInfo para recuperar todos os diferentes tipos de sugestões de campanhas inteligentes, primeiro é possível criar uma e reutilizá-la várias vezes.

Principais requisitos de SmartCampaignSuggestionInfo:

  • Para todos os serviços de sugestão, é necessário definir o campo final_url ou o campo business_profile_location, já que as sugestões são derivadas dos detalhes da empresa.
    • Se final_url estiver definido, business_profile_location ou business_name poderão ser definidos.
    • Se a final_url não for definida, a business_profile_location precisará ser definida.
  • Quando usado para recuperar sugestões de tema de palavra-chave do método SuggestKeywordThemes, não é necessário definir o campo keyword_themes.
  • Quando usados para recuperar sugestões de anúncios do método SuggestSmartCampaignAd, os campos language_code e keyword_themes são obrigatórios.
  • O máximo de detalhes possível precisa ser adicionado ao objeto para sugestões otimizadas.

Java

private SmartCampaignSuggestionInfo getSmartCampaignSuggestionInfo(
    GoogleAdsClient googleAdsClient, String businessProfileLocation, String businessName) {
  SmartCampaignSuggestionInfo.Builder suggestionInfoBuilder =
      SmartCampaignSuggestionInfo.newBuilder()
          // Adds the URL of the campaign's landing page.
          .setFinalUrl(LANDING_PAGE_URL)
          // Adds the language code for the campaign.
          .setLanguageCode(LANGUAGE_CODE)
          // Constructs location information using the given geo target constant. It's also
          // possible to provide a geographic proximity using the "proximity" field,
          // for example:
          // .setProximity(
          //     ProximityInfo.newBuilder()
          //         .setAddress(
          //             AddressInfo.newBuilder()
          //                 .setPostalCode(INSERT_POSTAL_CODE)
          //                 .setProvinceCode(INSERT_PROVINCE_CODE)
          //                 .setCountryCode(INSERT_COUNTRY_CODE)
          //                 .setProvinceName(INSERT_PROVINCE_NAME)
          //                 .setStreetAddress(INSERT_STREET_ADDRESS)
          //                 .setStreetAddress2(INSERT_STREET_ADDRESS_2)
          //                 .setCityName(INSERT_CITY_NAME)
          //                 .build())
          //         .setRadius(INSERT_RADIUS)
          //         .setRadiusUnits(INSERT_RADIUS_UNITS)
          //         .build())
          // For more information on proximities see:
          // https://developers.google.com/google-ads/api/reference/rpc/latest/ProximityInfo
          //
          // Adds LocationInfo objects to the list of locations. You have the option of
          // providing multiple locations when using location-based suggestions.
          .setLocationList(
              LocationList.newBuilder()
                  // Sets one location to the resource name of the given geo target constant.
                  .addLocations(
                      LocationInfo.newBuilder()
                          .setGeoTargetConstant(
                              ResourceNames.geoTargetConstant(GEO_TARGET_CONSTANT))
                          .build())
                  .build())
          // Adds a schedule detailing which days of the week the business is open.
          // This schedule describes a schedule in which the business is open on
          // Mondays from 9am to 5pm.
          .addAdSchedules(
              AdScheduleInfo.newBuilder()
                  // Sets the day of this schedule as Monday.
                  .setDayOfWeek(DayOfWeek.MONDAY)
                  // Sets the start hour to 9am.
                  .setStartHour(9)
                  // Sets the end hour to 5pm.
                  .setEndHour(17)
                  // Sets the start and end minute of zero, for example: 9:00 and 5:00.
                  .setStartMinute(MinuteOfHour.ZERO)
                  .setEndMinute(MinuteOfHour.ZERO)
                  .build());

  // Sets either of the business_profile_location or business_name, depending on whichever is
  // provided.
  if (businessProfileLocation != null) {
    suggestionInfoBuilder.setBusinessProfileLocation(businessProfileLocation);
  } else {
    suggestionInfoBuilder.setBusinessContext(
        BusinessContext.newBuilder().setBusinessName(businessName).build());
  }
  return suggestionInfoBuilder.build();
}
      

C#

/// <summary>
/// Builds a SmartCampaignSuggestionInfo object with business details.
///
/// The details are used by the SmartCampaignSuggestService to suggest a
/// budget amount as well as creatives for the ad.
///
/// Note that when retrieving ad creative suggestions it's required that the
/// "final_url", "language_code" and "keyword_themes" fields are set on the
/// SmartCampaignSuggestionInfo instance.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="businessProfileLocation">The identifier of a Business Profile location.
/// </param>
/// <param name="businessName">The name of a Business Profile.</param>
/// <returns>A SmartCampaignSuggestionInfo instance .</returns>
private SmartCampaignSuggestionInfo GetSmartCampaignSuggestionInfo(GoogleAdsClient client,
    string businessProfileLocation, string businessName)
{
    // Note: This is broken since businessLocationId is not yet renamed in
    // SmartCampaignSuggestionInfo. The use of dynamic temporarily fixes the broken build.
    // TODO(Anash): Revert the type change once this field is fixed.
    dynamic suggestionInfo = new SmartCampaignSuggestionInfo
    {
        // Add the URL of the campaign's landing page.
        FinalUrl = LANDING_PAGE_URL,
        LanguageCode = LANGUAGE_CODE,
        // Construct location information using the given geo target constant. It's
        // also possible to provide a geographic proximity using the "proximity"
        // field on suggestion_info, for example:
        // Proximity = new ProximityInfo
        // {
        //     Address = new AddressInfo
        //     {
        //         PostalCode = "INSERT_POSTAL_CODE",
        //         ProvinceCode = "INSERT_PROVINCE_CODE",
        //         CountryCode = "INSERT_COUNTRY_CODE",
        //         ProvinceName = "INSERT_PROVINCE_NAME",
        //         StreetAddress = "INSERT_STREET_ADDRESS",
        //         StreetAddress2 = "INSERT_STREET_ADDRESS_2",
        //         CityName = "INSERT_CITY_NAME"
        //     },
        //     Radius = Double.Parse("INSERT_RADIUS"),
        //     RadiusUnits = ProximityRadiusUnits.Kilometers
        // }
        // For more information on proximities see:
        // https://developers.google.com/google-ads/api/reference/rpc/latest/ProximityInfo
        LocationList = new LocationList()
        {
            Locations =
            {
                new LocationInfo
                {
                    // Set the location to the resource name of the given geo target
                    // constant.
                    GeoTargetConstant =
                        ResourceNames.GeoTargetConstant(GEO_TARGET_CONSTANT)
                }
            }
        }
    };

    // Add the Business Profile location if provided.
    if (!string.IsNullOrEmpty(businessProfileLocation))
    {
        suggestionInfo.BusinessProfileLocation = businessProfileLocation;
    }
    else
    {
        suggestionInfo.BusinessContext = new BusinessContext
        {
            BusinessName = businessName,
        };
    }

    // Add a schedule detailing which days of the week the business is open. This schedule
    // describes a business that is open on Mondays from 9:00 AM to 5:00 PM.
    AdScheduleInfo adScheduleInfo = new AdScheduleInfo
    {
        // Set the day of this schedule as Monday.
        DayOfWeek = DayOfWeekEnum.Types.DayOfWeek.Monday,
        // Set the start hour to 9 AM.
        StartHour = 9,
        // Set the end hour to 5 PM.
        EndHour = 17,
        // Set the start and end minutes to zero.
        StartMinute = MinuteOfHourEnum.Types.MinuteOfHour.Zero,
        EndMinute = MinuteOfHourEnum.Types.MinuteOfHour.Zero
    };

    suggestionInfo.AdSchedules.Add(adScheduleInfo);

    return suggestionInfo;
}
      

PHP

private static function getSmartCampaignSuggestionInfo(
    ?string $businessProfileLocationResourceName,
    ?string $businessName
): SmartCampaignSuggestionInfo {
    $suggestionInfo = new SmartCampaignSuggestionInfo([
        // Adds the URL of the campaign's landing page.
        'final_url' => self::LANDING_PAGE_URL,

        // Adds the language code for the campaign.
        'language_code' => self::LANGUAGE_CODE,

        // Constructs location information using the given geo target constant. It's also
        // possible to provide a geographic proximity using the "proximity" field,
        // for example:
        //
        // 'proximity' => new ProximityInfo([
        //     'address' => mew AddressInfo([
        //         'post_code' => INSERT_POSTAL_CODE,
        //         'province_code' => INSERT_PROVINCE_CODE,
        //         'country_code' => INSERT_COUNTRY_CODE,
        //         'province_name' => INSERT_PROVINCE_NAME,
        //         'street_address' => INSERT_STREET_ADDRESS,
        //         'street_address2' => INSERT_STREET_ADDRESS_2,
        //         'city_name' => INSERT_CITY_NAME
        //     ]),
        //     'radius' => INSERT_RADIUS,
        //     'radius_units' => INSERT_RADIUS_UNITS
        // ])
        //
        // For more information on proximities see:
        // https://developers.google.com/google-ads/api/reference/rpc/latest/ProximityInfo

        // Adds LocationInfo objects to the list of locations. You have the option of
        // providing multiple locations when using location-based suggestions.
        'location_list' => new LocationList([
            // Sets one location to the resource name of the given geo target constant.
            'locations' => [new LocationInfo([
                'geo_target_constant' => ResourceNames::forGeoTargetConstant(
                    self::GEO_TARGET_CONSTANT
                )
            ])]
        ]),

        // Adds a schedule detailing which days of the week the business is open.
        // This schedule describes a schedule in which the business is open on
        // Mondays from 9am to 5pm.
        'ad_schedules' => [new AdScheduleInfo([
            // Sets the day of this schedule as Monday.
            'day_of_week' => DayOfWeek::MONDAY,
            // Sets the start hour to 9am.
            'start_hour' => 9,
            // Sets the end hour to 5pm.
            'end_hour' => 17,
            // Sets the start and end minute of zero, for example: 9:00 and 5:00.
            'start_minute' => MinuteOfHour::ZERO,
            'end_minute' => MinuteOfHour::ZERO
        ])]
    ]);

    // Sets either of the business_profile_location or business_name, depending on whichever is
    // provided.
    if ($businessProfileLocationResourceName) {
        $suggestionInfo->setBusinessProfileLocation($businessProfileLocationResourceName);
    } else {
        $suggestionInfo->setBusinessContext(new BusinessContext([
            'business_name' => $businessName
        ]));
    }
    return $suggestionInfo;
}
      

Python

def get_smart_campaign_suggestion_info(
    client, business_profile_location, business_name
):
    """Builds a SmartCampaignSuggestionInfo object with business details.

    The details are used by the SmartCampaignSuggestService to suggest a
    budget amount as well as creatives for the ad.

    Note that when retrieving ad creative suggestions it's required that the
    "final_url", "language_code" and "keyword_themes" fields are set on the
    SmartCampaignSuggestionInfo instance.

    Args:
        client: an initialized GoogleAdsClient instance.
        business_profile_location: the resource name of a Business Profile
          location.
        business_name: the name of a Business Profile.

    Returns:
        A SmartCampaignSuggestionInfo instance.
    """
    suggestion_info = client.get_type("SmartCampaignSuggestionInfo")

    # Add the URL of the campaign's landing page.
    suggestion_info.final_url = _LANDING_PAGE_URL

    # Add the language code for the campaign.
    suggestion_info.language_code = _LANGUAGE_CODE

    # Construct location information using the given geo target constant. It's
    # also possible to provide a geographic proximity using the "proximity"
    # field on suggestion_info, for example:
    #
    # suggestion_info.proximity.address.post_code = INSERT_POSTAL_CODE
    # suggestion_info.proximity.address.province_code = INSERT_PROVINCE_CODE
    # suggestion_info.proximity.address.country_code = INSERT_COUNTRY_CODE
    # suggestion_info.proximity.address.province_name = INSERT_PROVINCE_NAME
    # suggestion_info.proximity.address.street_address = INSERT_STREET_ADDRESS
    # suggestion_info.proximity.address.street_address2 = INSERT_STREET_ADDRESS_2
    # suggestion_info.proximity.address.city_name = INSERT_CITY_NAME
    # suggestion_info.proximity.radius = INSERT_RADIUS
    # suggestion_info.proximity.radius_units = RADIUS_UNITS
    #
    # For more information on proximities see:
    # https://developers.google.com/google-ads/api/reference/rpc/latest/ProximityInfo
    location = client.get_type("LocationInfo")
    # Set the location to the resource name of the given geo target constant.
    location.geo_target_constant = client.get_service(
        "GeoTargetConstantService"
    ).geo_target_constant_path(_GEO_TARGET_CONSTANT)
    # Add the LocationInfo object to the list of locations on the
    # suggestion_info object. You have the option of providing multiple
    # locations when using location-based suggestions.
    suggestion_info.location_list.locations.append(location)

    # Set either of the business_profile_location or business_name, depending on
    # whichever is provided.
    if business_profile_location:
        suggestion_info.business_profile_location = business_profile_location
    else:
        suggestion_info.business_context.business_name = business_name

    # Add a schedule detailing which days of the week the business is open.
    # This schedule describes a schedule in which the business is open on
    # Mondays from 9am to 5pm.
    ad_schedule_info = client.get_type("AdScheduleInfo")
    # Set the day of this schedule as Monday.
    ad_schedule_info.day_of_week = client.enums.DayOfWeekEnum.MONDAY
    # Set the start hour to 9am.
    ad_schedule_info.start_hour = 9
    # Set the end hour to 5pm.
    ad_schedule_info.end_hour = 17
    # Set the start and end minute of zero, for example: 9:00 and 5:00.
    zero_minute_of_hour = client.enums.MinuteOfHourEnum.ZERO
    ad_schedule_info.start_minute = zero_minute_of_hour
    ad_schedule_info.end_minute = zero_minute_of_hour
    suggestion_info.ad_schedules.append(ad_schedule_info)

    return suggestion_info
      

Ruby

# Builds a SmartCampaignSuggestionInfo object with business details.
#
# The details are used by the SmartCampaignSuggestService to suggest a
# budget amount as well as creatives for the ad.
#
# Note that when retrieving ad creative suggestions it's required that the
# "final_url", "language_code" and "keyword_themes" fields are set on the
# SmartCampaignSuggestionInfo instance.
def get_smart_campaign_suggestion_info(
  client,
  business_profile_location,
  business_name)

  # Since these suggestions are for a new campaign, we're going to
  # use the suggestion_info field instead.
  suggestion_info = client.resource.smart_campaign_suggestion_info do |si|
    # Adds the URL of the campaign's landing page.
    si.final_url = LANDING_PAGE_URL
    # Add the language code for the campaign.
    si.language_code = LANGUAGE_CODE
    # Constructs location information using the given geo target constant. It's
    # also possible to provide a geographic proximity using the "proximity"
    # field on suggestion_info, for example:
    # si.proximity = client.resource.proximity_info do |proximity|
    #   proximity.address = client.resource.address_info do |address|
    #     address.post_code = INSERT_POSTAL_CODE
    #     address.province_code = INSERT_PROVINCE_CODE
    #     address.country_code = INSERT_COUNTRY_CODE
    #     address.province_name = INSERT_PROVINCE_NAME
    #     address.street_address = INSERT_STREET_ADDRESS
    #     address.street_address2 = INSERT_STREET_ADDRESS_2
    #     address.city_name = INSERT_CITY_NAME
    #   end
    #   proximity.radius = INSERT_RADIUS
    #   proximity.radius_units = :INSERT_RADIUS_UNIT_ENUM
    # end
    #
    # For more information on proximities see:
    # https://developers.google.com/google-ads/api/reference/rpc/latest/ProximityInfo
    si.location_list = client.resource.location_list do |loc_list|
      # Adds the location_info object to the list of locations on the
      # suggestion_info object. You have the option of providing multiple
      # locations when using location-based suggestions.
      loc_list.locations << client.resource.location_info do |li|
        li.geo_target_constant = client.path.geo_target_constant(GEO_TARGET_CONSTANT)
      end
    end
    # Set either of the business_profile_location or business_name, depending on
    # whichever is provided.
    if business_profile_location
      si.business_profile_location = business_profile_location
    else
      si.business_context = client.resource.business_context do |bc|
        bc.business_name = business_name
      end
    end
    # Adds a schedule detailing which days of the week the business is open.
    # This schedule describes a schedule in which the business is open on
    # Mondays from 9am to 5pm.
    si.ad_schedules += [
      client.resource.ad_schedule_info do |as|
        # Sets the day of this schedule as Monday.
        as.day_of_week = :MONDAY
        # Sets the start hour to 9:00am.
        as.start_hour = 9
        as.start_minute = :ZERO
        # Sets the end hour to 5:00pm.
        as.end_hour = 17
        as.end_minute = :ZERO
      end
    ]
  end

  suggestion_info
end
      

Perl

# Builds a SmartCampaignSuggestionInfo object with business details.
# The details are used by the SmartCampaignSuggestService to suggest a budget
# amount as well as creatives for the ad.
# Note that when retrieving ad creative suggestions you must set the
# "final_url", "language_code" and "keyword_themes" fields on the
# SmartCampaignSuggestionInfo instance.
sub _get_smart_campaign_suggestion_info {
  my ($business_profile_location, $business_name) = @_;

  my $suggestion_info =
    Google::Ads::GoogleAds::V11::Services::SmartCampaignSuggestService::SmartCampaignSuggestionInfo
    ->new({
      # Add the URL of the campaign's landing page.
      finalUrl => LANDING_PAGE_URL,
      # Add the language code for the campaign.
      languageCode => LANGUAGE_CODE,
      # Construct location information using the given geo target constant.
      # It's also possible to provide a geographic proximity using the
      # "proximity" field on suggestion_info, for example:
      #
      # proximity => Google::Ads::GoogleAds::V11::Common::ProximityInfo->new({
      #     address => Google::Ads::GoogleAds::V11::Common::AddressInfo->new({
      #         postalCode     => "INSERT_POSTAL_CODE",
      #         provinceCode   => "INSERT_PROVINCE_CODE",
      #         countryCode    => "INSERT_COUNTRY_CODE",
      #         provinceName   => "INSERT_PROVINCE_NAME",
      #         streetAddress  => "INSERT_STREET_ADDRESS",
      #         streetAddress2 => "INSERT_STREET_ADDRESS_2",
      #         cityName       => "INSERT_CITY_NAME"
      #       }
      #     ),
      #     radius      => "INSERT_RADIUS",
      #     radiusUnits => MILES
      #   }
      # ),
      #
      # For more information on proximities see:
      # https://developers.google.com/google-ads/api/reference/rpc/latest/ProximityInfo
      locationList =>
        Google::Ads::GoogleAds::V11::Services::SmartCampaignSuggestService::LocationList
        ->new(
        )});

  # Add the LocationInfo object to the list of locations on the SuggestionInfo
  # object. You have the option of providing multiple locations when using
  # location-based suggestions.
  push
    @{$suggestion_info->{locationList}{locations}},
    Google::Ads::GoogleAds::V11::Common::LocationInfo->new({
      # Set the location to the resource name of the given geo target constant.
      geoTargetConstant =>
        Google::Ads::GoogleAds::V11::Utils::ResourceNames::geo_target_constant(
        GEO_TARGET_CONSTANT)});

  # Set one of the business_profile_location or business_name, whichever is provided.
  if (defined $business_profile_location) {
    $suggestion_info->{businessProfileLocation} =
      _convert_business_profile_location($business_profile_location);
  } else {
    $suggestion_info->{businessContext} =
      Google::Ads::GoogleAds::V11::Services::SmartCampaignSuggestService::BusinessContext
      ->new({
        businessName => $business_name
      });
  }

  # Add a schedule detailing which days of the week the business is open. This
  # example schedule describes a business that is open on Mondays from 9:00 AM
  # to 5:00 PM.
  push
    @{$suggestion_info->{adSchedules}},
    Google::Ads::GoogleAds::V11::Common::AdScheduleInfo->new({
      # Set the day of this schedule as Monday.
      dayOfWeek => MONDAY,
      # Set the start hour to 9 AM.
      startHour => 9,
      # Set the end hour to 5 PM.
      endHour => 17,
      # Set the start and end minutes to zero.
      startMinute => ZERO,
      endMinute   => ZERO
    });

  return $suggestion_info;
}
      

Recuperar um identificador de local do Perfil da empresa

O campo business_profile_location nos objetos SmartCampaignSuggestionInfo e SmartCampaignSetting espera o identificador de um local do Perfil da empresa obtido na API Business Profile ou na IU do Perfil da empresa. O identificador precisa ser uma string no formato mostrado abaixo:

locations/{locationId}

Criar uma lista de temas de palavra-chave

Um tema de palavra-chave é uma única palavra ou frase que representa um grupo de termos de pesquisa relacionados. Por exemplo, "confeitaria" está relacionada a "padaria perto de mim" e a "padaria local". Elas são representadas na API Google Ads pelo recurso KeywordThemeConstant.

Constantes geradas de tema de palavra-chave

Com uma instância SmartCampaignSuggestionInfo, o método de serviço SuggestKeywordThemes sugere temas de palavra-chave usando os detalhes da sua empresa, o local e o conteúdo do site.

Java

private List<KeywordThemeConstant> getKeywordThemeSuggestions(
    GoogleAdsClient googleAdsClient,
    long customerId,
    SmartCampaignSuggestionInfo suggestionInfo) {
  // Creates the service client.
  try (SmartCampaignSuggestServiceClient client =
      googleAdsClient.getLatestVersion().createSmartCampaignSuggestServiceClient()) {
    // Sends the request.
    SuggestKeywordThemesResponse response =
        client.suggestKeywordThemes(
            SuggestKeywordThemesRequest.newBuilder()
                .setSuggestionInfo(suggestionInfo)
                .setCustomerId(String.valueOf(customerId))
                .build());
    // Prints some information about the result.
    System.out.printf(
        "Retrieved %d keyword theme constant suggestions from the SuggestKeywordThemes method.%n",
        response.getKeywordThemesCount());
    return new ArrayList(response.getKeywordThemesList());
  }
}
      

C#

/// <summary>
/// Retrieves KeywordThemeConstants suggestions with the SmartCampaignSuggestService.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID.</param>
/// <param name="suggestionInfo">The suggestion information.</param>
/// <returns>The suggestions.</returns>
private List<KeywordThemeConstant> GetKeywordThemeSuggestions(
    GoogleAdsClient client, long customerId, SmartCampaignSuggestionInfo suggestionInfo)
{
    SmartCampaignSuggestServiceClient smartCampaignSuggestService =
        client.GetService(Services.V11.SmartCampaignSuggestService);

    SuggestKeywordThemesRequest request = new SuggestKeywordThemesRequest()
    {
        SuggestionInfo = suggestionInfo,
        CustomerId = customerId.ToString()
    };

    SuggestKeywordThemesResponse response =
        smartCampaignSuggestService.SuggestKeywordThemes(request);

    // Prints some information about the result.
    Console.WriteLine($"Retrieved {response.KeywordThemes.Count} keyword theme " +
        $"constant suggestions from the SuggestKeywordThemes method.");
    return response.KeywordThemes.ToList();
}
      

PHP

private static function getKeywordThemeSuggestions(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    SmartCampaignSuggestionInfo $suggestionInfo
): array {
    $smartCampaignSuggestServiceClient =
        $googleAdsClient->getSmartCampaignSuggestServiceClient();

    // Issues a request to retrieve the keyword theme constants.
    $response =
        $smartCampaignSuggestServiceClient->suggestKeywordThemes($customerId, $suggestionInfo);

    printf(
        "Retrieved %d keyword theme constant suggestions from the SuggestKeywordThemes "
        . "method.%s",
        $response->getKeywordThemes()->count(),
        PHP_EOL
    );
    return iterator_to_array($response->getKeywordThemes()->getIterator());
}
      

Python

def get_keyword_theme_suggestions(client, customer_id, suggestion_info):
    """Retrieves KeywordThemeConstants using the given suggestion info.

    Here we use the SuggestKeywordThemes method, which uses all of the business
    details included in the given SmartCampaignSuggestionInfo instance to
    generate keyword theme suggestions. This is the recommended way to
    generate keyword themes because it uses detailed information about your
    business, its location, and website content to generate keyword themes.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        suggestion_info: a SmartCampaignSuggestionInfo instance with details
          about the business being advertised.

    Returns:
        a list of KeywordThemeConstants.
    """
    smart_campaign_suggest_service = client.get_service(
        "SmartCampaignSuggestService"
    )
    request = client.get_type("SuggestKeywordThemesRequest")
    request.customer_id = customer_id
    request.suggestion_info = suggestion_info

    response = smart_campaign_suggest_service.suggest_keyword_themes(
        request=request
    )

    print(
        f"Retrieved {len(response.keyword_themes)} keyword theme constant "
        "suggestions from the SuggestKeywordThemes method."
    )
    return response.keyword_themes
      

Ruby

def get_keyword_theme_suggestions(client, customer_id, suggestion_info)
  response = client.service.smart_campaign_suggest.suggest_keyword_themes(
    customer_id: customer_id,
    suggestion_info: suggestion_info,
  )

  puts "Retrieved #{response.keyword_themes.size} keyword theme constant" \
    " suggestions from SuggestKeywordThemes service."
  return response.keyword_themes
end
      

Perl

# Retrieves KeywordThemeConstants using the given suggestion info.
# Here we use the SuggestKeywordThemes method, which uses all of the business
# details included in the given SmartCampaignSuggestionInfo instance to generate
# keyword theme suggestions. This is the recommended way to generate keyword themes
# because it uses detailed information about your business, its location, and
# website content to generate keyword themes.
sub _get_keyword_theme_suggestions {
  my ($api_client, $customer_id, $suggestion_info) = @_;

  my $response =
    $api_client->SmartCampaignSuggestService()->suggest_keyword_themes(
    Google::Ads::GoogleAds::V11::Services::SmartCampaignSuggestService::SuggestKeywordThemesRequest
      ->new({
        customerId     => $customer_id,
        suggestionInfo => $suggestion_info
      }));

  printf "Retrieved %d keyword theme constant suggestions "
    . "from the SuggestKeywordThemes method.\n",
    scalar @{$response->{keywordThemes}};

  return $response->{keywordThemes};
}
      

Com uma palavra ou frase, o KeywordThemeConstantService sugere KeywordThemeConstants, que são derivadas de dados de preenchimento automático para o texto fornecido. Essa estratégia é uma alternativa útil se, por exemplo, a empresa anunciada não tem um site ou informações suficientes para aproveitar o método SuggestKeywordThemes.

Java

private List<KeywordThemeConstant> getKeywordTextAutoCompletions(
    GoogleAdsClient googleAdsClient, String keywordText) {
  try (KeywordThemeConstantServiceClient client =
      googleAdsClient.getLatestVersion().createKeywordThemeConstantServiceClient()) {
    SuggestKeywordThemeConstantsRequest request =
        SuggestKeywordThemeConstantsRequest.newBuilder()
            .setQueryText(keywordText)
            .setCountryCode(COUNTRY_CODE)
            .setLanguageCode(LANGUAGE_CODE)
            .build();
    SuggestKeywordThemeConstantsResponse response = client.suggestKeywordThemeConstants(request);
    return response.getKeywordThemeConstantsList();
  }
}
      

C#

/// <summary>
/// Retrieves KeywordThemeConstants that are derived from autocomplete data for the
/// given keyword text.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="keywordText">A keyword used for generating keyword auto completions.
/// </param>
/// <returns>A list of KeywordThemeConstants.</returns>
private IEnumerable<KeywordThemeConstant> GetKeywordTextAutoCompletions(
    GoogleAdsClient client, string keywordText)
{
    KeywordThemeConstantServiceClient keywordThemeConstantServiceClient =
        client.GetService(Services.V11.KeywordThemeConstantService);

    SuggestKeywordThemeConstantsRequest request = new SuggestKeywordThemeConstantsRequest
    {
        QueryText = keywordText,
        CountryCode = COUNTRY_CODE,
        LanguageCode = LANGUAGE_CODE
    };

    SuggestKeywordThemeConstantsResponse response =
        keywordThemeConstantServiceClient.SuggestKeywordThemeConstants(request);

    Console.WriteLine($"Retrieved {response.KeywordThemeConstants.Count} keyword theme " +
        $"constants using the keyword '{keywordText}'.");
    return response.KeywordThemeConstants.ToList();
}
      

PHP

private static function getKeywordTextAutoCompletions(
    GoogleAdsClient $googleAdsClient,
    string $keywordText
): array {
    $keywordThemeConstantService = $googleAdsClient->getKeywordThemeConstantServiceClient();

    // Issues a request to retrieve the keyword theme constants.
    $response = $keywordThemeConstantService->suggestKeywordThemeConstants([
        'queryText' => $keywordText,
        'countryCode' => self::COUNTRY_CODE,
        'languageCode' => self::LANGUAGE_CODE
    ]);

    printf(
        "Retrieved %d keyword theme constants using the keyword: '%s'.%s",
        $response->getKeywordThemeConstants()->count(),
        $keywordText,
        PHP_EOL
    );
    return iterator_to_array($response->getKeywordThemeConstants()->getIterator());
}
      

Python

def get_keyword_text_auto_completions(client, keyword_text):
    """Retrieves KeywordThemeConstants for the given keyword text.

    These KeywordThemeConstants are derived from autocomplete data for the
    given keyword text.

    Args:
        client: an initialized GoogleAdsClient instance.
        keyword_text: a keyword used for generating keyword themes.

    Returns:
        a list of KeywordThemeConstants.
    """
    keyword_theme_constant_service = client.get_service(
        "KeywordThemeConstantService"
    )
    request = client.get_type("SuggestKeywordThemeConstantsRequest")
    request.query_text = keyword_text
    request.country_code = _COUNTRY_CODE
    request.language_code = _LANGUAGE_CODE

    response = keyword_theme_constant_service.suggest_keyword_theme_constants(
        request=request
    )

    print(
        f"Retrieved {len(response.keyword_theme_constants)} keyword theme "
        f"constants using the keyword: '{keyword_text}'"
    )
    return response.keyword_theme_constants
      

Ruby

# Retrieves keyword_theme_constants for the given criteria.
def get_keyword_text_auto_completions(client, keyword_text)
  response = client.service.keyword_theme_constant.suggest_keyword_theme_constants(
    query_text: keyword_text,
    country_code: COUNTRY_CODE,
    language_code: LANGUAGE_CODE,
  )

  puts "Retrieved #{response.keyword_theme_constants.size} keyword theme" \
    "constants using the keyword: '#{keyword_text}'"

  response.keyword_theme_constants
end
      

Perl

# Retrieves KeywordThemeConstants for the given keyword text.
# These KeywordThemeConstants are derived from autocomplete data for the given
# keyword text.
sub _get_keyword_text_auto_completions {
  my ($api_client, $keyword_text) = @_;

  my $response = $api_client->KeywordThemeConstantService()->suggest(
    Google::Ads::GoogleAds::V11::Services::KeywordThemeConstantService::SuggestKeywordThemeConstantsRequest
      ->new({
        queryText    => $keyword_text,
        countryCode  => COUNTRY_CODE,
        languageCode => LANGUAGE_CODE
      }));

  printf "Retrieved %d keyword theme constants using the keyword '%s'.\n",
    scalar @{$response->{keywordThemeConstants}}, $keyword_text;

  return $response->{keywordThemeConstants};
}
      

Temas de palavra-chave em formato livre

Por fim, é possível criar temas de palavras-chave de formato livre configurando manualmente o campo free_form_keyword_theme em uma instância KeywordThemeInfo. Geralmente, não é recomendável usar temas de palavras-chave de formato livre porque eles são menos eficazes do que os temas de palavras-chave sugeridos. No entanto, eles são úteis em situações em que um termo muito específico precisa ser segmentado ou quando você quer segmentar negativamente um termo.

Java

if (freeFormKeywordText != null) {
  keywordThemeInfos.add(
      KeywordThemeInfo.newBuilder().setFreeFormKeywordTheme(freeFormKeywordText).build());
}
      

C#

suggestionInfo.KeywordThemes.Add(keywordThemeInfos);
      

PHP

// Optionally includes any freeform keywords in verbatim.
if (!empty($freeformKeywordText)) {
    $keywordThemeInfos[] =
        new KeywordThemeInfo(['free_form_keyword_theme' => $freeformKeywordText]);
}
      

Python

def get_freeform_keyword_theme_info(client, freeform_keyword_text):
    """Creates a KeywordThemeInfo using the given free-form keyword text.

    Args:
        client: an initialized GoogleAdsClient instance.
        freeform_keyword_text: a keyword used to create a free-form keyword
          theme.

    Returns:
        a KeywordThemeInfo instance.
    """
    info = client.get_type("KeywordThemeInfo")
    info.free_form_keyword_theme = freeform_keyword_text
    return info
      

Ruby

def get_freeform_keyword_theme_info(client, freeform_keyword_text)
  client.resource.keyword_theme_info do |kti|
    kti.free_form_keyword_theme = freeform_keyword_text
  end
end
      

Perl

# Creates a KeywordInfo instance using the given free-form keyword text.
sub _get_freeform_keyword_theme_info {
  my ($freeform_keyword_text) = @_;

  return Google::Ads::GoogleAds::V11::Common::KeywordThemeInfo->new({
    freeFormKeywordTheme => $freeform_keyword_text
  });
}
      

Essas três estratégias também podem ser combinadas. Para isso, todas elas precisam ser convertidas em instâncias KeywordThemeInfo e adicionadas à instância SmartCampaignSuggestionInfo, que pode ser usada para gerar sugestões de um valor de orçamento e criativos de texto de anúncios.

Java

// Gets the SmartCampaignSuggestionInfo object which acts as the basis for many of the
// entities necessary to create a Smart campaign. It will be reused a number of times to
// retrieve suggestions for keyword themes, budget amount, ad creatives, and campaign criteria.
SmartCampaignSuggestionInfo suggestionInfo =
    getSmartCampaignSuggestionInfo(googleAdsClient, businessProfileLocation, businessName);

// Generates a list of keyword themes using the SuggestKeywordThemes method on the
// SmartCampaignSuggestService. It is strongly recommended that you use this strategy for
// generating keyword themes.
List<KeywordThemeConstant> keywordThemeConstants =
    getKeywordThemeSuggestions(googleAdsClient, customerId, suggestionInfo);

// Optionally retrieves auto-complete suggestions for the given keyword text and adds them to
// the list of keyWordThemeConstants.
if (keyword != null) {
  keywordThemeConstants.addAll(getKeywordTextAutoCompletions(googleAdsClient, keyword));
}

// Converts the KeywordThemeConstants to KeywordThemeInfos.
List<KeywordThemeInfo> keywordThemeInfos = getKeywordThemeInfos(keywordThemeConstants);

// Optionally includes any freeform keywords in verbatim.
if (freeFormKeywordText != null) {
  keywordThemeInfos.add(
      KeywordThemeInfo.newBuilder().setFreeFormKeywordTheme(freeFormKeywordText).build());
}

// Includes the keyword suggestions in the overall SuggestionInfo object.
suggestionInfo = suggestionInfo.toBuilder().addAllKeywordThemes(keywordThemeInfos).build();
      

C#

// Gets the SmartCampaignSuggestionInfo object which acts as the basis for many
// of the entities necessary to create a Smart campaign. It will be reused a number
// of times to retrieve suggestions for keyword themes, budget amount, ad
//creatives, and campaign criteria.
SmartCampaignSuggestionInfo suggestionInfo =
    GetSmartCampaignSuggestionInfo(client, businessProfileLocation, businessName);

// Generates a list of keyword themes using the SuggestKeywordThemes method on the
// SmartCampaignSuggestService. It is strongly recommended that you use this
// strategy for generating keyword themes.
List<KeywordThemeConstant> keywordThemeConstants =
    GetKeywordThemeSuggestions(client, customerId, suggestionInfo);

// Optionally retrieves auto-complete suggestions for the given keyword text and
// adds them to the list of keyWordThemeConstants.
if (keywordText != null)
{
    keywordThemeConstants.AddRange(GetKeywordTextAutoCompletions(
        client, keywordText));
}

// Converts the KeywordThemeConstants to KeywordThemeInfos.
List<KeywordThemeInfo> keywordThemeInfos = keywordThemeConstants.Select(
    constant =>
        new KeywordThemeInfo { KeywordThemeConstant = constant.ResourceName })
    .ToList();

// Optionally includes any freeform keywords verbatim.
if (freeFormKeywordText != null)
{
    keywordThemeInfos.Add(new KeywordThemeInfo()
    {
        FreeFormKeywordTheme = freeFormKeywordText
    });
}

// Includes the keyword suggestions in the overall SuggestionInfo object.
suggestionInfo.KeywordThemes.Add(keywordThemeInfos);
      

PHP

// Gets the SmartCampaignSuggestionInfo object which acts as the basis for many of the
// entities necessary to create a Smart campaign. It will be reused a number of times to
// retrieve suggestions for keyword themes, budget amount, ads, and campaign criteria.
$suggestionInfo = self::getSmartCampaignSuggestionInfo(
    $businessProfileLocationResourceName,
    $businessName
);

// Generates a list of keyword themes using the SuggestKeywordThemes method on the
// SmartCampaignSuggestService. It is strongly recommended that you use this strategy for
// generating keyword themes.
$keywordThemeConstants =
    self::getKeywordThemeSuggestions($googleAdsClient, $customerId, $suggestionInfo);

// Optionally retrieves auto-complete suggestions for the given keyword text and adds them
// to the list of keyword themes.
if (!empty($keywordText)) {
    $keywordThemeConstants = array_merge(
        $keywordThemeConstants,
        self::getKeywordTextAutoCompletions($googleAdsClient, $keywordText)
    );
}

// Maps the list of KeywordThemeConstants to KeywordThemeInfos.
$keywordThemeInfos = array_map(function (KeywordThemeConstant $constant) {
    return new KeywordThemeInfo([
        'keyword_theme_constant' => $constant->getResourceName()
    ]);
}, $keywordThemeConstants);

// Optionally includes any freeform keywords in verbatim.
if (!empty($freeformKeywordText)) {
    $keywordThemeInfos[] =
        new KeywordThemeInfo(['free_form_keyword_theme' => $freeformKeywordText]);
}
// Includes the keyword suggestions in the overall SuggestionInfo object.
$suggestionInfo = $suggestionInfo->setKeywordThemes($keywordThemeInfos);
      

Python

# The SmartCampaignSuggestionInfo object acts as the basis for many of the
# entities necessary to create a Smart campaign. It will be reused a number
# of times to retrieve suggestions for keyword themes, budget amount,
# ad creatives, and campaign criteria.
suggestion_info = get_smart_campaign_suggestion_info(
    client, business_profile_location, business_name
)

# After creating a SmartCampaignSuggestionInfo object we first use it to
# generate a list of keyword themes using the SuggestKeywordThemes method
# on the SmartCampaignSuggestService. It is strongly recommended that you
# use this strategy for generating keyword themes.
keyword_theme_constants = get_keyword_theme_suggestions(
    client, customer_id, suggestion_info
)

# If a keyword text is given retrieve keyword theme constant suggestions
# from the KeywordThemeConstantService and append them to the existing list.
if keyword_text:
    keyword_theme_constants.extend(
        get_keyword_text_auto_completions(client, keyword_text)
    )

# Map the KeywordThemeConstants retrieved by the previous two steps to
# KeywordThemeInfo instances.
keyword_theme_infos = map_keyword_theme_constants_to_infos(
    client, keyword_theme_constants
)

# If a free-form keyword text is given we create a KeywordThemeInfo instance
# from it and add it to the existing list.
if freeform_keyword_text:
    keyword_theme_infos.append(
        get_freeform_keyword_theme_info(client, freeform_keyword_text)
    )

# Now add the generated keyword themes to the suggestion info instance.
suggestion_info.keyword_themes = keyword_theme_infos
      

Ruby

# The SmartCampaignSuggestionInfo object acts as the basis for many of the
# entities necessary to create a Smart campaign. It will be reused a number
# of times to retrieve suggestions for keyword themes, budget amount,
# ad creatives, and campaign criteria.
suggestion_info = get_smart_campaign_suggestion_info(
  client,
  business_profile_location,
  business_name,
)

# After creating a SmartCampaignSuggestionInfo object we first use it to
# generate a list of keyword themes using the SuggestKeywordThemes method
# on the SmartCampaignSuggestService. It is strongly recommended that you
# use this strategy for generating keyword themes.
keyword_theme_constants = get_keyword_theme_suggestions(
  client,
  customer_id,
  suggestion_info,
)

# If a keyword text is given retrieve keyword theme constant suggestions
# from the KeywordThemeConstantService and append them to the existing list.
if keyword_text
  keyword_theme_constants += get_keyword_text_auto_completions(
    client,
    keyword_text,
  )
end

# Map the KeywordThemeConstants retrieved by the previous two steps to
# KeywordThemeInfo instances.
keyword_theme_infos = map_keyword_theme_constants_to_infos(
  client,
  keyword_theme_constants,
)

# If a free-form keyword text is given we create a KeywordThemeInfo instance
# from it and add it to the existing list.
if freeform_keyword_text
  keyword_theme_infos << get_freeform_keyword_theme_info(
    client,
    freeform_keyword_text,
  )
end

# Now add the generated keyword themes to the suggestion info instance.
suggestion_info.keyword_themes += keyword_theme_infos
      

Perl

# The SmartCampaignSuggestionInfo object acts as the basis for many of the
# entities necessary to create a Smart campaign. It will be reused a number
# of times to retrieve suggestions for keyword themes, budget amount,
# ad creatives, and campaign criteria.
my $suggestion_info =
  _get_smart_campaign_suggestion_info($business_profile_location,
  $business_name);

# After creating a SmartCampaignSuggestionInfo object we first use it to
# generate a list of keyword themes using the SuggestKeywordThemes method
# on the SmartCampaignSuggestService. It is strongly recommended that you
# use this strategy for generating keyword themes.
my $keyword_theme_constants =
  _get_keyword_theme_suggestions($api_client, $customer_id, $suggestion_info);

# If a keyword text is given retrieve keyword theme constant suggestions
# from the KeywordThemeConstantService and append them to the existing list.
if (defined $keyword_text) {
  push @$keyword_theme_constants,
    @{_get_keyword_text_auto_completions($api_client, $keyword_text)};
}

# Map the KeywordThemeConstants retrieved by the previous two steps to
# KeywordThemeInfo instances.
my $keyword_theme_infos =
  _map_keyword_theme_constants_to_infos($keyword_theme_constants);

# If a free-form keyword text is given we create a KeywordThemeInfo instance
# from it and add it to the existing list.
if (defined $freeform_keyword_text) {
  push @$keyword_theme_infos,
    _get_freeform_keyword_theme_info($freeform_keyword_text);
}

# Now add the generated keyword themes to the suggestion info instance.
$suggestion_info->{keywordThemes} = $keyword_theme_infos;
      

Receber valor do orçamento sugerido

A SmartCampaignSuggestService tem um método SuggestSmartCampaignBudgetOptions que sugere três níveis de opções de orçamento diário quando recebe um conjunto de temas de palavra-chave e detalhes da empresa. Os níveis são low, high e recommended, e cada opção também inclui um número mínimo e máximo estimado de cliques diários.

Java

private long getBudgetSuggestions(
    GoogleAdsClient googleAdsClient,
    long customerId,
    SmartCampaignSuggestionInfo suggestionInfo) {
  SuggestSmartCampaignBudgetOptionsRequest.Builder request =
      SuggestSmartCampaignBudgetOptionsRequest.newBuilder()
          .setCustomerId(String.valueOf(customerId));

  // You can retrieve suggestions for an existing campaign by setting the
  // "campaign" field of the request equal to the resource name of a campaign
  // and leaving the rest of the request fields below unset:
  // request.setCampaign("INSERT_CAMPAIGN_RESOURCE_NAME_HERE");

  // Uses the suggestion_info field instead, since these suggestions are for a new campaign.
  request.setSuggestionInfo(suggestionInfo);

  // Issues a request to retrieve a budget suggestion.
  try (SmartCampaignSuggestServiceClient client =
      googleAdsClient.getLatestVersion().createSmartCampaignSuggestServiceClient()) {
    SuggestSmartCampaignBudgetOptionsResponse response =
        client.suggestSmartCampaignBudgetOptions(request.build());
    BudgetOption recommendation = response.getRecommended();
    System.out.printf(
        "A daily budget amount of %d micros was suggested, garnering an estimated minimum of %d"
            + " clicks and an estimated maximum of %d per day.%n",
        recommendation.getDailyAmountMicros(),
        recommendation.getMetrics().getMinDailyClicks(),
        recommendation.getMetrics().getMaxDailyClicks());
    return recommendation.getDailyAmountMicros();
  }
}
      

C#

/// <summary>
/// Retrieves a suggested budget amount for a new budget.
/// Using the SmartCampaignSuggestService to determine a daily budget for new and existing
/// Smart campaigns is highly recommended because it helps the campaigns achieve optimal
/// performance.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID.</param>
/// <param name="suggestionInfo"></param>
/// <returns>A daily budget amount in micros.</returns>
private long GetBudgetSuggestion(GoogleAdsClient client, long customerId,
    SmartCampaignSuggestionInfo suggestionInfo)
{
    SmartCampaignSuggestServiceClient smartCampaignSuggestServiceClient = client.GetService
        (Services.V11.SmartCampaignSuggestService);

    SuggestSmartCampaignBudgetOptionsRequest request =
        new SuggestSmartCampaignBudgetOptionsRequest
        {
            CustomerId = customerId.ToString(),
            // You can retrieve suggestions for an existing campaign by setting the
            // "Campaign" field of the request to the resource name of a campaign and
            // leaving the rest of the request fields below unset:
            // Campaign = "INSERT_CAMPAIGN_RESOURCE_NAME_HERE",

            // Since these suggestions are for a new campaign, we're going to use the
            // SuggestionInfo field instead.
            SuggestionInfo = suggestionInfo,
        };

    LocationInfo locationInfo = new LocationInfo
    {
        // Set the location to the resource name of the given geo target constant.
        GeoTargetConstant = ResourceNames.GeoTargetConstant(GEO_TARGET_CONSTANT)
    };

    // Issue a request to retrieve a budget suggestion.
    SuggestSmartCampaignBudgetOptionsResponse response =
        smartCampaignSuggestServiceClient.SuggestSmartCampaignBudgetOptions(request);

    // Three tiers of options will be returned: "low", "high", and "recommended".
    // Here we will use the "recommended" option. The amount is specified in micros, where
    // one million is equivalent to one currency unit.
    Console.WriteLine($"A daily budget amount of " +
        $"{response.Recommended.DailyAmountMicros}" +
        $" was suggested, garnering an estimated minimum of " +
        $"{response.Recommended.Metrics.MinDailyClicks} clicks and an estimated " +
        $"maximum of {response.Recommended.Metrics.MaxDailyClicks} clicks per day.");

    return response.Recommended.DailyAmountMicros;
}
      

PHP

private static function getBudgetSuggestion(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    SmartCampaignSuggestionInfo $suggestionInfo
): int {
    $suggestionData = new SuggestionDataOneof();

    // You can retrieve suggestions for an existing campaign by setting the "campaign"
    // field equal to the resource name of a campaign:
    // $suggestionData->setCampaign('INSERT_CAMPAIGN_RESOURCE_NAME_HERE');

    // Since these suggestions are for a new campaign, we're going to use the
    // suggestion_info field instead.
    $suggestionData->setSuggestionInfo($suggestionInfo);

    // Issues a request to retrieve a budget suggestion.
    $smartCampaignSuggestService = $googleAdsClient->getSmartCampaignSuggestServiceClient();
    $response = $smartCampaignSuggestService->suggestSmartCampaignBudgetOptions(
        $customerId,
        $suggestionData
    );

    // Three tiers of options will be returned, a "low", "high" and "recommended". Here we will
    // use the "recommended" option. The amount is specified in micros, where one million is
    // equivalent to one currency unit.
    $recommendation = $response->getRecommended();
    printf(
        "A daily budget amount of %d micros was suggested, garnering an estimated minimum of "
        . "%d clicks and an estimated maximum of %d per day.%s",
        $recommendation->getDailyAmountMicros(),
        $recommendation->getMetrics()->getMinDailyClicks(),
        $recommendation->getMetrics()->getMaxDailyClicks(),
        PHP_EOL
    );

    return $recommendation->getDailyAmountMicros();
}
      

Python

def get_budget_suggestion(client, customer_id, suggestion_info):
    """Retrieves a suggested budget amount for a new budget.

    Using the SmartCampaignSuggestService to determine a daily budget for new
    and existing Smart campaigns is highly recommended because it helps the
    campaigns achieve optimal performance.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        suggestion_info: a SmartCampaignSuggestionInfo instance with details
          about the business being advertised.

    Returns:
        a daily budget amount in micros.
    """
    sc_suggest_service = client.get_service("SmartCampaignSuggestService")
    request = client.get_type("SuggestSmartCampaignBudgetOptionsRequest")
    request.customer_id = customer_id
    # You can retrieve suggestions for an existing campaign by setting the
    # "campaign" field of the request equal to the resource name of a campaign
    # and leaving the rest of the request fields below unset:
    # request.campaign = INSERT_CAMPAIGN_RESOURCE_NAME_HERE

    # Since these suggestions are for a new campaign, we're going to
    # use the suggestion_info field instead.
    request.suggestion_info = suggestion_info

    # Issue a request to retrieve a budget suggestion.
    response = sc_suggest_service.suggest_smart_campaign_budget_options(
        request=request
    )

    # Three tiers of options will be returned, a "low", "high" and
    # "recommended". Here we will use the "recommended" option. The amount is
    # specified in micros, where one million is equivalent to one currency unit.
    recommendation = response.recommended
    print(
        f"A daily budget amount of {recommendation.daily_amount_micros} micros "
        "was suggested, garnering an estimated minimum of "
        f"{recommendation.metrics.min_daily_clicks} clicks and an estimated "
        f"maximum of {recommendation.metrics.max_daily_clicks} per day."
    )

    return recommendation.daily_amount_micros
      

Ruby

# Retrieves a suggested budget amount for a new budget.
#
# Using the SmartCampaignSuggestService to determine a daily budget for new
# and existing Smart campaigns is highly recommended because it helps the
# campaigns achieve optimal performance.
def get_budget_suggestion(client, customer_id, suggestion_info)
  # Issues a request to retrieve a budget suggestion.
  response = client.service.smart_campaign_suggest.suggest_smart_campaign_budget_options(
    customer_id: customer_id,
    # You can retrieve suggestions for an existing campaign by setting the
    # "campaign" field of the request equal to the resource name of a campaign
    # and leaving the rest of the request fields below unset:
    # campaign: INSERT_CAMPAIGN_RESOURCE_NAME_HERE,
    # Since these suggestions are for a new campaign, we're going to
    # use the suggestion_info field instead.
    suggestion_info: suggestion_info,
  )

  # Three tiers of options will be returned, a "low", "high" and
  # "recommended". Here we will use the "recommended" option. The amount is
  # specified in micros, where one million is equivalent to one currency unit.
  recommendation = response.recommended
  puts "A daily budget amount of #{recommendation.daily_amount_micros} micros" \
    " was suggested, garnering an estimated minimum of" \
    " #{recommendation.metrics.min_daily_clicks} clicks and an estimated" \
    " maximum of #{recommendation.metrics.max_daily_clicks} per day."

  recommendation.daily_amount_micros
end
      

Perl

# Retrieves a suggested budget amount for a new budget.
# Using the SmartCampaignSuggestService to determine a daily budget for new and
# existing Smart campaigns is highly recommended because it helps the campaigns
# achieve optimal performance.
sub _get_budget_suggestion {
  my ($api_client, $customer_id, $suggestion_info) = @_;

  my $request =
    Google::Ads::GoogleAds::V11::Services::SmartCampaignSuggestService::SuggestSmartCampaignBudgetOptionsRequest
    ->new({
      customerId => $customer_id,
      # You can retrieve suggestions for an existing campaign by setting the
      # "campaign" field of the request to the resource name of a campaign and
      # leaving the rest of the request fields below unset:
      # campaign => "INSERT_CAMPAIGN_RESOURCE_NAME_HERE",
      #
      # Since these suggestions are for a new campaign, we're going to use the
      # "suggestion_info" field instead.
      suggestionInfo => $suggestion_info
    });

  # Issue a request to retrieve a budget suggestion.
  my $response = $api_client->SmartCampaignSuggestService()
    ->suggest_smart_campaign_budget_options($request);

  # Three tiers of options will be returned: "low", "high", and "recommended".
  # Here we will use the "recommended" option. The amount is specified in micros,
  # where one million is equivalent to one currency unit.
  printf "A daily budget amount of %d was suggested, garnering an estimated "
    . "minimum of %d clicks and an estimated maximum of %d clicks per day.\n",
    $response->{recommended}{dailyAmountMicros},
    $response->{recommended}{metrics}{minDailyClicks},
    $response->{recommended}{metrics}{maxDailyClicks};

  return $response->{recommended}{dailyAmountMicros};
}
      

Receber sugestões de recursos de texto do anúncio

O SmartCampaignSuggestService tem um método SuggestSmartCampaignAd que retorna uma instância SmartCampaignAdInfo com sugestões para até três títulos e duas descrições para o anúncio de campanha inteligente. Cada título e descrição está contido no campo de uma instância AdTextAsset anexada ao SmartCampaignAdInfo.

É possível que esse método não retorne nenhuma sugestão ou que as instâncias AdTextAsset retornadas tenham uma string vazia como o valor do campo text. Recomendamos que você analise as sugestões antes que elas sejam usadas para criar anúncios e garantir que eles sejam sempre criados com no mínimo três títulos e duas descrições. Se esse mínimo não for atingido ou se algum texto do recurso for muito curto, a solicitação falhará com um erro.

Java

private SmartCampaignAdInfo getAdSuggestions(
    GoogleAdsClient googleAdsClient,
    long customerId,
    SmartCampaignSuggestionInfo suggestionInfo) {
  // Unlike the SuggestSmartCampaignBudgetOptions method, it's only possible to use
  // suggestion_info to retrieve ad creative suggestions.

  // Issues a request to retrieve ad creative suggestions.
  try (SmartCampaignSuggestServiceClient smartCampaignSuggestService =
      googleAdsClient.getLatestVersion().createSmartCampaignSuggestServiceClient()) {
    SuggestSmartCampaignAdResponse response =
        smartCampaignSuggestService.suggestSmartCampaignAd(
            SuggestSmartCampaignAdRequest.newBuilder()
                .setCustomerId(Long.toString(customerId))
                .setSuggestionInfo(suggestionInfo)
                .build());

    // The SmartCampaignAdInfo object in the response contains a list of up to three headlines
    // and two descriptions. Note that some of the suggestions may have empty strings as text.
    // Before setting these on the ad you should review them and filter out any empty values.
    SmartCampaignAdInfo adSuggestions = response.getAdInfo();
    for (AdTextAsset headline : adSuggestions.getHeadlinesList()) {
      System.out.println(!headline.getText().isEmpty() ? headline.getText() : "None");
    }
    for (AdTextAsset description : adSuggestions.getDescriptionsList()) {
      System.out.println(!description.getText().isEmpty() ? description.getText() : "None");
    }
    return adSuggestions;
  }
}
      

C#

/// <summary>
/// Retrieves creative suggestions for a Smart campaign ad.
///
/// Using the SmartCampaignSuggestService to suggest creatives for new
/// and existing Smart campaigns is highly recommended because it helps
/// the campaigns achieve optimal performance.
/// </summary>
/// <param name="client"></param>
/// <param name="customerId">The Google Ads customer ID.</param>
/// <param name="suggestionInfo">a SmartCampaignSuggestionInfo instance
/// with details about the business being advertised.</param>
/// <returns>A SmartCampaignAdInfo instance with suggested headlines and
/// descriptions.</returns>
private SmartCampaignAdInfo GetAdSuggestions(GoogleAdsClient client,
    long customerId, SmartCampaignSuggestionInfo suggestionInfo)
{
    SmartCampaignSuggestServiceClient smartCampaignSuggestService =
      client.GetService(Services.V11.SmartCampaignSuggestService);

    SuggestSmartCampaignAdRequest request = new SuggestSmartCampaignAdRequest
    {
        CustomerId = customerId.ToString(),
        // Unlike the SuggestSmartCampaignBudgetOptions method, it's only possible to
        // use suggestion_info to retrieve ad creative suggestions.
        SuggestionInfo = suggestionInfo
    };

    // Issue a request to retrieve ad creative suggestions.
    SuggestSmartCampaignAdResponse response =
      smartCampaignSuggestService.SuggestSmartCampaignAd(request);

    // The SmartCampaignAdInfo object in the response contains a list of up to
    // three headlines and two descriptions. Note that some of the suggestions
    // may have empty strings as text. Before setting these on the ad you should
    // review them and filter out any empty values.
    SmartCampaignAdInfo adSuggestions = response.AdInfo;

    if (adSuggestions != null)
    {
        Console.WriteLine($"The following headlines were suggested:");
        foreach (AdTextAsset headline in adSuggestions.Headlines)
        {
            Console.WriteLine($"\t{headline.Text}");
        }

        Console.WriteLine($"And the following descriptions were suggested:");
        foreach (AdTextAsset description in adSuggestions.Descriptions)
        {
            Console.WriteLine($"\t{description.Text}");
        }
    }
    else
    {
        Console.WriteLine("No ad suggestions were found.");
        adSuggestions = new SmartCampaignAdInfo();
    }

    return adSuggestions;
}
      

PHP

private static function getAdSuggestions(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    SmartCampaignSuggestionInfo $suggestionInfo
) {
    // Unlike the SuggestSmartCampaignBudgetOptions method, it's only possible to use
    // suggestion_info to retrieve ad creative suggestions.

    // Issues a request to retrieve ad creative suggestions.
    $smartCampaignSuggestService = $googleAdsClient->getSmartCampaignSuggestServiceClient();
    $response = $smartCampaignSuggestService->suggestSmartCampaignAd(
        $customerId,
        $suggestionInfo
    );

    // The SmartCampaignAdInfo object in the response contains a list of up to three headlines
    // and two descriptions. Note that some of the suggestions may have empty strings as text.
    // Before setting these on the ad you should review them and filter out any empty values.
    $adSuggestions = $response->getAdInfo();
    if (is_null($adSuggestions)) {
        return null;
    }
    print 'The following headlines were suggested:' . PHP_EOL;
    foreach ($adSuggestions->getHeadlines() as $headline) {
        print "\t" . ($headline->getText() ?: 'None') . PHP_EOL;
    }
    print 'And the following descriptions were suggested:' . PHP_EOL;
    foreach ($adSuggestions->getDescriptions() as $description) {
        print "\t" . ($description->getText() ?: 'None') . PHP_EOL;
    }
    return $adSuggestions;
}
      

Python

def get_ad_suggestions(client, customer_id, suggestion_info):
    """Retrieves creative suggestions for a Smart campaign ad.

    Using the SmartCampaignSuggestService to suggest creatives for new and
    existing Smart campaigns is highly recommended because it helps the
    campaigns achieve optimal performance.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        suggestion_info: a SmartCampaignSuggestionInfo instance with details
          about the business being advertised.

    Returns:
        a SmartCampaignAdInfo instance with suggested headlines and
            descriptions.
    """
    sc_suggest_service = client.get_service("SmartCampaignSuggestService")
    request = client.get_type("SuggestSmartCampaignAdRequest")
    request.customer_id = customer_id

    # Unlike the SuggestSmartCampaignBudgetOptions method, it's only possible
    # to use suggestion_info to retrieve ad creative suggestions.
    request.suggestion_info = suggestion_info

    # Issue a request to retrieve ad creative suggestions.
    response = sc_suggest_service.suggest_smart_campaign_ad(request=request)

    # The SmartCampaignAdInfo object in the response contains a list of up to
    # three headlines and two descriptions. Note that some of the suggestions
    # may have empty strings as text. Before setting these on the ad you should
    # review them and filter out any empty values.
    ad_suggestions = response.ad_info

    print("The following headlines were suggested:")
    for headline in ad_suggestions.headlines:
        print(f"\t{headline.text or '<None>'}")

    print("And the following descriptions were suggested:")
    for description in ad_suggestions.descriptions:
        print(f"\t{description.text or '<None>'}")

    return ad_suggestions
      

Ruby

# Retrieves creative suggestions for a Smart campaign ad.
#
# Using the SmartCampaignSuggestService to suggest creatives for new and
# existing Smart campaigns is highly recommended because it helps the
# campaigns achieve optimal performance.
def get_ad_suggestions(client, customer_id, suggestion_info)
  # Issue a request to retrieve ad creative suggestions.
  response = client.service.smart_campaign_suggest.suggest_smart_campaign_ad(
    customer_id: customer_id,
    # Unlike the SuggestSmartCampaignBudgetOptions method, it's only possible
    # to use suggestion_info to retrieve ad creative suggestions.
    suggestion_info: suggestion_info,
  )

  # The SmartCampaignAdInfo object in the response contains a list of up to
  # three headlines and two descriptions. Note that some of the suggestions
  # may have empty strings as text. Before setting these on the ad you should
  # review them and filter out any empty values.
  ad_suggestions = response.ad_info

  # If there are no suggestions, the response will be blank.
  return nil if ad_suggestions.nil?

  puts 'The following headlines were suggested:'
  ad_suggestions.headlines.each do  |headline|
    puts "\t#{headline.text || '<None>'}"
  end

  puts 'And the following descriptions were suggested:'
  ad_suggestions.descriptions.each do |description|
    puts "\t#{description.text || '<None>'}"
  end

  ad_suggestions
end
      

Perl

# Retrieves creative suggestions for a Smart campaign ad.
# Using the SmartCampaignSuggestService to suggest creatives for new and
# existing Smart campaigns is highly recommended because it helps the campaigns
# achieve optimal performance.
sub _get_ad_suggestions {
  my ($api_client, $customer_id, $suggestion_info) = @_;

  # Issue a request to retrieve ad creative suggestions.
  my $response =
    $api_client->SmartCampaignSuggestService()->suggest_smart_campaign_ad(
    Google::Ads::GoogleAds::V11::Services::SmartCampaignSuggestService::SuggestSmartCampaignAdRequest
      ->new({
        customerId => $customer_id,
        # Unlike the SuggestSmartCampaignBudgetOptions method, it's only
        # possible to use suggestion_info to retrieve ad creative suggestions.
        suggestionInfo => $suggestion_info
      }));

  # The SmartCampaignAdInfo object in the response contains a list of up to
  # three headlines and two descriptions. Note that some of the suggestions
  # may have empty strings as text. Before setting these on the ad you should
  # review them and filter out any empty values.
  my $ad_suggestions = $response->{adInfo};
  printf "The following headlines were suggested:\n";
  foreach my $headline (@{$ad_suggestions->{headlines}}) {
    printf "\t%s\n", defined $headline->{text} ? $headline->{text} : "<None>";
  }
  printf "And the following descriptions were suggested:\n";
  foreach my $description (@{$ad_suggestions->{descriptions}}) {
    printf "\t%s\n",
      defined $description->{text} ? $description->{text} : "<None>";
  }

  return $ad_suggestions;
}