위치 확장 소재
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
다른 확장 소재와 달리 위치 확장 소재는 확장 소재 세트를 만든 후 Google Ads API에 의해 자동으로 생성됩니다. 먼저 위치 동기화 확장 소재 세트를 만들고 고객에게 연결합니다. 그런 다음 캠페인 또는 광고 그룹의 확장 소재 세트에서 위치 확장 소재의 하위 집합을 선택해야 하는 경우 위치 그룹 확장 소재 세트를 만들어 캠페인 또는 광고 그룹에 연결합니다.
위치 동기화 확장 소재 세트를 만들어 고객에게 연결
- 위치 동기화 확장 소재 세트 만들기
CustomerAssetSetService을 사용하여 고객에게 연결합니다.
위치 동기화 확장 소재 세트 만들기
- 새
AssetSet를 만듭니다.
type을 LOCATION_SYNC로 설정합니다.location_set을 새 LocationSet로 설정합니다.
- 새
LocationSet에서
- 사용 사례에 따라
location_ownership_type를 설정합니다.
- 사용 사례에 따라
source oneof 필드를 설정합니다.
- Google 비즈니스 프로필 계정의 위치와 동기화하려면
business_profile_location_set를 설정합니다.
- 지정된 체인 ID의 위치와 동기화하려면
chain_location_set를 설정합니다.
- 장소 ID를 사용하여 위치를 수동으로 추가하려면
maps_location_set를 설정합니다.
이 단계를 완료하면 Google Ads API는 위치 애셋을 생성하고 AssetSetAssetService를 사용하여 수동으로 수행하는 것과 마찬가지로 생성된 위치 동기화 애셋 세트에 추가합니다. 정적 위치 그룹 애셋 세트에 수동으로 추가하려는 경우가 아니라면 조작할 필요가 없습니다.
고객에게는 status(ENABLED)이 있는 활성 위치 동기화 애셋 세트가 하나만 있을 수 있습니다. 다른 유형의 위치 동기화 애셋 세트를 만들어야 하는 경우 먼저 기존 애셋 세트를 삭제하세요.
위치 동기화 애셋 세트를 고객에게 연결
CustomerAssetSetService.MutateCustomerAssetSets를 사용하여 이전 섹션에서 설정한 위치 동기화 확장 소재 세트를 고객에게 연결합니다.
(선택사항) 위치 그룹 확장 소재 세트를 만들어 캠페인 또는 광고 그룹에 연결
위치 그룹 애셋 세트는 위치 확장 소재의 하위 집합을 선택해야 하는 경우에만 필요합니다. 캠페인 및 광고 그룹이 고객 수준에서 위치 확장 소재를 상속하기 때문입니다.
위치 그룹 애셋 세트에는 위치 동기화 애셋 세트의 위치 애셋 하위 집합이 포함됩니다. Google 비즈니스 프로필의 일부 기능 (예: 라벨별 필터링) 또는 체인 ID 및 체인 위치를 활용하여 위치 그룹 확장 소재 세트를 동적으로 만들 수 있습니다. 또는 위치 그룹 애셋 세트를 정적으로 만들 수 있습니다.
- 위치 그룹 애셋 세트 만들기 위치 그룹 확장 소재 세트는 동적 또는 정적일 수 있습니다.
- 필요에 따라 확장 소재 세트를 캠페인 또는 광고 그룹에 연결합니다.
- (선택사항) 이전에 생성된 애셋을 새로 만든 정적 위치 그룹 애셋 세트에 추가합니다.
특정 고객의 경우 여러 동적 또는 정적 위치 그룹 애셋 세트를 만들 수 있습니다.
위치 그룹 애셋 세트 만들기
새 AssetSet를 만들고 location_group_parent_asset_set_id을 이전에 만든 위치 동기화 애셋 세트의 ID로 설정합니다.
그런 다음 동적 또는 정적 위치 그룹 확장 소재 세트를 만들지 여부에 따라 일부 필드를 설정합니다.
동적 애셋 세트
LocationSet에서 설정한 필드에 따라 다음 규칙에 따라 필드를 설정합니다.
| 다음 필드를 설정하는 경우 |
그런 다음 type을 |
이 필드를 asset_set_source oneof 필드로 설정합니다. |
business_profile_location_set |
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP |
business_profile_location_group |
chain_location_set |
CHAIN_DYNAMIC_LOCATION_GROUP |
chain_location_group |
위치 동기화 애셋 세트를 만들 때 maps_location_set를 설정하면 동적 위치 그룹 애셋 세트를 만들 수 없습니다. 이는 장소 ID로 위치를 수동으로 추가했으며 이 유형의 위치에 사용할 수 있는 필터링 기능이 없기 때문입니다.
정적 애셋 세트
type을 STATIC_LOCATION_GROUP로 설정합니다.
LocationSet에서 설정하는 필드 (business_profile_location_set, chain_location_set 또는 maps_location_set)와 관계없이 모든 유형의 위치 동기화 애셋 세트에 대해 정적 위치 그룹 애셋 세트를 만들 수 있습니다.
정적 위치 그룹 애셋 세트의 경우 생성된 위치 확장 소재를 위치 그룹 애셋 세트에 수동으로 추가해야 합니다.
애셋 세트를 캠페인 또는 광고 그룹에 연결
CampaignAssetSetService.MutateCampaignAssetSets을 사용하여 위치 그룹 확장 소재 세트를 캠페인에 연결합니다.
또는 위치 그룹 확장 소재 세트를 광고 그룹에 연결하려면 AdGroupAssetSetService.MutateAdGroupAssetSets을 사용하세요.
(선택사항) 정적 위치 그룹 애셋 세트에 위치 확장 소재 추가
이 단계는 이전에 정적 위치 그룹 애셋 세트를 만든 경우에만 필요합니다.
asset_set_asset 보고서를 사용하여 이전에 만든 위치 동기화 확장 소재 세트에 대해 자동으로 생성된 확장 소재의 리소스 이름을 가져옵니다. 필터링을 사용하여 원하는 저작물만 검색합니다.AssetSetAssetService.MutateAssetSetAssets를 사용하여 정적 위치 그룹 확장 소재 세트에 추가합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[null,null,["최종 업데이트: 2025-08-27(UTC)"],[[["\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)."]]
