Recursos de ubicación

A diferencia de otros recursos, la API de Google Ads crea los recursos de ubicación automáticamente 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 recursos de ubicación en el conjunto de recursos para 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 ubicaciones.
  2. Adjúntala a un cliente con CustomerAssetSetService.

Crear 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 LocationSet nuevo.
  2. En el nuevo LocationSet,
    1. Configura location_ownership_type según tu caso de uso:
      • Establécelo en BUSINESS_OWNER si eres el propietario de la ubicación de la empresa.
      • Establécela en AFFILIATE si no eres el propietario de la ubicación de la empresa, pero vendes tus productos allí.
    2. Establece el campo oneof source según tu caso de uso:
      • Configura business_profile_location_set si deseas sincronizar con tus ubicaciones en tu cuenta de Perfil de Negocio de Google.
      • Establece chain_location_set si deseas sincronizar con ubicaciones en los IDs de cadena especificados.
      • Configura maps_location_set si deseas agregar ubicaciones de forma manual con los IDs de lugar.

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, similar a cuando lo haces de forma manual con AssetSetAssetService. No es necesario manipularlos, a menos que quieras agregarlos de forma manual a un conjunto de recursos estáticos de un grupo de ubicaciones.

Solo puede existir un recurso 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.

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

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

(Opcional) Crea un conjunto de recursos de grupo por ubicación y adjúntalo a una campaña o 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 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 un conjunto de recursos de un grupo por ubicación de forma dinámica. Para ello, aprovecha algunas funciones del Perfil de Negocio de Google (como el filtrado por etiquetas) o IDs de cadena y ubicaciones de cadenas. De forma estática, puedes crear un conjunto de recursos de grupo por ubicación.

  1. Crea un conjunto de recursos de un 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 usando o a un grupo de anuncios, según tus necesidades.
  3. (Opcional) Agrega los recursos generados anteriormente al conjunto de recursos del grupo por ubicación estático recién creado.

Para un cliente determinado, puedes crear varios conjuntos de recursos de grupos por ubicación dinámicos o estáticos.

Crear un conjunto de recursos de grupo por ubicación

Crea un AssetSet nuevo y configura location_group_parent_asset_set_id con el ID del conjunto de recursos de sincronización de ubicación creado con anterioridad.

Luego, configura algunos campos en función de 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, debes establecer los campos en función de la siguiente regla:

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

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 por ubicación dinámico. Esto se debe a que agregaste ubicaciones manualmente mediante los IDs de lugar y no hay funciones de filtrado que puedas aprovechar para este tipo de ubicaciones.

Conjuntos de recursos estáticos

Establece type en STATIC_LOCATION_GROUP. Puedes crear conjuntos de recursos de grupos por ubicación estáticos para cualquier tipo de conjunto de recursos de sincronización de ubicación, 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 de ubicación generados a los conjuntos de recursos del grupo por ubicación.

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

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

También puedes utilizar 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 por ubicación estático

Este paso solo es necesario 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 ubicación creado con anterioridad. Usa el filtrado para recuperar solo los recursos que deseas.
  2. Agrégalos al conjunto de recursos del grupo por ubicación estático mediante AssetSetAssetService.MutateAssetSetAssets.