Get started with Performance Max

This guide provides a checklist of concepts and tasks for each of the three Performance Max business goals to help you build your campaign. To get started, select a business goal:

Performance Max for travel goals

Performance Max allows advertisers to access all Google Ads channels and inventory from a single, unified campaign. The steps to create a Performance Max campaign for travel goals are as follows. Click the links in each section for more information.

Performance Max concepts

Learn about Performance Max for travel goals

Performance Max for travel goals campaigns let you create ads for hotel properties that serve across Google channels such as Search, Display, Video, and Discover.

When creating a Performance Max campaign, you can use a bulk mutate request to create the resources required to form a valid, serving campaign in a single request. Not all resources must be created in a single bulk mutate request. The following resources are required to create a valid, serving Performance Max campaign. Learn more in the Structure requests guide.

CampaignBudget
Campaign
AssetGroups
AssetGroupAssets

Hotel asset sets and suggested assets

Create asset entities for your hotel properties

Create a hotel property asset set of type HOTEL_PROPERTY by setting AssetSet.type to AssetSetType.HOTEL_PROPERTY. You'll use the resource name of the created asset set in the later steps.

Code example

Java

private String createHotelAssetSet(GoogleAdsClient googleAdsClient, long customerId) {
  // Creates an asset set operation for a hotel property asset set.
  AssetSetOperation assetSetOperation =
      AssetSetOperation.newBuilder()
          .setCreate(
              AssetSet.newBuilder()
                  .setName(
                      "My Hotel propery asset set #" + CodeSampleHelper.getPrintableDateTime())
                  .setType(AssetSetType.HOTEL_PROPERTY))
          .build();
  try (AssetSetServiceClient assetSetServiceClient =
      googleAdsClient.getLatestVersion().createAssetSetServiceClient()) {
    MutateAssetSetsResponse mutateAssetSetsResponse =
        assetSetServiceClient.mutateAssetSets(
            Long.toString(customerId), ImmutableList.of(assetSetOperation));
    String assetSetResourceName = mutateAssetSetsResponse.getResults(0).getResourceName();
    System.out.printf("Created an asset set with resource name: '%s'%n", assetSetResourceName);
    return assetSetResourceName;
  }
}AddPerformanceMaxForTravelGoalsCampaign.java

C#

private string CreateHotelAssetSet(GoogleAdsClient client, long customerId)
{
    AssetSetOperation operation = new AssetSetOperation()
    {
        Create = new AssetSet {
            Name = "My Hotel property asset set #" + ExampleUtilities.GetRandomString(),
            Type = AssetSetType.HotelProperty
        }
    };

    AssetSetServiceClient assetSetService = client.GetService(Services.V18.AssetSetService);

    MutateAssetSetsResponse response = assetSetService.MutateAssetSets(
        customerId.ToString(),
        new List<AssetSetOperation> { operation }
    );

    string assetResourceName = response.Results[0].ResourceName;
    Console.WriteLine($"Created an asset set with resource name: {assetResourceName}");
    return assetResourceName;
}AddPerformanceMaxForTravelGoalsCampaign.cs

PHP

private static function createHotelAssetSet(
    GoogleAdsClient $googleAdsClient,
    int $customerId
): string {
    // Creates an asset set operation for a hotel property asset set.
    $assetSetOperation = new AssetSetOperation([
        // Creates a hotel property asset set.
        'create' => new AssetSet([
            'name' => 'My Hotel propery asset set #' . Helper::getPrintableDatetime(),
            'type' => AssetSetType::HOTEL_PROPERTY
        ])
    ]);

    // Issues a mutate request to add a hotel asset set and prints its information.
    $assetSetServiceClient = $googleAdsClient->getAssetSetServiceClient();
    $response = $assetSetServiceClient->mutateAssetSets(
        MutateAssetSetsRequest::build($customerId, [$assetSetOperation])
    );
    $assetSetResourceName = $response->getResults()[0]->getResourceName();
    printf("Created an asset set with resource name: '%s'.%s", $assetSetResourceName, PHP_EOL);
    return $assetSetResourceName;
}AddPerformanceMaxForTravelGoalsCampaign.php

