Create a Local Campaign

Campaign budget

A Local campaign cannot use a shared campaign budget. Make sure the campaign budget you specify has explicitly_shared set to false.

Java

private String createCampaignBudget(GoogleAdsClient googleAdsClient, long customerId) {
  // Creates a CampaignBudget object.
  CampaignBudget budget =
      CampaignBudget.newBuilder()
          .setAmountMicros(50000000)
          .setName("Interplanetary Cruise Budget #" + getPrintableDateTime())
          .setDeliveryMethod(BudgetDeliveryMethod.STANDARD)
          // A Local campaign cannot use a shared campaign budget.
          .setExplicitlyShared(false)
          .build();

  // Creates an operation to add the campaign.
  CampaignBudgetOperation operation =
      CampaignBudgetOperation.newBuilder().setCreate(budget).build();

  // Connects to the API.
  try (CampaignBudgetServiceClient campaignBudgetServiceClient =
      googleAdsClient.getLatestVersion().createCampaignBudgetServiceClient()) {
    // Issues the mutate request.
    MutateCampaignBudgetsResponse response =
        campaignBudgetServiceClient.mutateCampaignBudgets(
            String.valueOf(customerId), ImmutableList.of(operation));

    // Prints some debugging information.
    String resourceName = response.getResults(0).getResourceName();
    System.out.printf("Created campaign budget with resource name: '%s'.%n", resourceName);
    return resourceName;
  }
}
AddLocalCampaign.java
      

C#

private string CreateCampaignBudget(GoogleAdsClient client, in long customerId)
{
    // Get the CampaignBudgetService client.
    CampaignBudgetServiceClient campaignBudgetServiceClient =
        client.GetService(Services.V6.CampaignBudgetService);

    // Create a campaign budget object.
    CampaignBudget campaignBudget = new CampaignBudget
    {
        Name = $"Interplanetary Cruise Budget #{ExampleUtilities.GetRandomString()}",
        AmountMicros = 50000000,
        DeliveryMethod = BudgetDeliveryMethod.Standard,
        // A Local campaign cannot use a shared campaign budget.
        ExplicitlyShared = false
    };

    // Create a campaign budget operation.
    CampaignBudgetOperation campaignBudgetOperation = new CampaignBudgetOperation
    {
        Create = campaignBudget
    };

    // Issue a mutate request to add the campaign budget, then print and return the
    // resulting budget's resource name.
    MutateCampaignBudgetsResponse campaignBudgetsResponse =
        campaignBudgetServiceClient.MutateCampaignBudgets(customerId.ToString(),
            new[] {campaignBudgetOperation});

    string campaignBudgetResourceName =
        campaignBudgetsResponse.Results.First().ResourceName;
    Console.WriteLine(
        $"Created campaign budget with resource name '{campaignBudgetResourceName}'.");

    return campaignBudgetResourceName;
}
AddLocalCampaign.cs
      

PHP

private static function createCampaignBudget(
    GoogleAdsClient $googleAdsClient,
    int $customerId
) {
    $campaignBudget = new CampaignBudget([
        'name' => 'Interplanetary Cruise Budget #' . Helper::getPrintableDatetime(),
        'delivery_method' => BudgetDeliveryMethod::STANDARD,
        'amount_micros' => 50000000,
        // A Local campaign cannot use a shared campaign budget.
        'explicitly_shared' => false
    ]);

    // Creates a campaign budget operation.
    $campaignBudgetOperation = new CampaignBudgetOperation();
    $campaignBudgetOperation->setCreate($campaignBudget);

    // Issues a mutate request to add campaign budget.
    $campaignBudgetServiceClient = $googleAdsClient->getCampaignBudgetServiceClient();
    /** @var MutateCampaignBudgetsResponse $campaignBudgetResponse */
    $campaignBudgetResponse = $campaignBudgetServiceClient->mutateCampaignBudgets(
        $customerId,
        [$campaignBudgetOperation]
    );

    $campaignBudgetResourceName = $campaignBudgetResponse->getResults()[0]->getResourceName();
    printf(
        "Created campaign budget with resource name: '%s'.%s",
        $campaignBudgetResourceName,
        PHP_EOL
    );

    return $campaignBudgetResourceName;
}
AddLocalCampaign.php
      

Python

This example is not yet available in Python; you can take a look at the other languages.
    

Ruby

This example is not yet available in Ruby; you can take a look at the other languages.
    

