با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
برخلاف سایر دارایی‌ها، پس از ایجاد مجموعه دارایی، دارایی‌های مکان به‌طور خودکار توسط Google Ads API ایجاد می‌شوند. ابتدا یک مجموعه دارایی همگام‌سازی مکان ایجاد کنید و آن را به مشتری متصل کنید. سپس، اگر می‌خواهید زیرمجموعه‌ای از دارایی‌های مکان در مجموعه دارایی را برای یک کمپین یا گروه تبلیغاتی انتخاب کنید، یک مجموعه دارایی گروه مکان ایجاد کنید و آن را به کمپین یا گروه تبلیغات پیوست کنید.
یک مجموعه دارایی همگام‌سازی مکان ایجاد کنید و آن را به مشتری پیوست کنید
location_ownership_type را بر اساس مورد استفاده خود تنظیم کنید:
اگر صاحب مکان کسب و کار هستید، آن را روی BUSINESS_OWNER تنظیم کنید.
اگر مالک محل کسب و کار نیستید، اما محصولات خود را در آنجا بفروشید، آن را روی AFFILIATE تنظیم کنید.
source یک فیلد را بر اساس مورد استفاده خود تنظیم کنید:
اگر می‌خواهید با مکان‌هایتان در حساب Google Business Profile همگام‌سازی شود، business_profile_location_set تنظیم کنید.
اگر می‌خواهید با مکان‌های موجود در شناسه‌های زنجیره مشخص شده همگام‌سازی کنید chain_location_set تنظیم کنید.
اگر می‌خواهید به صورت دستی مکان‌ها را با استفاده از شناسه‌های مکان اضافه کنید، maps_location_set تنظیم کنید.
پس از تکمیل این مراحل، Google Ads API دارایی‌های موقعیت مکانی را ایجاد می‌کند و آنها را به مجموعه دارایی همگام‌سازی مکان ایجاد شده برای شما اضافه می‌کند، مشابه زمانی که به صورت دستی این کار را با استفاده از AssetSetAssetService انجام می‌دهید. نیازی نیست آنها را دستکاری کنید مگر اینکه بخواهید به صورت دستی آنها را به مجموعه دارایی های گروه مکان ثابت اضافه کنید .
فقط یک مجموعه دارایی همگام‌سازی مکان فعال با ( statusENABLED ) می‌تواند برای یک مشتری وجود داشته باشد. اگر می‌خواهید نوع دیگری از مجموعه دارایی همگام‌سازی مکان ایجاد کنید، ابتدا مجموعه موجود را حذف کنید.
مجموعه دارایی همگام‌سازی مکان را به مشتری پیوست کنید
(اختیاری) یک مجموعه دارایی گروه مکان ایجاد کنید و آن را به یک کمپین یا یک گروه تبلیغاتی پیوست کنید
مجموعه دارایی گروه مکان فقط در صورتی ضروری است که نیاز به انتخاب زیرمجموعه ای از دارایی های مکان داشته باشید. این به خاطر کمپین ها و گروه های تبلیغاتی است که دارایی های مکان را از سطح مشتری به ارث می برند.
مجموعه‌های دارایی گروه مکان شامل زیرمجموعه‌ای از دارایی‌های مکان مجموعه دارایی همگام‌سازی مکان هستند. می‌توانید با استفاده از برخی ویژگی‌های نمایه کسب‌وکار Google (مانند فیلتر کردن بر اساس برچسب‌ها) یا شناسه‌های زنجیره و مکان‌های زنجیره به‌صورت پویا یک مجموعه دارایی گروه مکان ایجاد کنید. از طرف دیگر، می توانید به صورت ایستا یک مجموعه دارایی گروه مکان ایجاد کنید.
اگر هنگام ایجاد مجموعه دارایی همگام‌سازی مکان ، maps_location_set را تنظیم کنید، نمی‌توانید مجموعه دارایی گروه مکان پویا ایجاد کنید. این به این دلیل است که شما به صورت دستی مکان‌ها را بر اساس شناسه مکان اضافه کرده‌اید و هیچ ویژگی فیلتری وجود ندارد که بتوانید برای این نوع مکان‌ها استفاده کنید.
مجموعه دارایی های ایستا
type روی STATIC_LOCATION_GROUP تنظیم کنید. می‌توانید مجموعه‌های دارایی گروه مکان ایستا را برای هر نوع مجموعه دارایی همگام‌سازی موقعیت مکانی ایجاد کنید، بدون توجه به اینکه چه فیلدی را در LocationSet تنظیم می‌کنید ( business_profile_location_set ، chain_location_set ، یا maps_location_set ).
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eLocation assets are automatically created after you create and attach a location sync asset set to the customer.\u003c/p\u003e\n"],["\u003cp\u003eCreate a location sync asset set by defining its type and location source (Business Profile, chain, or manual).\u003c/p\u003e\n"],["\u003cp\u003eIf needed, create a location group asset set (dynamic or static) to select a subset of location assets for a campaign or ad group.\u003c/p\u003e\n"],["\u003cp\u003eDynamic location group asset sets leverage Business Profile or chain features for filtering, while static ones require manual asset addition.\u003c/p\u003e\n"],["\u003cp\u003eAttach the location sync asset set to the customer and, optionally, the location group asset set to a campaign or ad group.\u003c/p\u003e\n"]]],[],null,["# Location assets\n\nUnlike other assets, location assets are automatically created by the Google Ads API\nafter you create an asset set. First, create a location sync asset set and\nattach it to the customer. Then, if you need to select a subset of the location\nassets in the asset set for a campaign or ad group, create a location group\nasset set and attach it to the campaign or ad group.\n\nCreate a location sync asset set and attach it to the customer\n--------------------------------------------------------------\n\n1. [Create a **location sync** asset set](#create-location-sync).\n2. [Attach it to a customer using\n `CustomerAssetSetService`](/google-ads/api/reference/rpc/v21/CustomerAssetSetService).\n\n### Create a location sync asset set\n\n1. Create a new [`AssetSet`](/google-ads/api/reference/rpc/v21/AssetSet).\n 1. Set `type` to [`LOCATION_SYNC`](/google-ads/api/reference/rpc/v21/AssetSetTypeEnum.AssetSetType#location_sync).\n 2. Set `location_set` to a new [`LocationSet`](/google-ads/api/reference/rpc/v21/LocationSet).\n2. In the new `LocationSet`,\n 1. Set `location_ownership_type` based on your use case:\n - Set it to [`BUSINESS_OWNER`](/google-ads/api/reference/rpc/v21/LocationOwnershipTypeEnum.LocationOwnershipType#business_owner) if you own the business location.\n - Set it to [`AFFILIATE`](/google-ads/api/reference/rpc/v21/LocationOwnershipTypeEnum.LocationOwnershipType#affiliate) if you don't own the business location, but sell your products there.\n 2. Set the `source` oneof field based on your use case:\n - Set `business_profile_location_set` if you want to sync with your locations in your [Google Business Profile](//www.google.com/business/) account.\n - Set `chain_location_set` if you want to sync with locations in specified chain IDs.\n - Set `maps_location_set` if you want to manually add locations using [Place IDs](/maps/documentation/places/web-service/place-id).\n\nAfter you complete these steps, the Google Ads API generates **location\nassets** and adds them to the created location sync asset set for you, similar\nto when you manually do so using\n[`AssetSetAssetService`](/google-ads/api/reference/rpc/v21/AssetSetAssetService). You don't need to\nmanipulate them unless you want to manually [add them to a static location\ngroup asset sets](#add-location-assets).\n\nOnly one active location sync asset set with\n([`status`](/google-ads/api/reference/rpc/v21/AssetSet#status) of\n[`ENABLED`](/google-ads/api/reference/rpc/v21/AssetSetStatusEnum.AssetSetStatus#enabled)) can exist\nfor a customer. If you need to create a different type of location sync asset\nset, remove the existing one first.\n\n### Attach the location sync asset set to a customer\n\nUse\n[`CustomerAssetSetService.MutateCustomerAssetSets`](/google-ads/api/reference/rpc/v21/CustomerAssetSetService/MutateCustomerAssetSets)\nto attach the location sync asset set in the previous section to your customer.\n\n(Optional) Create a location group asset set and attach it to a campaign or an ad group\n---------------------------------------------------------------------------------------\n\nA **location group** asset set is necessary only if you need to select a subset\nof location assets. This is due to campaigns and ad groups inheriting location\nassets from the customer level.\n\nLocation group asset sets contain a subset of location assets of the **location\nsync** asset set. You can dynamically create a location group asset set by\nleveraging some features of Google Business Profile (like filtering by labels)\nor chain IDs and chain locations. Alternatively, you can statically create a\nlocation group asset set.\n\n1. [Create a location group asset set](#create-location-group). The location group asset set can be **dynamic** or **static**.\n2. [Attach the asset set to a campaign using or to an ad group, depending on\n your need](#attach-location-group).\n3. [(Optional) Add the previously generated assets to the newly created static\n location group asset set](#add-location-assets).\n\nFor a given customer, you can create multiple dynamic or static location group\nasset sets.\n\n### Create a location group asset set\n\nCreate a new [`AssetSet`](/google-ads/api/reference/rpc/v21/AssetSet) and set\n`location_group_parent_asset_set_id` to the ID of the previously created\nlocation sync asset set.\n\nThen, set some fields based on whether you want to create a dynamic or static\nlocation group asset set.\n\n#### Dynamic asset sets\n\nDepending on the field you [set in `LocationSet`](#create-location-sync), set\nthe fields based on the following rule:\n\n| If you set the following field | Then set [type](/google-ads/api/reference/rpc/v21/AssetSet#type) to | And set this field as the [asset_set_source](/google-ads/api/reference/rpc/v21/AssetSet#asset_set_source) oneof field |\n|---------------------------------|---------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------|\n| `business_profile_location_set` | `BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP` | `business_profile_location_group` |\n| `chain_location_set` | `CHAIN_DYNAMIC_LOCATION_GROUP` | `chain_location_group` |\n\nIf you set `maps_location_set` when [creating the location sync asset\nset](#create-location-sync), you won't be able to create a dynamic location\ngroup asset set. This is because you've manually added locations by Place IDs\nand there are no filtering features you can use for this type of locations.\n\n#### Static asset sets\n\nSet [`type`](/google-ads/api/reference/rpc/v21/AssetSet#type) to\n[`STATIC_LOCATION_GROUP`](/google-ads/api/reference/rpc/v21/AssetSetTypeEnum.AssetSetType#static_location_group).\nYou can create static location group asset sets for any types of location\nsync asset sets, no matter what fields (`business_profile_location_set`,\n`chain_location_set`, or `maps_location_set`) you set in the\n[`LocationSet`](/google-ads/api/reference/rpc/v21/LocationSet#source).\n\nFor **static** location group asset sets, you need to\n[manually add the generated location assets to the location group asset\nsets](#add-location-assets).\n\n### Attach the asset set to a campaign or to an ad group\n\nUse\n[`CampaignAssetSetService.MutateCampaignAssetSets`](/google-ads/api/reference/rpc/v21/CampaignAssetSetService/MutateCampaignAssetSets)\nto attach the [location group asset set](#create-location-group) to your\ncampaign.\n\nAlternatively, use\n[`AdGroupAssetSetService.MutateAdGroupAssetSets`](/google-ads/api/reference/rpc/v21/AdGroupAssetSetService/MutateAdGroupAssetSets)\nif you want to attach the [location group asset set](#create-location-group) to\nan ad group instead.\n\n### (Optional) Add the location assets to the **static** location group asset set\n\nThis step is required only if you create a\n[static location group asset set](#static-asset-sets) previously.\n\n1. Use the [`asset_set_asset`](/google-ads/api/fields/v21/asset_set_asset) report to fetch the resource names of assets automatically generated for the [previously created location sync asset set](#create-location-sync). Use [filtering](/google-ads/api/docs/query/structure#where) to retrieve only the assets you want.\n2. Add them to the [static location group asset set](#static-asset-sets) using [`AssetSetAssetService.MutateAssetSetAssets`](/google-ads/api/reference/rpc/v21/AssetSetAssetService/MutateAssetSetAssets)."]]