Python

def create_hotel_asset_set(client, customer_id):
    """Creates a hotel property asset set.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.

    Returns:
        the created hotel property asset set's resource name.
    """
    # Creates an asset set operation for a hotel property asset set.
    operation = client.get_type("AssetSetOperation")
    # Creates a hotel property asset set.
    asset_set = operation.create
    asset_set.name = f"My hotel property asset set #{get_printable_datetime()}"
    asset_set.type_ = client.enums.AssetSetTypeEnum.HOTEL_PROPERTY

    # Issues a mutate request to add a hotel asset set.
    asset_set_service = client.get_service("AssetSetService")
    response = asset_set_service.mutate_asset_sets(
        customer_id=customer_id, operations=[operation]
    )
    resource_name = response.results[0].resource_name
    print(f"Created an asset set with resource name: '{resource_name}'")

    return resource_nameadd_performance_max_for_travel_goals_campaign.py

Ruby

# Creates a hotel property asset set.
def create_hotel_asset_set(client, customer_id)
  operation =
    client.operation.create_resource.asset_set do |asset_set|
      asset_set.name = "My Hotel propery asset set #{Time.now}"
      asset_set.type = :HOTEL_PROPERTY
    end

  # Sends the mutate request.
  response =
    client.service.asset_set.mutate_asset_sets(
      customer_id: customer_id,
      operations: [operation]
    )

  # Prints some information about the response.
  response.results.first.resource_name
endadd_performance_max_for_travel_goals_campaign.rb

Perl

sub create_hotel_asset_set {
  my ($api_client, $customer_id) = @_;

  my $asset_set_operation =
    Google::Ads::GoogleAds::V18::Services::AssetSetService::AssetSetOperation->
    new({
      # Creates a hotel property asset set.
      create => Google::Ads::GoogleAds::V18::Resources::AssetSet->new({
          name => 'My Hotel propery asset set #' . uniqid(),
          type => HOTEL_PROPERTY
        })});
  # Issues a mutate request to add a hotel asset set and prints its information.
  my $response = $api_client->AssetSetService()->mutate({
      customerId => $customer_id,
      operations => [$asset_set_operation]});

  my $asset_set_resource_name = $response->{results}[0]{resourceName};
  printf "Created an asset set with resource name: '%s'.\n",
    $asset_set_resource_name;

  return $asset_set_resource_name;
}add_performance_max_for_travel_goals_campaign.pl

You can use TravelAssetSugestionService.SuggestTravelAssets to get suggested assets for your hotel properties. Once you get the suggestions, you can use them to create assets in the asset group in the next step.

Code example

Java

private HotelAssetSuggestion getHotelAssetSuggestion(
    GoogleAdsClient googleAdsClient, long customerId, String placeId) {

  try (TravelAssetSuggestionServiceClient travelAssetSuggestionServiceClient =
      googleAdsClient.getLatestVersion().createTravelAssetSuggestionServiceClient()) {
    // Sends a request to suggest assets to be created as an asset group for the Performance Max
    // for travel goals campaign.
    SuggestTravelAssetsResponse suggestTravelAssetsResponse =
        travelAssetSuggestionServiceClient.suggestTravelAssets(
            SuggestTravelAssetsRequest.newBuilder()
                .setCustomerId(Long.toString(customerId))
                // Uses 'en-US' as an example. It can be any language specifications in BCP 47
                // format.
                .setLanguageOption("en-US")
                // The service accepts several place IDs. We use only one here for demonstration.
                .addPlaceIds(placeId)
                .build());
    System.out.printf("Fetched a hotel asset suggestion for the place ID '%s'.%n", placeId);
    return suggestTravelAssetsResponse.getHotelAssetSuggestions(0);
  }
}AddPerformanceMaxForTravelGoalsCampaign.java

C#