Perl

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

  # Create a campaign budget.
  my $campaign_budget =
    Google::Ads::GoogleAds::V6::Resources::CampaignBudget->new({
      name           => "Interplanetary Cruise Budget #" . uniqid(),
      amountMicros   => 50000000,
      deliveryMethod => STANDARD,
      # A Local campaign cannot use a shared campaign budget.
      explicitlyShared => "false"
    });

  # Create a campaign budget operation.
  my $campaign_budget_operation =
    Google::Ads::GoogleAds::V6::Services::CampaignBudgetService::CampaignBudgetOperation
    ->new({
      create => $campaign_budget
    });

  # Issue a mutate request to add the campaign budget.
  my $campaign_budgets_response = $api_client->CampaignBudgetService()->mutate({
      customerId => $customer_id,
      operations => [$campaign_budget_operation]});

  my $campaign_budget_resource_name =
    $campaign_budgets_response->{results}[0]{resourceName};
  printf "Created campaign budget with resource name: '%s'.\n",
    $campaign_budget_resource_name;

  return $campaign_budget_resource_name;
}
add_local_campaign.pl
      

Local campaign

To create a Local campaign, follow the steps in our code example with these specifics:

1. Set the advertising_channel_type to LOCAL.

2. Set the advertising_channel_sub_type to LOCAL_CAMPAIGN.

3. Set the campaign_budget to the resource name of the newly created campaign budget as above.

4. Set the maximize_conversion_value to a newly created MaximizeConversionValue object. A ROAS target can be optionally set on the target_roas field on MaximizeConversionValue.

   Note: Maximize conversion value is the only allowed bidding strategy for this campaign type. Portfolio bid strategies created using the BiddingStrategyService are not supported by Local campaigns.

5. Set the local_campaign_setting to an LocalCampaignSetting object with:

   • location_source_type set to either GOOGLE_MY_BUSINESS to use the locations in your linked Google My Business account, or AFFILIATE to use the affiliate location extensions in your Google Ads account.

6. optimization_goal_setting is required for Local campaigns. Select DRIVING_DIRECTIONS and/or CALL_CLICKS to optimize the actions in your campaign.

Java

private String createLocalCampaign(
    GoogleAdsClient googleAdsClient, long customerId, String budgetResourceName) {
  // Creates a Campaign object.
  Campaign campaign =
      Campaign.newBuilder()
          .setName("Interplanetary Cruise Budget #" + getPrintableDateTime())
          .setCampaignBudget(budgetResourceName)
          // Recommendation: Set the campaign to PAUSED when creating it to prevent the ads from
          // immediately serving. Set to ENABLED once you've added targeting and the ads are ready
          // to serve.
          .setStatus(CampaignStatus.PAUSED)
          // Sets the advertisingChannelType to LOCAL and advertisingChannelSubType to
          // LOCAL_CAMPAIGN.
          .setAdvertisingChannelType(AdvertisingChannelType.LOCAL)
          .setAdvertisingChannelSubType(AdvertisingChannelSubType.LOCAL_CAMPAIGN)
          // Sets the bidding strategy. Note that this must be set directly on the campaign.
          //   - Setting a portfolio bidding strategy by resource name is not supported.
          //   - Maximize conversion value is the only strategy supported for Local
          //     campaigns.
          //   - An optional ROAS (Return on Advertising Spend) can be set for
          //     MaximizeConversionValue.
          //   - Specify the ROAS value must as a ratio. It is calculated by
          //     dividing "total value" by "total spend". For example, to target 350% ROAS, set
          //     targetRoas=3.5.
          //   - For more information on maximize conversion value, see the support article:
          //     http://support.google.com/google-ads/answer/7684216.
          .setMaximizeConversionValue(
              MaximizeConversionValue.newBuilder().setTargetRoas(3.5).build())
          // Configures the Local campaign setting.
          .setLocalCampaignSetting(
              LocalCampaignSetting.newBuilder()
                  // Use the locations associated with the customer's linked Google My Business
                  // account.
                  .setLocationSourceType(LocationSourceType.GOOGLE_MY_BUSINESS))
          .setOptimizationGoalSetting(
              OptimizationGoalSetting.newBuilder()
                  // Optimization goal setting is mandatory for Local campaigns. This example
                  // selects driving directions and call clicks as goals.
                  .addOptimizationGoalTypes(OptimizationGoalType.CALL_CLICKS)
                  .addOptimizationGoalTypes(OptimizationGoalType.DRIVING_DIRECTIONS)
                  .build())
          .build();

  // Creates a operation to add the campaign.
  CampaignOperation operation = CampaignOperation.newBuilder().setCreate(campaign).build();

  // Connects to the API.
  try (CampaignServiceClient client =
      googleAdsClient.getLatestVersion().createCampaignServiceClient()) {
    // Sends the mutate request.
    MutateCampaignsResponse response =
        client.mutateCampaigns(String.valueOf(customerId), ImmutableList.of(operation));

    // Prints some debugging information.
    String resourceName = response.getResults(0).getResourceName();
    System.out.printf("Created Local campaign with resource name: '%s'.%n", resourceName);
    return resourceName;
  }
}
AddLocalCampaign.java
      

