Campañas de Servicios Locales

Las campañas de Servicios Locales te permiten promocionar tu empresa en Google y obtener clientes potenciales directamente de los clientes potenciales. En esta guía, se resumen las operaciones y las restricciones admitidas en la API de Google Ads.

Operaciones admitidas

La API de Google Ads admite las siguientes operaciones para las campañas de Servicios Locales.

Recupera campañas y presupuestos de Servicios Locales

Las campañas y los presupuestos de Servicios Locales se pueden recuperar con el GoogleAdsService.Search o GoogleAdsService.SearchStream método para consultar los recursos Campaign en los que advertising_channel_type = 'LOCAL_SERVICES'. A continuación, se muestra un ejemplo:

SELECT
  campaign.id,
  campaign.status,
  campaign_budget.id,
  campaign_budget.period,
  campaign_budget.amount_micros,
  campaign_budget.type
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

Edita campañas de Servicios Locales

Puedes actualizar el status de la campaña y los campos amount_micros del presupuesto de la campaña asociado.

Establece la estrategia de ofertas

Puedes establecer las siguientes estrategias de ofertas como la estrategia de ofertas estándar de las campañas de Servicios Locales:

Establece una programación de anuncios como criterio de la campaña

Puedes establecer una programación de anuncios para una campaña de Servicios Locales como criterio de la campaña.

Crea un AdScheduleInfo y establécelo en el ad_schedule del CampaignCriterion que se envía a la API de Google Ads con CampaignCriterionService.MutateCampaignCriteria.

Establece la segmentación geográfica

Para habilitar la segmentación geográfica de una campaña de Servicios Locales, agrega un LocationInfo y establécelo en el location campo del CampaignCriterion que se envía a la API de Google Ads con CampaignCriterionService.MutateCampaignCriteria. Para obtener más detalles, consulta Segmentación geográfica.

Segmenta tus anuncios para tipos de servicios específicos

Para habilitar la segmentación para un tipo de servicio específico, crea un LocalServiceIdInfo con uno de los IDs de categoría de Servicios Locales, establécelo en el local_service_id campo de un CampaignCriterion, y envíalo con CampaignCriterionService.MutateCampaignCriteria.

Debes usar un ID de servicio que coincida con la ubicación y la categoría de segmentación de tu campaña.

Envía comentarios sobre los clientes potenciales

Usa el ProvideLeadFeedback método de LocalServicesLeadService para enviar calificaciones y comentarios sobre un cliente potencial. También puedes inspeccionar el lead_feedback_submitted campo de la LocalServicesLead para determinar si se calificó un cliente potencial y se enviaron comentarios.

Operaciones no admitidas

En la siguiente tabla, se indican las operaciones no admitidas para las campañas de Servicios Locales independientes (advertising_channel_type = 'LOCAL_SERVICES').

Operaciones no admitidas
Crea y quita campañas La API de Google Ads bloquea la creación y la eliminación de campañas de Servicios Locales independientes (advertising_channel_type = 'LOCAL_SERVICES'). A partir de la v26, puedes crear campañas de máximo rendimiento de Servicios Locales nuevas (advertising_channel_type = 'PERFORMANCE_MAX') estableciendo pmax_campaign_settings.local_services_enabled = true. Consulta Crea campañas de máximo rendimiento de Servicios Locales.
Operaciones en subentidades de una campaña En el caso de las campañas de Servicios Locales independientes (advertising_channel_type = 'LOCAL_SERVICES'), la API de Google Ads no admite la creación, la modificación, la eliminación ni la recuperación de grupos de anuncios, anuncios o criterios que no sean los criterios de la campaña que se indican en Operaciones admitidas. En el caso de las campañas de máximo rendimiento de Servicios Locales, usa grupos de recursos y criterios de la campaña.

Recursos de Servicios Locales

Algunos datos de los Anuncios de Servicios Locales se exponen directamente en la API de Google Ads a través de los siguientes recursos de informes de solo lectura:

Para que estos recursos muestren datos, debe haber una campaña de Servicios Locales en la cuenta de cliente que realiza la solicitud. Como solo puede haber una campaña de Servicios Locales por cuenta de cliente, estos recursos no especifican una campaña. Para identificar la campaña con la que están afiliados estos recursos, usa la siguiente consulta:

SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

Cliente potencial de Servicios Locales

LocalServicesLead expone los detalles de un cliente potencial que se generan cuando un consumidor llama, envía mensajes o reserva un servicio del anunciante.

Los datos de los clientes potenciales de Servicios Locales se pueden recuperar del local_services_lead recurso. Este es un ejemplo de consulta:

