rocket
Conheça
a
API Merchant
– a sucessora oficial da API Content for Shopping.
update
Confira as novidades
sobre novos recursos, correções de bugs e atualizações de lançamento da API Merchant.
point_of_sale
Saiba como gerenciar sua empresa e seus produtos no Google e como ter acesso programático a
dados, insights e recursos exclusivos em grande escala.
Comece a usar a API Merchant hoje mesmo!
Criar grupos de produtos
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Resumo
Com as campanhas do Shopping, você dá um lance em um grupo de produtos em vez de palavras-chave.
É possível criar grupos de produtos depois de criar um grupo de anúncios. Todos os itens de inventário em um grupo de produtos têm o mesmo lance.
Os grupos de anúncios em uma campanha do Shopping podem ter até 20 mil grupos de produtos.
Etapas manuais
Confira as etapas para criar grupos de produtos na interface do Google Ads.
- Crie uma campanha do Shopping para Todos os produtos.
- Criar um novo grupo de anúncios.
Clique em + ao lado de Todos os produtos para adicionar uma subdivisão.
Os grupos de produtos podem ser subdivididos até seis vezes.
Siga estas etapas para adicionar manualmente valores de subdivisão como uma lista:
- Selecione Adicionar valores em massa manualmente.
- Adicione cada subdivisão (um item por linha).
- Confirme as mudanças.
Esse recurso está disponível apenas para alguns atributos.
Defina um lance de CPC máximo para cada grupo de produtos. Se você usa uma estratégia de lances automáticos, o CPC máx. pode ser definido para você.
Para mais detalhes, consulte Gerenciar uma campanha do Shopping com grupos de produtos.
Etapas automáticas
Verifique se você já fez o seguinte:
- Vincule o Merchant Center ao Google Ads.
- Crie uma campanha do Shopping.
Crie um grupo de anúncios.
Confira as etapas para criar um grupo de fichas usando a API Google Ads:
Siga estas etapas para criar um nó raiz para a árvore do grupo de produtos:
- Crie um grupo de fichas.
Defina o ID da raiz como um valor temporário, por exemplo, -1.
Cada subdivisão precisa ser completamente particionada ao criar uma árvore de grupo de fichas.
A árvore precisa ter um agrupamento para outros (Todo o resto na interface do Google Ads). As operações de mutação não vão funcionar se você não fizer isso corretamente.
Siga estas etapas para criar um nó filho:
- Crie um grupo de produtos e defina o
ListingGroupType como um dos seguintes valores:
UNIT. Este é um nó folha da árvore. Não precisa ser de lances.
Não é possível dar lances por unidade em campanhas inteligentes do Shopping.SUBDIVISION. Isso divide a árvore por outra subdivisão.
Não se esqueça de definir um ID temporário para o nó.
Defina o case_value do nó como o ListingDimensionInfo que você quer usar para subdividir (atributo do produto na interface do Google Ads), por exemplo, product_brand.
Para particionar um grupo de produtos por ProductBiddingCategory, defina o valor como um ID numérico, não a string de categoria. Você pode encontrar o ID em
ProductBiddingCategoryConstant.
Defina o ID principal do nó como o valor getId da
subdivisão principal ou do nó raiz.
Uma árvore de grupo de fichas não pode ter mais de sete níveis.
Repita a etapa cinco para cada UNIT da subdivisão no nível atual da árvore.
Inclua um nó folha com um case_value vazio para cada subdivisão. Isso representa todos os outros valores.
Para cada SUBDIVISION no nível atual:
- Anote o valor do ID. Esse é o ID principal para o próximo nível.
- Siga a árvore um nível abaixo.
- Repita as etapas de cinco a sete.
Crie um AdGroupCriterion para cada UNIT. Isso associa o grupo de
produtos ao grupo de anúncios.
Outros grupos de anúncios e campanhas com prioridade mais baixa ainda podem fazer lances em produtos que atendem aos mesmos critérios. Aplique negative para excluir um grupo de produtos dos lances.
Ative o grupo de anúncios para começar a dar lances com a estrutura do grupo de fichas de empresa.
Consulte Criar um grupo de fichas e o exemplo em Python para mais detalhes.
Confira um exemplo de árvore de grupo de fichas de empresa:
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eShopping campaigns utilize product groups for bidding instead of keywords, allowing you to group similar products and set bids accordingly.\u003c/p\u003e\n"],["\u003cp\u003eYou can manually create and subdivide product groups within the Google Ads UI for granular control over your Shopping campaign structure.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Ads API provides a method to automatically generate and manage product groups through Listing Groups, enabling efficient large-scale campaign management.\u003c/p\u003e\n"],["\u003cp\u003eWhen creating product groups through the API, ensure a complete and partitioned tree structure, including an "other" category, for successful implementation.\u003c/p\u003e\n"],["\u003cp\u003eListing Groups can be structured with up to seven levels of subdivisions, allowing for fine-grained categorization and bidding strategies within your Shopping campaigns.\u003c/p\u003e\n"]]],[],null,["# Create product groups\n\nSummary\n-------\n\nWith Shopping campaigns, you bid on a [product group](https://support.google.com/google-ads/answer/6275317) instead of keywords.\n\nYou can create product groups after you create an ad group. All inventory items\nin a product group have the same bid.\n\nAd groups within a Shopping campaign can have up to 20,000 product groups.\n| **Key Term:** In the Google Ads API, a product group is referred to as a [Listing\n| Group](/google-ads/api/docs/shopping-ads/create-listing-groups).\n\nManual steps\n------------\n\nHere are the steps to create product groups through the Google Ads UI.\n\n1. [Create a new Shopping campaign](https://support.google.com/google-ads/answer/3455481) for **All Products**.\n2. Create a new ad group.\n3. Click **+** next to **All products** to add a subdivision.\n\n Products groups can be subdivided up to 6 times.\n4. Use the following steps to manually add subdivision values as a list:\n\n 1. Select **Bulk add values manually**.\n 2. Add each subdivision (one item per line).\n 3. Confirm the changes.\n\n This is only available for some attributes.\n5. Set a max CPC bid for each product group. If you use an automated bidding\n strategy, max CPC can be set for you.\n\nFor more detail, see [Manage a Shopping campaign with product groups](https://support.google.com/google-ads/answer/6275317).\n\nAutomatic steps\n---------------\n\nMake sure you have already completed the following:\n\n1. [Link Merchant Center to Google Ads](/google-ads/shopping/full-automation/articles/t15).\n2. Create a new [Shopping campaign](/google-ads/shopping/full-automation/articles/t18).\n3. Create a new [ad group](/google-ads/shopping/full-automation/articles/t19).\n Here are the steps to create a [Listing Group](/google-ads/api/docs/shopping-ads/create-listing-groups) through the Google Ads API:\n\n4. Use the following steps to create a root node for the [listing group](/google-ads/api/docs/shopping-ads/create-listing-groups) tree:\n\n 1. [Create a new listing group](/google-ads/api/docs/shopping-ads/create-listing-groups#listing_dimensions).\n 2. Set the ID of the root to a [temporary value](/google-ads/api/docs/shopping-ads/create-listing-groups#temporary_ids), for example `-1`.\n\n Each subdivision must be completely partitioned when you create\n a listing group tree.\n\n The tree must have a grouping for **other** (**Everything else** in the\n Google Ads UI). Mutate operations won't work if you don't do this\n correctly.\n5. Use the following steps to create a child node:\n\n 1. Create a new listing group and set the `ListingGroupType` to one of the following:\n - `UNIT`. This is a leaf node of the tree. Doesn't need to be biddable. You can't bid per unit in Smart Shopping campaigns.\n - `SUBDIVISION`. This splits the tree by another subdivision. Remember to set a temporary ID for the node.\n 2. Set the `case_value` of the node to the [`ListingDimensionInfo`](/google-ads/api/reference/rpc/latest/ListingDimensionInfo) you\n want to subdivide by (**product attribute** in the Google Ads\n UI), for example `product_brand`.\n\n To partition a product group by [`ProductBiddingCategory`](/google-ads/api/reference/rpc/latest/ProductBiddingCategoryInfo), set the\n value to a numeric ID, not the category string. You can find the ID in\n [`ProductBiddingCategoryConstant`](/google-ads/api/reference/rpc/latest/ProductBiddingCategoryConstant#id).\n 3. Set the parent ID for the node to the `getId` value of the\n parent subdivision or root node.\n\n A listing group tree can be no more than seven levels deep.\n6. Repeat step five for every `UNIT` of the subdivision at the current\n tree level.\n\n Include a leaf node with an empty `case_value` for each subdivision. This\n represents all other values.\n7. For each `SUBDIVISION` at the current level:\n\n 1. Take note of the ID value. This is the parent ID for the next level.\n 2. Follow the tree down a level.\n 3. Repeat steps five to seven.\n8. Create an [`AdGroupCriterion`](/google-ads/api/reference/rpc/latest/AdGroupCriterion) for every `UNIT`. This associates the listing\n group with the ad group.\n\n Other ad groups and campaigns with lower priority may still bid on\n products that fit the same criteria. Apply [`negative`](/google-ads/api/reference/rpc/latest/AdGroupCriterion#negative) to exclude a\n product group from bidding.\n9. Enable the ad group to start bidding with the listing group structure.\n\nSee [Create a new listing group](/google-ads/api/docs/shopping-ads/create-listing-groups#listing_dimensions) and the [python example](https://github.com/googleads/google-ads-python/blob/master/examples/shopping_ads/add_shopping_product_listing_group_tree.py)\nfor more detail.\n\nHere's an example of a listing group tree:"]]