private HotelAssetSuggestion GetHotelAssetSuggestion(GoogleAdsClient client,
    long customerId, string placeId)
{
    // Get the TravelAssetSuggestionService client.
    TravelAssetSuggestionServiceClient travelAssetSuggestionService =
        client.GetService(Services.V18.TravelAssetSuggestionService);

    SuggestTravelAssetsRequest request = new SuggestTravelAssetsRequest
    {
        CustomerId = customerId.ToString(),
        LanguageOption = "en-US",
    };

    request.PlaceIds.Add(placeId);

    SuggestTravelAssetsResponse response = travelAssetSuggestionService.SuggestTravelAssets(
        request
    );

    Console.WriteLine($"Fetched a hotel asset suggestion for the place ID {placeId}");
    return response.HotelAssetSuggestions[0];
}AddPerformanceMaxForTravelGoalsCampaign.cs

PHP

private static function getHotelAssetSuggestion(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    string $placeId
): HotelAssetSuggestion {
    // Send a request to suggest assets to be created as an asset group for the Performance Max
    // for travel goals campaign.
    $travelAssetSuggestionServiceClient =
        $googleAdsClient->getTravelAssetSuggestionServiceClient();
    // Uses 'en-US' as an example. It can be any language specifications in BCP 47 format.
    $request = SuggestTravelAssetsRequest::build($customerId, 'en-US');
    // The service accepts several place IDs. We use only one here for demonstration.
    $request->setPlaceIds([$placeId]);
    $response = $travelAssetSuggestionServiceClient->suggestTravelAssets($request);
    printf("Fetched a hotel asset suggestion for the place ID '%s'.%s", $placeId, PHP_EOL);
    return $response->getHotelAssetSuggestions()[0];
}AddPerformanceMaxForTravelGoalsCampaign.php

Python

def get_hotel_asset_suggestion(client, customer_id, place_id):
    """Returns hotel asset suggestion from TravelAssetsSuggestionService.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        place_id: a place ID identifying a place in the Google Places database.
    """
    request = client.get_type("SuggestTravelAssetsRequest")
    request.customer_id = customer_id
    # Uses 'en-US' as an example. It can be any language specifications in
    # BCP 47 format.
    request.language_option = "en-US"
    # In this example we only use a single place ID for the purpose of
    # demonstration, but it's possible to append more than one here if needed.
    request.place_ids.append(place_id)
    # Send a request to suggest assets to be created as an asset group for the
    # Performance Max for travel goals campaign.
    travel_asset_suggestion_service = client.get_service(
        "TravelAssetSuggestionService"
    )
    response = travel_asset_suggestion_service.suggest_travel_assets(
        request=request
    )
    print(f"Fetched a hotel asset suggestion for the place ID: '{place_id}'.")

    # Since we sent a single operation in the request, it's guaranteed that
    # there will only be a single item in the response.
    return response.hotel_asset_suggestions[0]add_performance_max_for_travel_goals_campaign.py

Ruby

def get_hotel_asset_suggestion(client, customer_id, place_id)
  response =
    client.service.travel_asset_suggestion.suggest_travel_assets(
      customer_id: customer_id,
      language_option: 'en-US',
      place_ids: [place_id]
    )

  response.hotel_asset_suggestions.first
endadd_performance_max_for_travel_goals_campaign.rb

Perl

sub get_hotel_asset_suggestion {
  my ($api_client, $customer_id, $place_id) = @_;

  # Send a request to suggest assets to be created as an asset group for the Performance Max
  # for travel goals campaign.
  my $suggest_travel_assets_response =
    $api_client->TravelAssetSuggestionService()->suggest_travel_assets({
      customerId => $customer_id,
      # Uses 'en-US' as an example. It can be any language specifications in BCP 47 format.
      languageOption => 'en-US',
      # The service accepts several place IDs. We use only one here for demonstration.
      placeIds => [$place_id],
    });

  printf "Fetched a hotel asset suggestion for the place ID '%s'.\n", $place_id;
  return $suggest_travel_assets_response->{hotelAssetSuggestions}[0];
}add_performance_max_for_travel_goals_campaign.pl

Campaign and campaign budget

Add a campaign budget

