rocket
نقدّم لك
Merchant API
التي تحلّ رسميًا محلّ Content API في Shopping.
updateالاطّلاع على آخر الأخبار
بشأن الميزات الجديدة وإصلاحات الأخطاء وتحديثات الإصدارات من Merchant API
point_of_sale
تعرَّف على كيفية إدارة نشاطك التجاري ومنتجاتك على Google وكيفية الحصول على إذن وصول آلي إلى البيانات والإحصاءات والميزات الفريدة على نطاق واسع.
ابدأ استخدام Merchant API اليوم.
يجب تقسيم كل قسم فرعي بالكامل عند إنشاء شجرة لمجموعة بيانات.
يجب أن تتضمّن الشجرة مجموعة أخرى (كل ما عدا ذلك في واجهة مستخدم "إعلانات Google"). لن تعمل عمليات التعديل إذا لم يتم تنفيذ هذا الإجراء بشكل صحيح.
اتّبِع الخطوات التالية لإنشاء عقدة فرعية:
أنشئ مجموعة جديدة لبطاقات بيانات المتجر واضبط ListingGroupType على أحد الخيارات التالية:
UNIT، وهي عقدة طرفية في الشجرة. لا يجب أن يكون قابلاً للمزايدة.
لا يمكنك تقديم عروض أسعار لكل وحدة في "حملات التسوّق الذكية".
SUBDIVISION: يؤدي ذلك إلى تقسيم الشجرة حسب تقسيم فرعي آخر.
تذكَّر ضبط معرّف مؤقت للعقدة.
اضبط قيمة case_value للعقدة على ListingDimensionInfo التي تريد التقسيم الفرعي حسبها (سمة المنتج في واجهة مستخدم "إعلانات Google")، مثل product_brand.
اضبط رقم تعريف العنصر الرئيسي للعقدة على القيمة getId الخاصة بالتقسيم الفرعي الرئيسي أو عقدة الجذر.
يجب ألا يتجاوز عمق شجرة مجموعة المؤسسات سبعة مستويات.
كرِّر الخطوة الخامسة لكل UNIT من التقسيم الفرعي على مستوى الشجرة الحالي.
يجب تضمين عقدة فرعية تحتوي على case_value فارغ لكل تقسيم فرعي. يمثّل هذا الحقل جميع القيم الأخرى.
لكل SUBDIVISION على المستوى الحالي:
دوِّن قيمة المعرّف. هذا هو رقم تعريف العنصر الرئيسي للمستوى التالي.
اتّبِع الشجرة إلى مستوى أدنى.
كرِّر الخطوات من خمس إلى سبع.
أنشئ AdGroupCriterion لكل UNIT. يربط هذا الإجراء مجموعة بيانات الفنادق بالمجموعة الإعلانية.
قد تستمر المجموعات الإعلانية والحملات الأخرى ذات الأولوية الأقل في تقديم عروض أسعار على المنتجات التي تستوفي المعايير نفسها. طبِّق negative لاستبعاد مجموعة منتجات من عروض الأسعار.
فعِّل المجموعة الإعلانية لبدء تقديم عروض الأسعار باستخدام بنية مجموعة المؤسسات.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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:"]]
