Recursos de ubicación

A diferencia de otros recursos, la API de Google Ads crea automáticamente los recursos de ubicación después de que creas un conjunto de recursos. Primero, crea un conjunto de recursos de sincronización de ubicaciones y adjúntalo al cliente. Luego, si necesitas seleccionar un subconjunto de los recursos de ubicación del conjunto de recursos para una campaña o un grupo de anuncios, crea un conjunto de recursos del grupo por ubicación y adjúntalo a la campaña o al grupo de anuncios.

Crea un conjunto de recursos de sincronización de ubicaciones y adjúntalo al cliente

1. Crea un conjunto de recursos de sincronización de ubicaciones.
2. [Adjúntalo a un cliente con CustomerAssetSetService].

Crea un conjunto de recursos de sincronización de ubicaciones

1. Crea un AssetSet nuevo.
   1. Establece type en LOCATION_SYNC.
   2. Establece location_set en un nuevo LocationSet.
2. En el nuevo LocationSet,
   1. Establece location_ownership_type según tu caso de uso:
      • Configúralo como BUSINESS_OWNER si eres propietario de la ubicación de la empresa.
      • Establécela en AFFILIATE si no eres propietario de la ubicación de la empresa, pero vendes tus productos allí.
   2. Configura el campo source oneof según tu caso de uso:
      • Establece business_profile_location_set si deseas sincronizar tus ubicaciones con tu cuenta del Perfil de Negocio de Google.
      • Establece chain_location_set si deseas sincronizarte con ubicaciones en los IDs de cadena especificados.
      • Establece maps_location_set si deseas agregar ubicaciones manualmente con IDs de lugar.

Después de completar estos pasos, la API de Google Ads genera recursos de ubicación y los agrega al conjunto de recursos de sincronización de ubicaciones creado, de forma similar a cuando lo haces manualmente con AssetSetAssetService. No es necesario que los manipules, a menos que desees agregarlos manualmente a conjuntos de recursos de grupos de ubicaciones estáticas.

Solo puede existir un conjunto de recursos de sincronización de ubicaciones activo con (status de ENABLED) para un cliente. Si necesitas crear un conjunto de recursos de sincronización de ubicaciones de otro tipo, primero quita el existente.

Adjunta el conjunto de recursos de la sincronización de la ubicación a un cliente

Usa CustomerAssetSetService.MutateCustomerAssetSets para adjuntar el conjunto de recursos de sincronización de ubicaciones establecido en la sección anterior a tu cliente.

(Opcional) Crea un conjunto de recursos del grupo por ubicación y adjúntalo a una campaña o a un grupo de anuncios

Un conjunto de recursos de grupo por ubicación solo es necesario si necesitas seleccionar un subconjunto de recursos de ubicación. Esto se debe a que las campañas y los grupos de anuncios heredan los recursos de ubicación del nivel del cliente.

Los conjuntos de recursos de grupos por ubicación contienen un subconjunto de los recursos de ubicación del conjunto de recursos de la sincronización de ubicaciones. Puedes crear de forma dinámica un conjunto de recursos del grupo por ubicación aprovechando algunas funciones del Perfil de Negocio de Google (como el filtrado por etiquetas) o los IDs y las ubicaciones de la cadena. Como alternativa, puedes crear de forma estática un conjunto de recursos de grupo de ubicaciones.

1. Crea un conjunto de recursos del grupo de ubicaciones. El conjunto de recursos del grupo de ubicaciones puede ser dinámico o estático.
2. Adjunta el conjunto de recursos a una campaña o a un grupo de anuncios, según tus necesidades.
3. (Opcional) Agrega los recursos generados anteriormente al conjunto de recursos del grupo de ubicaciones estáticas recién creado.

Para un cliente determinado, puedes crear varios conjuntos de recursos de grupos de ubicaciones dinámicos o estáticos.

Crea un conjunto de recursos del grupo por ubicación

Crea un objeto AssetSet nuevo y establece location_group_parent_asset_set_id en el ID del conjunto de recursos de sincronización de ubicaciones creado anteriormente.

Luego, configura algunos campos según si deseas crear un conjunto de recursos del grupo de ubicaciones dinámico o estático.

Conjuntos de recursos dinámicos

Según el campo que establezcas en LocationSet, configura los campos según la siguiente regla:

Si configuras el siguiente campo	Luego, establece type en	Y configura este campo como el campo 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

Si configuras maps_location_set cuando creas el conjunto de recursos de sincronización de ubicaciones, no podrás crear un conjunto de recursos de grupo de ubicaciones dinámico. Esto se debe a que agregaste ubicaciones manualmente por ID de lugar y no hay funciones de filtrado que puedas usar para este tipo de ubicaciones.

Conjuntos de recursos estáticos

Establece type en STATIC_LOCATION_GROUP. Puedes crear conjuntos de recursos de grupos de ubicaciones estáticos para cualquier tipo de conjuntos de recursos de sincronización de ubicaciones, independientemente de los campos (business_profile_location_set, chain_location_set o maps_location_set) que configures en LocationSet.

En el caso de los conjuntos de recursos de grupos por ubicación estáticos, debes agregar manualmente los recursos ubicación generados a los conjuntos de recursos de grupos por ubicación.

Adjunta el conjunto de recursos a una campaña o a un grupo de anuncios

Usa CampaignAssetSetService.MutateCampaignAssetSets para adjuntar el conjunto de recursos del grupo por ubicación a tu campaña.

Como alternativa, usa AdGroupAssetSetService.MutateAdGroupAssetSets si deseas adjuntar el conjunto de recursos del grupo por ubicación a un grupo de anuncios.

(Opcional) Agrega los recursos de ubicación al conjunto de recursos del grupo de ubicaciones estático.

Este paso solo es obligatorio si creaste un conjunto de recursos de grupo de ubicaciones estático anteriormente.

1. Usa el informe asset_set_asset para recuperar los nombres de recursos de los recursos creados automáticamente para el conjunto de recursos de sincronización de ubicaciones creado anteriormente. Usa filtros para recuperar solo los activos que desees.
2. Agrégalos al conjunto de recursos del grupo por ubicación estático con AssetSetAssetService.MutateAssetSetAssets.