The budget must have a DAILY budget period (learn more).
The budget cannot be shared.

Code example

Java

/** Creates a MutateOperation that creates a new CampaignBudget. */
private MutateOperation createCampaignBudgetOperation(long customerId) {
  CampaignBudget campaignBudget =
      CampaignBudget.newBuilder()
          .setName("Performance Max campaign budget #" + getPrintableDateTime())
          // The budget period already defaults to DAILY.
          .setAmountMicros(50_000_000)
          .setDeliveryMethod(BudgetDeliveryMethod.STANDARD)
          // A Performance Max campaign cannot use a shared campaign budget.
          .setExplicitlyShared(false)
          // Set a temporary ID in the budget's resource name, so it can be referenced
          // by the campaign in later steps.
          .setResourceName(ResourceNames.campaignBudget(customerId, BUDGET_TEMPORARY_ID))
          .build();

  return MutateOperation.newBuilder()
      .setCampaignBudgetOperation(
          CampaignBudgetOperation.newBuilder().setCreate(campaignBudget).build())
      .build();
}
AddPerformanceMaxCampaign.java

C#

/// <summary>
/// Creates a MutateOperation that creates a new CampaignBudget.
///
/// A temporary ID will be assigned to this campaign budget so that it can be
/// referenced by other objects being created in the same Mutate request.
/// </summary>
/// <param name="budgetResourceName">The temporary resource name of the budget to
/// create.</param>
/// <returns>A MutateOperation that creates a CampaignBudget.</returns>
private MutateOperation CreateCampaignBudgetOperation(string budgetResourceName)
{
    MutateOperation operation = new MutateOperation
    {
        CampaignBudgetOperation = new CampaignBudgetOperation
        {
            Create = new CampaignBudget
            {
                Name = "Performance Max campaign budget #"
                  + ExampleUtilities.GetRandomString(),

                // The budget period already defaults to DAILY.
                AmountMicros = 50000000,
                DeliveryMethod = BudgetDeliveryMethod.Standard,

                // A Performance Max campaign cannot use a shared campaign budget.
                ExplicitlyShared = false,

                // Set a temporary ID in the budget's resource name so it can be referenced
                // by the campaign in later steps.
                ResourceName = budgetResourceName
            }
        }
    };

    return operation;
}
AddPerformanceMaxCampaign.cs

PHP

private static function createCampaignBudgetOperation(int $customerId): MutateOperation
{
    // Creates a mutate operation that creates a campaign budget operation.
    return new MutateOperation([
        'campaign_budget_operation' => new CampaignBudgetOperation([
            'create' => new CampaignBudget([
                // Sets a temporary ID in the budget's resource name so it can be referenced
                // by the campaign in later steps.
                'resource_name' => ResourceNames::forCampaignBudget(
                    $customerId,
                    self::BUDGET_TEMPORARY_ID
                ),
                'name' => 'Performance Max campaign budget #' . Helper::getPrintableDatetime(),
                // The budget period already defaults to DAILY.
                'amount_micros' => 50000000,
                'delivery_method' => BudgetDeliveryMethod::STANDARD,
                // A Performance Max campaign cannot use a shared campaign budget.
                'explicitly_shared' => false
            ])
        ])
    ]);
}AddPerformanceMaxCampaign.php

Python

def create_campaign_budget_operation(
    client,
    customer_id,
):
    """Creates a MutateOperation that creates a new CampaignBudget.

    A temporary ID will be assigned to this campaign budget so that it can be
    referenced by other objects being created in the same Mutate request.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.

    Returns:
        a MutateOperation that creates a CampaignBudget.
    """
    mutate_operation = client.get_type("MutateOperation")
    campaign_budget_operation = mutate_operation.campaign_budget_operation
    campaign_budget = campaign_budget_operation.create
    campaign_budget.name = f"Performance Max campaign budget #{uuid4()}"
    # The budget period already defaults to DAILY.
    campaign_budget.amount_micros = 50000000
    campaign_budget.delivery_method = (
        client.enums.BudgetDeliveryMethodEnum.STANDARD
    )
    # A Performance Max campaign cannot use a shared campaign budget.
    campaign_budget.explicitly_shared = False

    # Set a temporary ID in the budget's resource name so it can be referenced
    # by the campaign in later steps.
    campaign_budget.resource_name = client.get_service(
        "CampaignBudgetService"
    ).campaign_budget_path(customer_id, _BUDGET_TEMPORARY_ID)

    return mutate_operationadd_performance_max_campaign.py

