Las campañas de Servicios locales te permiten promocionar tu empresa en Google y recibir oportunidades comerciales directamente de los clientes potenciales. En esta guía, se resumen las operaciones y restricciones admitidas en la versión actual de 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 los Servicios Locales se pueden recuperar con el método GoogleAdsService.Search o GoogleAdsService.SearchStream para consultar los recursos Campaign donde 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 campañas de Servicios Locales
Puedes actualizar los campos status de la campaña y amount_micros del presupuesto asociado.
Cómo establecer la estrategia de ofertas de las campañas de Servicios Locales
Puedes establecer las siguientes estrategias de ofertas como la estrategia de ofertas estándar de las campañas de Servicios Locales:
ManualCpaconfigurando el campomanual_cpaPuedes establecer las ofertas de
ManualCpaa través deLocalServicesCampaignSettings.category_bids. Puedes recuperar y establecer elLocalServicesCampaignSettingsde las campañas de Servicios Locales a través deCampaign.local_services_campaign_settings.MaximizeConversionsconfigurando el campomaximize_conversions
Cómo establecer una programación de anuncios como criterio de la campaña
Puedes establecer un programa de anuncios para una campaña de Servicios Locales como criterio de la campaña.
Crea un AdScheduleInfo y configúralo como el ad_schedule del CampaignCriterion que se envía a la API de Google Ads con CampaignCriterionService.MutateCampaignCriteria.
Cómo establecer la segmentación geográfica
Para habilitar la segmentación geográfica en una campaña de Servicios Locales, agrega un LocationInfo y configúralo 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 por ubicación.
Segmenta tus anuncios para tipos de servicios 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 la segmentación de tu campaña.
Envía comentarios sobre las solicitudes de servicio
Usa el método ProvideLeadFeedback de LocalServicesLeadService para enviar calificaciones y comentarios sobre un cliente potencial. También puedes inspeccionar el campo lead_feedback_submitted del objeto LocalServicesLead para determinar si se calificó un cliente potencial y se envió comentarios.
Operaciones no admitidas
Las restricciones que se indican en la siguiente tabla pueden cambiar en versiones futuras de la API de Google Ads.
| Operaciones no admitidas | |
|---|---|
| Crear y quitar campañas | La API de Google Ads bloquea la creación de campañas nuevas de Servicios Locales. |
| Operaciones en entidades secundarias de una campaña | La API de Google Ads no admite la creación, modificación, eliminación ni recuperación de grupos de anuncios, anuncios o criterios en las campañas de Servicios Locales. |
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:
local_services_leadlocal_services_lead_conversationlocal_services_verification_artifactlocal_services_employee
Para que estos recursos devuelvan datos, debe haber una campaña de Servicios Locales en la cuenta del cliente que realiza la solicitud. Dado que 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 se asocian 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 un mensaje o reserva un servicio del anunciante.
Los datos de clientes potenciales de Servicios Locales se pueden recuperar del recurso local_services_lead. Esta es una consulta de ejemplo:
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_detailses nulo silead_statuses igual aWIPED_OUT. - A partir de
v25, se quitaráContactDetails.emailyContactDetails.phone_number_extensionestará disponible en el mensajeContactDetailsque devuelvelocal_services_lead.contact_details. - No están disponibles los datos de los clientes potenciales en los que
category_idforma parte de una categoría de atención médica.
Conversación de cliente potencial de Servicios Locales
LocalServicesLeadConversation
expone los detalles de las conversaciones que tuvieron lugar 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 conversación se pueden recuperar del recurso local_services_lead_conversation. Este es un ejemplo de una búsqueda 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 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 se asocia la solicitud de servicio.
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'
Artefacto de verificación de Servicios Locales
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 las de los empleados. Los datos incluyen lo siguiente:
- Verificaciones de licencias
- Verificaciones de seguros
- Verificaciones de antecedentes
- Verificaciones de registro comercial
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 resolució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, nombre y apellido)
- Motivo del rechazo de la licencia (si corresponde)
- URL del documento de licencia para ver la imagen de la licencia ya enviada (si corresponde)
- Detalles del registro de empresa (verificación de ID, número de registro)
- Motivo del rechazo del registro de la empresa (si corresponde)
- URL del documento de registro de empresa para ver la imagen del registro ya enviado (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_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 geográficos y categóricos de licencias y seguros
Para determinar de forma 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 expone un resumen de alto nivel del estado de las solicitudes de verificación de licencias y seguros por ubicación y categoría. Aquí tienes 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 servicio local
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 la configuración relacionada con los Servicios Locales a partir del v24. Estos parámetros de configuración te permiten identificar y configurar una campaña de máximo rendimiento que publica anuncios de Servicios Locales (campaña de máximo rendimiento de GLS).
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, consulta el campo de solo lectura local_services_enabled en la 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 campo local_services_pmax_campaign_settings:
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. Este campo es inmutable y se establece una sola vez durante la creación del anuncio. Es un código de país de dos letras en mayúsculas que se usa para determinar los requisitos de verificación y validar la selección del criterio de ubicación.phone_numbers: Es una lista de números de teléfono asociados con el proveedor, representados por mensajes deLocalServicesPhoneNumber.
Números de teléfono
Cada entrada del 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 en mayúsculas y de dos letras.phone_number_type: Es el tipo de número de teléfono, definido porGlsPhoneNumberTypeEnum.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.