C#

private string CreateCampaign(GoogleAdsClient client, long customerId,
    string budgetResourceName)
{
    // Get the CampaignService client.
    CampaignServiceClient campaignServiceClient =
        client.GetService(Services.V6.CampaignService);

    // Create a campaign object.
    Campaign campaign = new Campaign
    {
        Name = $"Interplanetary Cruise Local #{ExampleUtilities.GetRandomString()}",
        CampaignBudget = budgetResourceName,
        // Recommendation: Set the campaign to PAUSED when creating it to prevent the ads
        // from immediately serving. Set to ENABLED once you've added targeting and the ads
        // are ready to serve.
        Status = CampaignStatus.Paused,
        // All Local campaigns have an advertisingChannelType of LOCAL and
        // advertisingChannelSubtype of LOCAL_CAMPAIGN.
        AdvertisingChannelType = AdvertisingChannelType.Local,
        AdvertisingChannelSubType = AdvertisingChannelSubType.LocalCampaign,
        // Bidding strategy must be set directly on the campaign.Setting a portfolio bidding
        // strategy by resource name is not supported. Maximize conversion value is the only
        // strategy supported for Local campaigns. An optional ROAS (Return on Advertising
        // Spend) can be set for MaximizeConversionValue. The ROAS value must be specified
        // as a ratio in the API. It is calculated by dividing "total value" by
        // "total spend". For more information on maximize conversion value, see the support
        // article: http://support.google.com/google-ads/answer/7684216.
        MaximizeConversionValue = new MaximizeConversionValue
        {
            TargetRoas = 3.5
        },
        // Configure the Local campaign setting.
        LocalCampaignSetting = new Campaign.Types.LocalCampaignSetting
        {
            LocationSourceType = LocationSourceType.GoogleMyBusiness
        },
        // Optimization goal setting is mandatory for Local campaigns. This example selects
        // driving directions and call clicks as goals.
        OptimizationGoalSetting = new Campaign.Types.OptimizationGoalSetting
        {
            OptimizationGoalTypes =
            {
                OptimizationGoalType.CallClicks, OptimizationGoalType.DrivingDirections
            }
        }
    };

    // Create a campaign operation.
    CampaignOperation campaignOperation = new CampaignOperation
    {
        Create = campaign
    };

    // Issue a mutate request to add the campaign, then print and return the resulting
    // campaign's resource name.
    MutateCampaignsResponse campaignResponse =
        campaignServiceClient.MutateCampaigns(customerId.ToString(),
            new[] {campaignOperation});

    string campaignResourceName = campaignResponse.Results.First().ResourceName;
    Console.WriteLine("Created Local campaign with resource name " +
        $"'{campaignResourceName}'.");

    return campaignResourceName;
}
AddLocalCampaign.cs
      

PHP

