Recursos de local

Diferente de outros recursos, os recursos de local são criados automaticamente pela API do Google Ads depois que você cria um conjunto de recursos. Primeiro, crie um conjunto de recursos de sincronização de local e anexe ao cliente. Em seguida, se você precisar selecionar um subconjunto dos recursos de local no conjunto de recursos de uma campanha ou um grupo de anúncios, crie um conjunto de recursos de grupo por local e anexe-o à campanha ou ao grupo de anúncios.

Criar um conjunto de recursos de sincronização de local e anexá-lo ao cliente

1. Crie um conjunto de recursos de sincronização de local.
2. Anexe a um cliente usando CustomerAssetSetService.

Criar um conjunto de recursos de sincronização de local

1. Crie um novo AssetSet.
   1. Defina type como LOCATION_SYNC.
   2. Defina location_set como um novo LocationSet.
2. No novo LocationSet,
   1. Defina location_ownership_type com base no seu caso de uso:
      • Defina como BUSINESS_OWNER se você for o proprietário do local da empresa.
      • Defina como AFFILIATE se você não for proprietário do local da empresa, mas vender seus produtos nele.
   2. Defina o campo source oneof com base no seu caso de uso:
      • Defina business_profile_location_set se quiser sincronizar com seus locais na conta do Perfil da Empresa no Google.
      • Defina chain_location_set se quiser sincronizar com locais em IDs de rede especificados.
      • Defina maps_location_set se quiser adicionar locais manualmente usando IDs de lugar.

Depois de concluir as etapas acima, a API Google Ads vai gerar ativos de local e adicioná-los ao conjunto de ativos de sincronização de local criado para você, de forma semelhante a quando você faz isso manualmente usando o AssetSetAssetService. Não é necessário manipular esses recursos, a menos que você queira adicionar esses recursos a um conjunto de recursos de grupo de local estático manualmente.

Apenas um conjunto de recursos de sincronização de local ativo com (status de ENABLED) pode existir para um cliente. Se você precisar criar um tipo diferente de conjunto de recursos de sincronização de local, remova o atual primeiro.

Anexar o conjunto de recursos de sincronização de local a um cliente

Use CustomerAssetSetService.MutateCustomerAssetSets para anexar o recurso de sincronização de local definido na seção anterior ao cliente.

(Opcional) Criar um conjunto de recursos de grupo por locais e anexar a uma campanha ou um grupo de anúncios

Um conjunto de recursos de grupo por locais só é necessário se você precisar selecionar um subconjunto de recursos de local. Isso ocorre porque as campanhas e os grupos de anúncios herdam os recursos de local do nível do cliente.

Os conjuntos de recursos de grupo de locais contêm um subconjunto de recursos de local do conjunto de recursos de sincronização de locais. É possível criar dinamicamente um conjunto de recursos de grupo de locais usando alguns recursos do Perfil da Empresa no Google, como a filtragem por rótulos, ou IDs e locais de rede. Como alternativa, é possível criar estaticamente um conjunto de recursos de grupo de local.

1. Crie um conjunto de recursos de grupo por locais. O conjunto de recursos do grupo por locais pode ser dinâmico ou estático.
2. Anexe o conjunto de recursos a uma campanha ou a um grupo de anúncios, dependendo da sua necessidade.
3. (Opcional) Adicione os recursos gerados anteriormente ao conjunto de recursos de grupo de local estático recém-criado.

Para um determinado cliente, é possível criar vários conjuntos de recursos de grupos de locais dinâmicos ou estáticos.

Criar um conjunto de recursos de grupo de locais

Crie um novo AssetSet e defina location_group_parent_asset_set_id como o ID do conjunto de recursos de sincronização de local criado anteriormente.

Em seguida, defina alguns campos com base em se você quer criar um conjunto de recursos de grupo de locais dinâmico ou estático.

Conjuntos de recursos dinâmicos

Dependendo do campo que você define em LocationSet, defina os campos com base na seguinte regra:

Se você definir o campo a seguir	Em seguida, defina type como	E defina esse campo como asset_set_source
business_profile_location_set	BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP	business_profile_location_group
chain_location_set	CHAIN_DYNAMIC_LOCATION_GROUP	chain_location_group

Se você definir maps_location_set ao criar o conjunto de recursos de sincronização de local, não será possível criar um conjunto de recursos de grupo de local dinâmico. Isso acontece porque você adicionou manualmente os locais por IDs de lugar e não há recursos de filtragem que possam ser usados para esse tipo de local.

Conjuntos de recursos estáticos

Defina type como STATIC_LOCATION_GROUP. É possível criar conjuntos de recursos de grupo de local estático para qualquer tipo de conjunto de recursos de sincronização de local, não importa quais campos (business_profile_location_set, chain_location_set ou maps_location_set) você definir no LocationSet.

Para conjuntos de recursos de grupo de locais estáticos, é necessário adicionar manualmente os recursos de local gerados aos conjuntos de recursos de grupo de locais.

Anexar o conjunto de recursos a uma campanha ou a um grupo de anúncios

Use CampaignAssetSetService.MutateCampaignAssetSets para anexar o conjunto de recursos do grupo por locais à sua campanha.

Como alternativa, use AdGroupAssetSetService.MutateAdGroupAssetSets se quiser anexar o conjunto de recursos do grupo de locais a um grupo de anúncios.

(Opcional) Adicionar os recursos de local ao conjunto de recursos do grupo de locais estático

Essa etapa é necessária apenas se você criou um conjunto de recursos de grupo de locais estático anteriormente.

1. Use o relatório asset_set_asset para buscar os nomes de recursos gerados automaticamente para o conjunto de recursos de sincronização de local criado anteriormente. Use a filtragem para extrair apenas os recursos que você quer.
2. Adicione-as ao conjunto de recursos de grupo por local estático usando AssetSetAssetService.MutateAssetSetAssets.