How to change listing group type of UNIT nodes

75 views

Skip to first unread message

Tiansi Liu

unread,

Oct 19, 2022, 3:24:11 AM10/19/22

to Google Ads API and AdWords API Forum

Hi Team,

We are preparing to release some new features to implement Standard Shopping Campaign Tool RMF. I would like to learn more about RMF M.160 Subdivide (add product partition). I emailed the AdWords API Compliance Team before and they directed me to ask questions here.

Question1. Is this a feature that needs to be operated by merchants on our platform, or does the system help them split by default?

Question2. If it’s a feature for merchants, is there a minimum requirement for levels in the tree? How to create levels more than two?

According to https://developers.google.com/google-ads/api/docs/shopping-ads/create-listing-groups,

I set the ListingGroupType of the Root node to be SUBDIVISION, then at the second level, the products are divided by category as “category1”,”category2” and others. These nodes UNIT because they should have a bid.

Then when I need to create the third level by brands/ conditions/ Item ID, I need to change the node’s ListingGroupType from UNIT to SUBDIVISION to continue with the subdivision. But I did not find an API to update ListingGroupType. In this condition, we can only create 2 levels.

Do you have any suggestion on this? Looking forward to your reply.

Thank you!

Google Ads API Forum Advisor

unread,

Oct 19, 2022, 9:18:55 AM10/19/22

to tians...@gmail.com, adwor...@googlegroups.com

Hi Tiansi,

Thanks for reaching out to the Google Ads API Support.

Kindly see below responses to your queries:

1.Is this a feature that needs to be operated by merchants on our platform, or does the system help them split by default?

>> You may note that shopping listing groups let you partition your products into groups (referred to as product groups in the UI), and constructing of listing group should be operated by the user as it is not split automatically or by default. With this, the application that you will build should support customizing of listing groups and aligned with our guide (https://developers.google.com/google-ads/api/docs/shopping-ads/create-listing-groups).

2. If it’s a feature for merchants, is there a minimum requirement for levels in the tree? How to create levels more than two?

>> You may refer to this blog post, and this page on the Required Minimum Functionality (RMF). You may note that each subdivision must always be completely partitioned, so it must contain a node representing Other. Nodes are objects of the ListingGroupInfo class, which contains the ListingGroupType field that indicates if the nodes are unit or subdivision. Setting ListingGroupInfo to listing_group of AdGroupCriterion will link it to the AdGroup. Also, take note that to have at least one unit node to make a tree valid, and shopping Ads will not serve until you create a valid listing group tree.

Also, I agree that it needs to change the node’s ListingGroupType from UNIT to SUBDIVISION in order to continue with the subdivision and to create the third level by brands/ conditions/ Item ID. As per this product support guide, you can subdivide up to 7 levels for each product group in any order you want. You can have a product group for all your products and bid the same amount for all of them. In the opposite way, you can also have smaller product groups organized by brand or product category. Keep in mind that you can't set a bid on a product group that has been subdivided--you'll set bids on the product groups without subdivisions. For the sample available code, you may refer to this page, and follow the examples provided under the Shopping Ads.

Regards,

Yasar
Google Ads API Team