Recursos de local

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

Criar um conjunto de recursos de sincronização de local e anexar ao cliente

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

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

  1. Crie um 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-o como BUSINESS_OWNER se você for o proprietário do local da empresa.
      • Defina-o como AFFILIATE se você não for o proprietário do local da empresa, mas vender seus produtos lá.
    2. Defina o campo oneof source com base no seu caso de uso:
      • Defina business_profile_location_set se quiser sincronizar com os locais na conta do Perfil da Empresa no Google.
      • Defina chain_location_set se você quiser sincronizar com locais em IDs de rede especificados.
      • Defina maps_location_set se você quiser adicionar locais manualmente usando IDs de lugar.

Depois que você concluir as etapas acima, a API Google Ads vai gerar recursos de local e adicioná-los ao conjunto de recursos de sincronização de local criado, da mesma forma que você faria manualmente usando AssetSetAssetService. Elas não precisam ser manipuladas, a menos que você queira adicioná-las manualmente a um conjunto de recursos de grupos de locais estáticos.

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

Anexar o recurso de sincronização de local definido 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ê precisa selecionar um subconjunto de recursos. Isso acontece porque as campanhas e os grupos de anúncios herdam os recursos de local do cliente.

Os conjuntos de recursos do grupo por locais contêm um subconjunto do conjunto de recursos de sincronização de local. Você pode criar dinamicamente um conjunto de recursos de grupo por locais usando alguns recursos do Perfil da Empresa no Google (como filtragem por rótulos) ou IDs de redes e locais da rede. Como alternativa, você pode criar estaticamente um conjunto de recursos de grupo por locais.

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

Para um determinado cliente, você pode criar vários conjuntos de recursos de grupos por locais dinâmicos ou estáticos.

Criar um conjunto de recursos de grupo por locais

Crie um 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 para criar um conjunto de recursos de grupo por locais dinâmicos ou estáticos.

Conjuntos de recursos dinâmicos

Dependendo do campo definido em LocationSet, defina os campos com base na seguinte regra:

Se você definir o seguinte campo: Depois 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 por locais dinâmicos. Isso ocorre porque você adicionou locais manualmente por IDs de lugares, e não há recursos de filtragem disponíveis para esse tipo de local.

Conjuntos de recursos estáticos

Defina type como STATIC_LOCATION_GROUP. É possível criar conjuntos de recursos estáticos de grupos por locais 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 em LocationSet.

Para conjuntos de recursos de grupos por locais estáticos, você precisa adicionar manualmente os recursos de local gerados a esses conjuntos.

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

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

Você também pode usar AdGroupAssetSetService.MutateAdGroupAssetSets se quiser anexar o conjunto de recursos do grupo por locais a um grupo de anúncios.

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

Essa etapa só será necessária se você tiver criado um conjunto de recursos de grupo por locais estáticos anteriormente.

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