rocket
Meet
Merchant API
- the official successor to the Content API for Shopping.
update
Merchant API'nin yeni özellikleri, hata düzeltmeleri ve sürüm güncellemeleri hakkında en son bilgileri edinin.
point_of_sale
İşletmenizi ve ürünlerinizi Google'da nasıl yöneteceğinizi ve veriler, analizler ve benzersiz özelliklere büyük ölçekte programatik erişim elde etmeyi öğrenin.
Merchant API'yi bugün kullanmaya başlayın.
Listeleme grubu ağacı oluştururken her alt bölüm tamamen ayrılmalıdır.
Ağaçta diğer (Google Ads kullanıcı arayüzünde Diğer her şey) için bir gruplandırma olmalıdır. Bu işlemi doğru şekilde yapmazsanız değiştirme işlemleri çalışmaz.
Alt düğüm oluşturmak için aşağıdaki adımları uygulayın:
Yeni bir giriş grubu oluşturun ve ListingGroupType değerini aşağıdakilerden biri olarak ayarlayın:
UNIT. Bu, ağacın yaprak düğümüdür. Teklif verilebilir olması gerekmez.
Akıllı Alışveriş kampanyalarında birim başına teklif veremezsiniz.
SUBDIVISION. Bu işlem, ağacı başka bir alt bölüme göre böler.
Düğüm için geçici bir kimlik ayarlamayı unutmayın.
Düğümün case_value değerini, alt bölümlere ayırmak istediğiniz ListingDimensionInfo olarak ayarlayın (Google Ads kullanıcı arayüzündeki ürün özelliği). Örneğin, product_brand.
Düğümün üst kimliğini, üst alt bölümün veya kök düğümün getId değeri olarak ayarlayın.
Bir listeleme grubu ağacı en fazla yedi düzey derinliğinde olabilir.
Mevcut ağaç düzeyindeki alt bölümün her UNIT için beşinci adımı tekrarlayın.
Her alt bölüm için boş bir case_value içeren bir yaprak düğüm ekleyin. Bu, diğer tüm değerleri temsil eder.
Geçerli düzeydeki her SUBDIVISION için:
Kimlik değerini not edin. Bu, bir sonraki seviyenin üst kimliğidir.
Ağacı bir seviye aşağıya doğru takip edin.
Beşinci adımdan yedinci adıma kadar olan adımları tekrarlayın.
Her UNIT için bir AdGroupCriterion oluşturun. Bu işlem, listeleme grubunu reklam grubuyla ilişkilendirir.
Daha düşük önceliğe sahip diğer reklam grupları ve kampanyalar, aynı ölçütlere uyan ürünler için teklif vermeye devam edebilir. Bir ürün grubunu tekliften hariç tutmak için negative uygulayın.
Listeleme grubu yapısıyla teklif vermeye başlamak için reklam grubunu etkinleştirin.
[null,null,["Son güncelleme tarihi: 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 create and manage listing groups, offering a more scalable solution for larger inventories.\u003c/p\u003e\n"],["\u003cp\u003eListing group trees, used in the API, can be structured with up to seven levels of subdivisions, ensuring precise targeting and bid management.\u003c/p\u003e\n"],["\u003cp\u003eAd group criteria are used to link listing groups to specific ad groups, enabling bidding on targeted product groups within your 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:"]]