Ruby

# Creates a MutateOperation that creates a new CampaignBudget.
#
# A temporary ID will be assigned to this campaign budget so that it can be
# referenced by other objects being created in the same Mutate request.
def create_campaign_budget_operation(client, customer_id)
  client.operation.mutate do |m|
    m.campaign_budget_operation = client.operation.create_resource.campaign_budget do |cb|
      cb.name = "Performance Max campaign budget #{SecureRandom.uuid}"
      # The budget period already defaults to DAILY.
      cb.amount_micros = 50_000_000
      cb.delivery_method = :STANDARD
        # A Performance Max campaign cannot use a shared campaign budget.
        cb.explicitly_shared = false

      # Set a temporary ID in the budget's resource name so it can be referenced
      # by the campaign in later steps.
      cb.resource_name = client.path.campaign_budget(customer_id, BUDGET_TEMPORARY_ID)
    end
  end
endadd_performance_max_campaign.rb

Perl

sub create_campaign_budget_operation {
  my ($customer_id) = @_;

  # Create a mutate operation that creates a campaign budget operation.
  return
    Google::Ads::GoogleAds::V18::Services::GoogleAdsService::MutateOperation->
    new({
      campaignBudgetOperation =>
        Google::Ads::GoogleAds::V18::Services::CampaignBudgetService::CampaignBudgetOperation
        ->new({
          create => Google::Ads::GoogleAds::V18::Resources::CampaignBudget->new(
            {
              # Set a temporary ID in the budget's resource name so it can be
              # referenced by the campaign in later steps.
              resourceName =>
                Google::Ads::GoogleAds::V18::Utils::ResourceNames::campaign_budget(
                $customer_id, BUDGET_TEMPORARY_ID
                ),
              name => "Performance Max campaign budget #" . uniqid(),
              # The budget period already defaults to DAILY.
              amountMicros   => 50000000,
              deliveryMethod => STANDARD,
              # A Performance Max campaign cannot use a shared campaign budget.
              explicitlyShared => "false",
            })})});
}add_performance_max_campaign.pl

Add a campaign and bidding strategy

Performance Max campaigns have an AdvertisingChannelType of PERFORMANCE_MAX. No AdvertisingChannelSubType should be set.

These are the only supported bidding strategies:

If you aren't tracking values and care about all of your conversions equally, use the MaximizeConversions bidding strategy. An optional target CPA (cost-per-action) can be set. Learn more.
If you're tracking values with your conversions, set the MaximizeConversionValue bidding strategy. An optional target ROAS (return on ad spend) can be set. Learn more.

Get started with Performance Max

Performance Max for travel goals

Performance Max concepts

Hotel asset sets and suggested assets

Code example

Java

C#

PHP

Python

Ruby

Perl

Code example

Java

C#

PHP

Python

Ruby

Perl

Campaign and campaign budget

Code example

Java

C#

PHP

Python

Ruby

Perl

/// /// /// { }

{ }

# # # # # # # # # # # # # # # # # # # # # # # # # # end

# # end

}

Code example

Java

C#

PHP

Python

Ruby

Perl

Code example

Java

C#

PHP

Python

Ruby

Perl

Assets and asset groups

Code example

Java

C#

PHP

Python

Ruby

Perl

Code example

Java

C#

PHP

Python

Ruby

Perl

Code example

Java

C#

PHP

Python

Ruby

Perl

Audience signal code example

Java

C#

PHP

Python

Ruby

Perl

Search theme signal code example

Java

C#

PHP

Python

Ruby

# # # # # # # # # # # # # # # # # # # # # # # #
# # end