创建购物广告组

要为购物广告系列投放广告，您必须创建 AdGroup。

标准购物广告系列支持 SHOPPING_PRODUCT_ADS 广告组类型。这是购物广告系列的默认广告组类型，用于投放标准产品广告。您可以通过提供广告组 type 字段对其进行设置。

标准购物广告系列可以包含多个广告组，每个广告组至少包含一个广告。

此代码示例演示了如何为标准购物广告系列创建广告组。该示例还设置了每次点击费用出价，以匹配广告系列的出价策略（在本例中的设置是 ManualCpc）。

Java

private String addShoppingProductAdGroup(
    GoogleAdsClient googleAdsClient, long customerId, String campaignResourceName) {
  // Creates an ad group.
  AdGroup adGroup =
      AdGroup.newBuilder()
          .setName("Earth to Mars Cruises #" + getPrintableDateTime())
          .setCampaign(campaignResourceName)
          // Sets the ad group type to SHOPPING_PRODUCT_ADS. This is the only value possible for
          // ad groups that contain shopping product ads.
          .setType(AdGroupType.SHOPPING_PRODUCT_ADS)
          .setCpcBidMicros(1_000_000L)
          .setStatus(AdGroupStatus.ENABLED)
          .build();

  // Creates an ad group operation.
  AdGroupOperation operation = AdGroupOperation.newBuilder().setCreate(adGroup).build();

  // Issues a mutate request to add an ad group.
  try (AdGroupServiceClient adGroupServiceClient =
      googleAdsClient.getLatestVersion().createAdGroupServiceClient()) {
    MutateAdGroupResult mutateAdGroupResult =
        adGroupServiceClient
            .mutateAdGroups(Long.toString(customerId), Collections.singletonList(operation))
            .getResults(0);
    System.out.printf(
        "Added a product shopping ad group with resource name: '%s'%n",
        mutateAdGroupResult.getResourceName());
    return mutateAdGroupResult.getResourceName();
  }
}

C#

private string AddProductShoppingAdGroup(GoogleAdsClient client, long customerId,
            string campaignResourceName)
{
    // Get the AdGroupService.
    AdGroupServiceClient adGroupService = client.GetService(Services.V25.AdGroupService);

    // Creates an ad group.
    AdGroup adGroup = new AdGroup()
    {
        Name = "Earth to Mars Cruises #" + ExampleUtilities.GetRandomString(),
        Campaign = campaignResourceName,
        // Sets the ad group type to SHOPPING_PRODUCT_ADS. This is the only value possible
        // for ad groups that contain shopping product ads.
        Type = AdGroupType.ShoppingProductAds,
        CpcBidMicros = 1_000_000L,
        Status = AdGroupStatus.Enabled
    };

    // Creates an ad group operation.
    AdGroupOperation operation = new AdGroupOperation()
    {
        Create = adGroup
    };

    // Issues a mutate request to add an ad group.
    MutateAdGroupResult mutateAdGroupResult =
        adGroupService
            .MutateAdGroups(customerId.ToString(), new AdGroupOperation[] { operation })
            .Results[0];
    Console.WriteLine("Added a product shopping ad group with resource name: '{0}'.",
        mutateAdGroupResult.ResourceName);
    return mutateAdGroupResult.ResourceName;
}

PHP

private static function addShoppingProductAdGroup(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    string $campaignResourceName
) {
    // Creates an ad group.
    $adGroup = new AdGroup([
        'name' => 'Earth to Mars Cruise #' . Helper::getPrintableDatetime(),
        // Sets the campaign.
        'campaign' => $campaignResourceName,
        // Sets the ad group type to SHOPPING_PRODUCT_ADS. This is the only value possible for
        // ad groups that contain shopping product ads.
        'type' => AdGroupType::SHOPPING_PRODUCT_ADS,
        'cpc_bid_micros' => 10000000,
        'status' => AdGroupStatus::ENABLED
    ]);

    // Creates an ad group operation.
    $adGroupOperation = new AdGroupOperation();
    $adGroupOperation->setCreate($adGroup);

    // Issues a mutate request to add an ad group.
    $adGroupServiceClient = $googleAdsClient->getAdGroupServiceClient();
    $response = $adGroupServiceClient->mutateAdGroups(
        MutateAdGroupsRequest::build($customerId, [$adGroupOperation])
    );

    /** @var AdGroup $addedAdGroup */
    $addedAdGroup = $response->getResults()[0];
    printf(
        "Added a shopping product ad group with resource name '%s'.%s",
        $addedAdGroup->getResourceName(),
        PHP_EOL
    );

    return $addedAdGroup->getResourceName();
}