SELECT
  local_services_lead.lead_type,
  local_services_lead.category_id,
  local_services_lead.service_id,
  local_services_lead.contact_details,
  local_services_lead.lead_status,
  local_services_lead.creation_date_time,
  local_services_lead.locale,
  local_services_lead.lead_charged,
  local_services_lead.credit_details.credit_state,
  local_services_lead.credit_details.credit_state_last_update_date_time
FROM local_services_lead

Limitaciones

  • El campo contact_details es nulo si lead_status es igual a WIPED_OUT.
  • A partir de v25, se quita ContactDetails.email y ContactDetails.phone_number_extension está disponible en el mensaje ContactDetails que muestra local_services_lead.contact_details.
  • No están disponibles los datos de los clientes potenciales en los que el category_id forma parte de una categoría de atención médica.

Conversación de clientes potenciales de Servicios Locales

LocalServicesLeadConversation expone los detalles de las conversaciones que se llevaron a cabo como parte de un LocalServicesLead. Existe una relación de uno a varios con LocalServicesLead, en la que un cliente potencial puede tener muchas conversaciones. El nombre del recurso del cliente potencial relacionado se puede encontrar en el campo lead.

Los datos de las conversaciones se pueden recuperar del local_services_lead_conversation recurso. Este es un ejemplo de consulta que filtra los resultados que son llamadas telefónicas:

SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.conversation_channel,
  local_services_lead_conversation.participant_type,
  local_services_lead_conversation.lead,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.phone_call_details.call_duration_millis,
  local_services_lead_conversation.phone_call_details.call_recording_url,
  local_services_lead_conversation.message_details.text,
  local_services_lead_conversation.message_details.attachment_urls
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'

Puedes usar el LocalServicesLeadService.AppendLeadConversation método para agregar LocalServicesLeadConversation recursos a un LocalServicesLead.

Limitaciones

  • Para acceder a la URL de grabación de llamadas, debes acceder con una dirección de correo electrónico que tenga al menos acceso de solo lectura a la cuenta de cliente de Google Ads que posee la campaña con la que está asociado el cliente potencial.

  • Solicitar todas las conversaciones a la vez puede ser una solicitud que requiere mucho tiempo, por lo que debes filtrar las conversaciones por cliente potencial, por ejemplo:

    SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.message_details.text
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'

Artefactos de verificación

LocalServicesVerificationArtifact expone los datos de verificación de las empresas de los anunciantes. Ten en cuenta que estas verificaciones son a nivel de la empresa y no incluyen verificaciones de los empleados. Los datos incluyen lo siguiente:

  • Verificaciones de licencias
  • Verificaciones de seguros
  • Verificaciones de antecedentes
  • Verificaciones de registro de la empresa

Cada vez que se envía una solicitud de verificación a los Anuncios de Servicios Locales, se crea una nueva instancia de artefacto de verificación en la API de Google Ads, y cada artefacto de verificación representa una sola solicitud de verificación. Cada artefacto de verificación puede contener parte de la siguiente información, según el tipo de solicitud de verificación que represente:

  • Estado de cada artefacto de verificación
  • URL de verificación de antecedentes que se usará para la verificación de antecedentes
  • Tiempo de adjudicación de la verificación de antecedentes (si corresponde)
  • URL del documento del seguro para ver la información del seguro ya enviada
  • Motivo del rechazo del seguro (si corresponde)
  • Detalles de la licencia (tipo, número, nombres y apellidos)
  • Motivo del rechazo de la licencia (si corresponde)
  • URL del documento de la licencia para ver la imagen de la licencia ya enviada (si corresponde)
  • Detalles del registro de la empresa (ID de verificación, número de registro)
  • Motivo del rechazo del registro de la empresa (si corresponde)
  • URL del documento de registro de la empresa para ver la imagen de registro ya enviada (si corresponde)

Los datos de los artefactos de verificación se pueden recuperar del local_services_verification_artifact recurso. Este es un ejemplo de consulta que recupera datos de todos los artefactos de verificación relacionados con la licencia para una cuenta de cliente determinada:

SELECT
  local_services_verification_artifact.id,
  local_services_verification_artifact.creation_date_time,
  local_services_verification_artifact.status,
  local_services_verification_artifact.artifact_type,
  local_services_verification_artifact.license_verification_artifact.license_type,
  local_services_verification_artifact.license_verification_artifact.license_number,
  local_services_verification_artifact.license_verification_artifact.licensee_first_name,
  local_services_verification_artifact.license_verification_artifact.licensee_last_name,
  local_services_verification_artifact.license_verification_artifact.rejection_reason
FROM local_services_verification_artifact
WHERE local_services_verification_artifact.artifact_type = 'LICENSE'

Datos de verificación geográficos y categóricos

