Объекты местоположения

В отличие от других ресурсов, ресурсы местоположения автоматически создаются API Google Ads после создания набора ресурсов. Сначала создайте набор ресурсов синхронизации местоположения и прикрепите его к клиенту. Затем, если вам нужно выбрать подмножество ресурсов местоположения в наборе ресурсов для кампании или группы объявлений, создайте набор ресурсов группы местоположений и прикрепите его к кампании или группе объявлений.

Создайте набор ресурсов синхронизации местоположения и прикрепите его к клиенту.

1. Создайте набор активов синхронизации местоположения .
2. Прикрепите его к клиенту с помощью CustomerAssetSetService .

Создайте набор ресурсов синхронизации местоположения

1. Создайте новый AssetSet .
   1. Установите type на LOCATION_SYNC .
   2. Установите location_set на новый LocationSet .
2. В новом LocationSet ,
   1. Установите location_ownership_type в зависимости от вашего варианта использования:
      • Если вы являетесь владельцем местоположения компании, установите значение BUSINESS_OWNER .
      • Установите значение AFFILIATE если вы не являетесь владельцем местоположения компании, но продаете там свою продукцию.
   2. Установите source поле oneof в зависимости от вашего варианта использования:
      • Установите business_profile_location_set если вы хотите синхронизировать данные с вашими местоположениями в аккаунте Google Business Profile .
      • Установите chain_location_set , если вы хотите синхронизироваться с местоположениями в указанных идентификаторах цепочек.
      • Установите maps_location_set , если вы хотите вручную добавлять местоположения с помощью идентификаторов мест .

После выполнения этих шагов API Google Ads сгенерирует ресурсы местоположения и добавит их в созданный вами набор ресурсов синхронизации местоположения, аналогично тому, как это делается вручную с помощью AssetSetAssetService . Вам не нужно управлять ими, если только вы не хотите вручную добавлять их в наборы ресурсов статической группы местоположений .

Для клиента может существовать только один активный набор ресурсов синхронизации местоположения со status « ENABLED ». Если вам нужно создать другой тип набора ресурсов синхронизации местоположения, сначала удалите существующий.

Прикрепите набор ресурсов синхронизации местоположения к клиенту

Используйте CustomerAssetSetService.MutateCustomerAssetSets , чтобы прикрепить набор ресурсов синхронизации местоположения из предыдущего раздела к вашему клиенту.

(Необязательно) Создайте набор активов группы местоположений и прикрепите его к кампании или группе объявлений.

Набор ресурсов группы местоположений необходим только в том случае, если вам нужно выбрать подмножество ресурсов местоположений. Это связано с тем, что кампании и группы объявлений наследуют ресурсы местоположений с уровня клиента.

Наборы ресурсов группы местоположений содержат подмножество ресурсов синхронизации местоположений . Вы можете динамически создавать набор ресурсов группы местоположений, используя некоторые функции профиля компании Google (например, фильтрацию по меткам) или идентификаторы цепочек и местоположения цепочек. Кроме того, вы можете создать набор ресурсов группы местоположений статически.

1. Создайте набор активов группы местоположений . Набор активов группы местоположений может быть динамическим или статическим .
2. Прикрепите набор активов к кампании с помощью или к группе объявлений, в зависимости от ваших потребностей .
3. (Необязательно) Добавьте ранее созданные активы в недавно созданный набор активов статической группы местоположений .

Для определенного клиента вы можете создать несколько динамических или статических наборов активов группы местоположений.

Создайте набор активов группы местоположений

Создайте новый AssetSet и задайте для location_group_parent_asset_set_id идентификатор ранее созданного набора активов синхронизации местоположений.

Затем задайте некоторые поля в зависимости от того, хотите ли вы создать динамический или статический набор активов группы местоположений.

Динамические наборы активов

В зависимости от поля, которое вы задали в LocationSet , задайте поля на основе следующего правила:

Если вы установите следующее поле	Затем установите тип	И установите это поле как поле 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 при создании набора ресурсов синхронизации местоположений , вы не сможете создать набор ресурсов динамической группы местоположений. Это связано с тем, что вы вручную добавили местоположения по идентификаторам мест, а для такого типа местоположений отсутствуют функции фильтрации.

Статические наборы активов

Установите type на STATIC_LOCATION_GROUP . Вы можете создавать статические наборы активов группы местоположений для любых типов наборов активов синхронизации местоположений, независимо от того, какие поля ( business_profile_location_set , chain_location_set или maps_location_set ) вы задали в LocationSet .

Для статических наборов активов группы местоположений необходимо вручную добавить сгенерированные активы местоположений в наборы активов группы местоположений .

Прикрепите набор активов к кампании или группе объявлений.

Используйте CampaignAssetSetService.MutateCampaignAssetSets , чтобы прикрепить набор активов группы местоположений к вашей кампании.

В качестве альтернативы используйте AdGroupAssetSetService.MutateAdGroupAssetSets , если вы хотите прикрепить набор активов группы местоположений к группе объявлений.

(Необязательно) Добавьте ресурсы местоположения в набор ресурсов статической группы местоположений.

Этот шаг необходим только в том случае, если вы ранее создали набор статических активов группы местоположений .

1. Используйте отчёт asset_set_asset для получения имён ресурсов, автоматически сгенерированных для ранее созданного набора ресурсов синхронизации местоположения . Используйте фильтрацию , чтобы получить только нужные вам ресурсы.
2. Добавьте их в набор активов статической группы местоположений с помощью AssetSetAssetService.MutateAssetSetAssets .