private static function createCampaign(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    string $campaignBudgetResourceName
) {
    $campaign = new Campaign([
        'name' => 'Interplanetary Cruise Local #' . Helper::getPrintableDatetime(),
        'campaign_budget' => $campaignBudgetResourceName,
        // Recommendation: Set the campaign to PAUSED when creating it to prevent the ads
        // from immediately serving. Set to ENABLED once you've added targeting and the ads
        // are ready to serve.
        'status' => CampaignStatus::PAUSED,
        // All Local campaigns have an advertisingChannelType of LOCAL and
        // advertisingChannelSubType of LOCAL_CAMPAIGN.
        'advertising_channel_type' => AdvertisingChannelType::LOCAL,
        'advertising_channel_sub_type' => AdvertisingChannelSubType::LOCAL_CAMPAIGN,
        // Bidding strategy must be set directly on the campaign.
        // Setting a portfolio bidding strategy by resource name is not supported.
        // Maximize conversion value is the only strategy supported for Local campaigns. An
        // optional ROAS (Return on Advertising Spend) can be set for
        // MaximizeConversionValue. The ROAS value must be specified as a ratio in the API. It
        // is calculated by dividing "total value" by "total spend".
        // For more information on maximize conversion value, see the support article:
        // http://support.google.com/google-ads/answer/7684216.
        'maximize_conversion_value' => new MaximizeConversionValue(['target_roas' => 3.5]),
        // Configures the Local campaign setting.
        'local_campaign_setting' => new LocalCampaignSetting([
            // Use the locations associated with the customer's linked Google My Business
            // account.
            'location_source_type' => LocationSourceType::GOOGLE_MY_BUSINESS
        ]),
        // Optimization goal setting is mandatory for Local campaigns. This example selects
        // driving directions and call clicks as goals.
        'optimization_goal_setting' => new OptimizationGoalSetting([
            'optimization_goal_types' => [
                OptimizationGoalType::CALL_CLICKS,
                OptimizationGoalType::DRIVING_DIRECTIONS
            ]
        ])
    ]);

    // Creates a campaign operation.
    $campaignOperation = new CampaignOperation();
    $campaignOperation->setCreate($campaign);

    // Issues a mutate request to add campaign.
    $campaignServiceClient = $googleAdsClient->getCampaignServiceClient();
    /** @var MutateCampaignsResponse $campaignResponse */
    $campaignResponse = $campaignServiceClient->mutateCampaigns(
        $customerId,
        [$campaignOperation]
    );

    $campaignResourceName = $campaignResponse->getResults()[0]->getResourceName();
    printf(
        "Created Local campaign with resource name: '%s'.%s",
        $campaignResourceName,
        PHP_EOL
    );

    return $campaignResourceName;
}
AddLocalCampaign.php
      

Python

This example is not yet available in Python; you can take a look at the other languages.
    

Ruby

This example is not yet available in Ruby; you can take a look at the other languages.
    

Perl

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

  # Create a campaign.
  my $campaign = Google::Ads::GoogleAds::V6::Resources::Campaign->new({
      name           => "Interplanetary Cruise Local #" . uniqid(),
      campaignBudget => $budget_resource_name,
      # Recommendation: Set the campaign to PAUSED when creating it to prevent
      # the ads from immediately serving. Set to ENABLED once you've added
      # targeting and the ads are ready to serve.
      status => PAUSED,
      # All Local campaigns have an advertisingChannelType of LOCAL and
      # advertisingChannelSubType of LOCAL_CAMPAIGN.
      advertisingChannelType    => LOCAL,
      advertisingChannelSubType => LOCAL_CAMPAIGN,
      # Bidding strategy must be set directly on the campaign.
      # Setting a portfolio bidding strategy by resource name is not supported.
      # Maximize conversion value is the only strategy supported for Local
      # campaigns. An optional ROAS (Return on Advertising Spend) can be set for
      # MaximizeConversionValue. The ROAS value must be specified as a ratio in the
      # API. It is calculated by dividing "total value" by "total spend".
      # For more information on maximize conversion value, see the support article:
      # http://support.google.com/google-ads/answer/7684216.
      maximizeConversionValue =>
        Google::Ads::GoogleAds::V6::Common::MaximizeConversionValue->new(
        {targetRoas => 3.5}
        ),
      # Configure the Local campaign setting.
      localCampaignSetting =>
        Google::Ads::GoogleAds::V6::Resources::LocalCampaignSetting->new({
          # Use the locations associated with the customer's linked Google
          # My Business account.
          locationSourceType => GOOGLE_MY_BUSINESS
        }
        ),
      # Optimization goal setting is mandatory for Local campaigns. This example
      # selects driving directions and call clicks as goals.
      optimizationGoalSetting =>
        Google::Ads::GoogleAds::V6::Resources::OptimizationGoalSetting->new({
          optimizationGoalTypes => [CALL_CLICKS, DRIVING_DIRECTIONS]})});

  # Create a campaign operation.
  my $campaign_operation =
    Google::Ads::GoogleAds::V6::Services::CampaignService::CampaignOperation->
    new({
      create => $campaign
    });

  # Issue a mutate request to add the campaign.
  my $campaigns_response = $api_client->CampaignService()->mutate({
      customerId => $customer_id,
      operations => [$campaign_operation]});

  my $campaign_resource_name =
    $campaigns_response->{results}[0]{resourceName};
  printf "Created Local campaign with resource name: '%s'.\n",
    $campaign_resource_name;

  return $campaign_resource_name;
}
add_local_campaign.pl