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 ubicación y adjúntalo al cliente. Luego, si necesitas seleccionar un subconjunto de los recursos de ubicación en el conjunto de recursos de una campaña o un grupo de anuncios, crea un conjunto de recursos de 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 ubicación y adjúntalo al cliente

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

Crea un conjunto de recursos de sincronización de ubicación

1. Crea un AssetSet nuevo.
   1. Establece type en LOCATION_SYNC.
   2. Establece location_set en un nuevo LocationSet.
2. En el nuevo LocationSet, haz lo siguiente:
   1. Establece location_ownership_type según tu caso de uso:
      • Establece la opción en BUSINESS_OWNER si eres propietario de la ubicación de la empresa.
      • Establece el valor en AFFILIATE si no eres propietario de la ubicación de la empresa, pero vendes tus productos allí.
   2. Establece el campo source oneof según tu caso de uso:
      • Establece business_profile_location_set si deseas sincronizar con tus ubicaciones en tu cuenta del Perfil de Negocio de Google.
      • Establece chain_location_set si deseas sincronizar con ubicaciones en los IDs de cadenas especificados.
      • Establece maps_location_set si deseas agregar ubicaciones manualmente con los IDs de Place.

Después de completar los pasos anteriores, la API de Google Ads generará recursos de ubicación y los agregará al conjunto de recursos de sincronización de ubicación creado por ti, de manera similar a cuando lo haces de forma manual con AssetSetAssetService. No es necesario que los manipules, a menos que quieras agregarlos de forma manual a un conjunto de recursos de grupo de ubicaciones estáticas.

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

Cómo adjuntar el recurso de sincronización de ubicación establecido a un cliente

Usa CustomerAssetSetService.MutateCustomerAssetSets para adjuntar el recurso de sincronización de ubicación establecido en la sección anterior a tu cliente.

Opcional: Crea un conjunto de recursos de 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 los grupos por ubicación contienen un subconjunto de recursos de ubicación del conjunto de recursos de sincronización de ubicaciones. Puedes crear de forma dinámica un conjunto de recursos de grupo por ubicación aprovechando algunas funciones del Perfil de Negocio de Google (como filtrar 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 de grupo por ubicación. El conjunto de recursos del grupo por ubicación 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 que acabas de crear.

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

Crea un conjunto de recursos de grupo por ubicación

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

Luego, establece algunos campos según si deseas crear un conjunto de recursos de grupo por ubicación 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 establece 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 ubicación, no podrás crear un conjunto de recursos de grupo de ubicación dinámico. Esto se debe a que agregaste ubicaciones de forma manual por ID de lugar y no hay funciones de filtrado que puedas aprovechar para este tipo de ubicaciones.

Conjuntos de recursos estáticos

Establece type como STATIC_LOCATION_GROUP. Puedes crear conjuntos de recursos de grupo de ubicaciones estáticos para cualquier tipo de conjunto de recursos de sincronización de ubicaciones, sin importar qué campos (business_profile_location_set, chain_location_set o maps_location_set) configures en LocationSet.

En el caso de los conjuntos de recursos de grupos por ubicación estáticos, debes agregar manualmente los recursos de 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 de grupo por ubicación a tu campaña.

Como alternativa, usa AdGroupAssetSetService.MutateAdGroupAssetSets si deseas adjuntar el conjunto de recursos del grupo de ubicaciones a un grupo de anuncios.

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

Este paso solo es obligatorio si creaste un conjunto de recursos de grupo por ubicación estático anteriormente.

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