Recursos de ubicación

A diferencia de otros recursos, la API de Google Ads crea automáticamente 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 recursos de ubicación en el 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.

Cree un conjunto de recursos de sincronización de ubicación y adjúntelo al cliente

  1. Crea un conjunto de recursos de sincronización de ubicación.
  2. Conéctala a un cliente mediante CustomerAssetSetService.

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

  1. Crea una nueva AssetSet.
    1. Establece type en LOCATION_SYNC.
    2. Establece location_set en un nuevo LocationSet.
  2. En la nueva LocationSet, haz lo siguiente:
    1. Configura location_ownership_type según tu caso de uso:
      • Configúrala en BUSINESS_OWNER si eres el propietario de la ubicación de la empresa.
      • Configúrala en AFFILIATE si no eres propietario de la ubicación de la empresa, pero vendes tus productos allí.
    2. Configura el campo oneof source según tu caso de uso:
      • Configura business_profile_location_set si deseas sincronizar con las ubicaciones de tu cuenta del Perfil de Negocio de Google.
      • Establece chain_location_set si deseas sincronizar con ubicaciones en IDs de cadena especificados.
      • Configura maps_location_set si deseas agregar ubicaciones de forma manual mediante 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 por ti, de manera similar a cuando lo haces manualmente con AssetSetAssetService. No es necesario que los manipules, a menos que quieras agregarlos manualmente a un conjunto de recursos de un grupo por ubicación estático.

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

Adjuntar el recurso de sincronización de ubicación a un cliente

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

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

El conjunto de recursos del 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 ubicación. Puedes crear un conjunto de recursos del grupo por ubicación de forma dinámica si aprovechas algunas funciones del Perfil de Negocio de Google (como el filtrado por etiquetas) o los IDs de cadenas y las ubicaciones de cadenas. Como alternativa, puedes crear, de forma estática, un conjunto de recursos del grupo por ubicación.

  1. Crea un conjunto de recursos del 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 que utiliza 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.

Cómo crear un conjunto de recursos de un 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, configura algunos campos en función de si deseas crear un conjunto de recursos de un grupo por ubicación dinámico o estático.

Conjuntos de recursos dinámicos

Según el campo que establezcas en LocationSet, configúralos según la siguiente regla:

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

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 del 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.

Para 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

Usa 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 estático del grupo por ubicación

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

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