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 de 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 propietario de la ubicación de la empresa.
      • Configúralo como AFFILIATE si no eres propietario de la ubicación de la empresa, pero vendes tus productos allí.
    2. Configura el campo único source según tu caso de uso:
      • Configura business_profile_location_set si deseas sincronizar los datos con las ubicaciones de tu cuenta del Perfil de Negocio de Google.
      • Configura chain_location_set si deseas sincronizar con ubicaciones en IDs de cadena especificados.
      • Configura maps_location_set si deseas agregar ubicaciones manualmente mediante 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 automáticamente, 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 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 recurso de sincronización de ubicación a un cliente

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

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

El 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 por ubicación. Puedes crear un conjunto de recursos de 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 de grupos 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 un grupo de anuncios o a una campaña, según tus necesidades.
  3. (Opcional) Agrega los recursos generados con anterioridad 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, configura los campos según la siguiente regla:

Si estableces el siguiente campo Luego, configura type como Y configura este campo como asset_set_source de campo
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 por ubicación dinámico. Esto se debe a que agregaste manualmente las ubicaciones según 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 por 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 antes creaste 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 de los elementos 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égalos al conjunto de recursos de grupos por ubicación estáticos mediante AssetSetAssetService.MutateAssetSetAssets.