Para determinar de forma programática el estado de las solicitudes de verificación por ubicación geográfica (específicamente, código de segmentación geográfica) y el ID de categoría de Servicios Locales, puedes usar el local_services_settings campo en el recurso customer, que tiene el tipo LocalServicesSettings.

Este campo expone un resumen de alto nivel del estado de las solicitudes de verificación de licencias y seguros por ubicación y categoría. Este es un ejemplo de consulta que recupera todos esos datos:

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

Empleado de Servicios Locales

LocalServicesEmployee expone los datos sobre los empleados de Servicios Locales que los anunciantes subieron a su perfil de anuncio en nuestros sistemas.

Este es un ejemplo de consulta que recupera datos de todos los empleados de Servicios Locales para una cuenta de cliente determinada:

SELECT
  local_services_employee.status,
  local_services_employee.type,
  local_services_employee.university_degrees,
  local_services_employee.residencies,
  local_services_employee.fellowships,
  local_services_employee.job_title,
  local_services_employee.year_started_practicing,
  local_services_employee.languages_spoken,
  local_services_employee.first_name,
  local_services_employee.middle_name,
  local_services_employee.last_name
FROM local_services_employee

Campañas de máximo rendimiento de Servicios Locales

Las campañas de máximo rendimiento admiten parámetros de configuración relacionados con Servicios Locales a partir de la v24. Estos parámetros de configuración te permiten configurar e identificar una campaña de máximo rendimiento que publica Anuncios de Servicios Locales (GLS PMax).

Crea campañas de máximo rendimiento de Servicios Locales

A partir de la v26, puedes crear campañas de máximo rendimiento de Servicios Locales nuevas a través de la API. Para ello, crea una campaña de máximo rendimiento (advertising_channel_type = 'PERFORMANCE_MAX') y establece local_services_enabled = true en pmax_campaign_settings (inmutable después de la creación). Cuando crees una campaña de máximo rendimiento de Servicios Locales, se requerirán country_code y listing_id en local_services_pmax_campaign_settings.

En la v24 y la v25, la API solo admite actualizaciones para las campañas de máximo rendimiento de Servicios Locales existentes que crearon las cuentas incluidas en la lista de entidades permitidas en la IU.

Identifica las campañas de máximo rendimiento de Servicios Locales

Para identificar si una campaña de máximo rendimiento es una campaña de Servicios Locales, verifica el campo local_services_enabled en el pmax_campaign_settings de la campaña.

Opciones de configuración

En el caso de las campañas en las que local_services_enabled es true, configura los parámetros en el local_services_pmax_campaign_settings campo:

  • listing_id: Es el ID de la ficha de Perfil de Negocio de Google vinculado a la campaña. A partir de v26, este campo es obligatorio e inmutable durante la creación de la campaña de máximo rendimiento de Servicios Locales. El ID de la ficha debe estar vinculado a la cuenta como un recurso LOCATION habilitado; de lo contrario, la API muestra un CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID error. Como listing_id está marcado como IMMUTABLE, si intentas actualizar este campo después de la creación de la campaña, se produce un error RequestError.IMMUTABLE_FIELD. Los desarrolladores pueden descubrir o verificar los IDs de fichas vinculados consultando el Asset recurso para los recursos LOCATION habilitados (inspeccionando location_asset.business_profile_locations). Para obtener más información, consulta Recursos de ubicación.
  • navigational_query_leads_enabled: Indica si se debe usar un filtro de consulta de navegación.
  • founding_year: Es el año de fundación de la empresa.
  • country_code: Es el código de país del Anuncio de Servicios Locales. Este campo es inmutable y se establece una vez durante la creación del anuncio. Es un código de país de dos letras en mayúscula que se usa para determinar los requisitos de verificación y validar la selección de criterios de ubicación.
  • phone_numbers: Es una lista de números de teléfono asociados con el proveedor, representados por LocalServicesPhoneNumber mensajes.

Números de teléfono

Cada entrada del campo repetido phone_numbers usa el tipo de mensaje LocalServicesPhoneNumber con los campos siguientes:

  • phone_number: Es el número de teléfono.
  • country_code: Es un código de país de dos letras en mayúscula .
  • phone_number_type: Es el tipo de número de teléfono, definido por GlsPhoneNumberTypeEnum.GlsPhoneNumberType. Entre los tipos admitidos, se incluyen los siguientes:
    • DESTINATION_PHONE_NUMBER_FOR_ADS: Es el número de destino que se usará para las llamadas desde una unidad de anuncio de Servicios Locales (predeterminado).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: Es el número de destino que admite SMS.
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: Es el número de destino de la cuenta de WhatsApp de un proveedor.