Campañas de Servicios Locales

Las campañas de Servicios locales te permiten promocionar tu empresa en Google y obtener solicitudes de servicio directamente de los clientes potenciales. En esta guía, se resumen las operaciones y 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 las campañas y los presupuestos de Servicios Locales

Las campañas y los presupuestos de Servicios locales se pueden recuperar con el método GoogleAdsService.Search o GoogleAdsService.SearchStream 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'

Cómo editar las campañas de Servicios Locales

Puedes actualizar los campos 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:

Cómo establecer una programación de anuncios como criterio de campaña

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

Crea un AdScheduleInfo y configúralo en el ad_schedule del CampaignCriterion que se envía a la API de Google Ads con CampaignCriterionService.MutateCampaignCriteria.

Cómo configurar la segmentación geográfica

Para habilitar la segmentación geográfica en una campaña de Servicios locales, agrega un objeto LocationInfo y establécelo en el campo location del objeto 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 servicio específicos

Para habilitar la segmentación para un tipo de servicio específico, crea un objeto LocalServiceIdInfo con uno de los IDs de categoría de Servicios locales, configúralo en el campo local_service_id de un objeto 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.

Cómo enviar comentarios sobre las solicitudes de servicio

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

Operaciones no admitidas

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

Operaciones no admitidas
Crear y quitar campañas La API de Google Ads bloquea la creación y eliminación de campañas de Servicios locales independientes (advertising_channel_type = 'LOCAL_SERVICES'). A partir de v26, puedes crear nuevas campañas de máximo rendimiento de Servicios locales (advertising_channel_type = 'PERFORMANCE_MAX') configurando pmax_campaign_settings.local_services_enabled = true. Consulta Cómo crear 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, modificación, eliminación ni recuperación de grupos de anuncios, anuncios ni criterios que no sean los criterios de 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 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 devuelvan datos, debe haber una campaña de Servicios Locales o una campaña de máximo rendimiento de Servicios Locales en la cuenta de cliente que realiza la solicitud. El campo local_services_lead.campaign vincula los registros de clientes potenciales con su campaña asociada (incluidas las campañas de máximo rendimiento con objetivos de pago por solicitud de servicio en las que campaign.advertising_channel_type = 'PERFORMANCE_MAX' y campaign.pmax_campaign_settings.local_services_enabled = true). Para identificar la campaña con la que están afiliados estos recursos, usa la siguiente consulta:

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

Cliente potencial de Servicios Locales

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

El tipo de cliente potencial se define con LocalServicesLeadType. A partir de v26, se admite COUPON para habilitar los tipos de clientes potenciales de cupones en las campañas de Servicios locales y de máximo rendimiento de Servicios locales.

El campo campaign vincula el registro del cliente potencial con su campaña asociada. Además de seleccionar los campos de campaign atribuidos (como campaign.id y campaign.name), puedes filtrar las consultas de clientes potenciales por el nombre del recurso de la campaña (WHERE local_services_lead.campaign = ...) o por el tipo de canal de publicidad (WHERE campaign.advertising_channel_type = ...) para segmentar los clientes potenciales por tipo de campaña.

Los datos de clientes potenciales de Servicios locales se pueden recuperar del recurso local_services_lead. Aquí tienes 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,
  local_services_lead.campaign
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 con un cliente potencial de Servicios Locales

LocalServicesLeadConversation expone los detalles de las conversaciones que se llevaron a cabo como parte de una 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 la conversación se pueden recuperar del recurso local_services_lead_conversation. Este es un ejemplo de una 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 método LocalServicesLeadService.AppendLeadConversation para agregar recursos LocalServicesLeadConversation a un LocalServicesLead.

Limitaciones

  • Para acceder a la URL de la grabación de la llamada, 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 propietaria de la campaña con la que está asociado el cliente potencial.

  • Solicitar todas las conversaciones a la vez puede ser una solicitud que lleve 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 se realizan a nivel de la empresa y no incluyen verificaciones para 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 para ella 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 resolución de la verificación de antecedentes (si corresponde)
  • URL del documento de seguro para ver la información del seguro que ya se envió
  • Motivo del rechazo del seguro (si corresponde)
  • Detalles de la licencia (tipo, número, nombre y apellido)
  • Motivo del rechazo de la licencia (si corresponde)
  • La URL del documento de licencia para ver la imagen de la licencia que ya se envió (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 del artefacto de verificación se pueden recuperar del recurso local_services_verification_artifact. A continuación, se muestra un ejemplo de consulta que recupera datos de todos los artefactos de verificación relacionados con la licencia de 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_override_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 manera programática el estado de las solicitudes de verificación por ubicación geográfica (específicamente, el código de segmentación geográfica) y el ID de categoría de Servicios locales, puedes usar el campo local_services_settings en el recurso customer, que tiene el tipo LocalServicesSettings.

En este campo, se muestra un resumen de alto nivel del estado de las solicitudes de verificación de licencia y seguro por ubicación y categoría. Este es un ejemplo de una 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 sus perfiles de anuncios en nuestros sistemas.

Esta es una consulta de ejemplo 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 los Servicios locales a partir del 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 (campaña de máximo rendimiento de GLS).

Cómo crear campañas de máximo rendimiento de Servicios Locales

A partir de v26, la API de Google Ads admite la creación y la actualización de campañas de máximo rendimiento de Servicios locales. Puedes crear nuevas campañas de máximo rendimiento de Servicios Locales 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 creas una campaña de máximo rendimiento de Servicios locales, se requieren country_code y listing_id en local_services_pmax_campaign_settings. En v24 y v25, la API solo admite actualizaciones para las campañas de máximo rendimiento de Servicios locales existentes creadas en la IU por las cuentas incluidas en la lista de entidades permitidas. Para obtener instrucciones completas sobre cómo configurar los requisitos previos y crear campañas de forma atómica, consulta la guía de campañas de máximo rendimiento para objetivos de pago por solicitud de servicio.

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. Este campo es un booleano inmutable (CREATE ONLY) establecido en true en el momento de la creación de la campaña.

Opciones de configuración

Para las campañas en las que local_services_enabled es true, establece la configuración en el campo local_services_pmax_campaign_settings:

  • listing_id: Es el ID de la ficha del Perfil de Negocio de Google vinculado a la campaña. A partir de v26, este campo es obligatorio y no se puede modificar 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 devuelve un error CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID. Debido a que listing_id está marcado como IMMUTABLE, los intentos de actualizar este campo después de la creación de la campaña fallan con RequestError.IMMUTABLE_FIELD. Los desarrolladores pueden descubrir o verificar los IDs de fichas vinculadas consultando el recurso Asset 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 búsqueda 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. A partir de la versión v26, este campo es obligatorio e inmutable, y se configura una vez durante la creación de la campaña. Es un código de país de dos letras en mayúscula (actualmente, solo se admite US para las campañas de máximo rendimiento de Servicios locales) 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 mensajes LocalServicesPhoneNumber. Si se omite, el número de llamada se establece de forma predeterminada en el número de teléfono de la ficha del Perfil de Negocio de Google vinculado y es obligatorio si la ficha del Perfil de Negocio no tiene un número de teléfono.

Números de teléfono

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

  • phone_number: Es el número de teléfono.
  • country_code: Es el 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 anuncios de Servicios locales (para clientes potenciales de llamadas, predeterminado).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: Es el número de destino que admite SMS (opcional, para las notificaciones vía SMS de solicitudes de servicio por mensaje).
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: Es el número de destino de la cuenta de WhatsApp de un proveedor.