Las campañas de Servicios Locales te permiten promocionar tu empresa en Google y recibir clientes potenciales directamente de los clientes potenciales. En esta guía, se resumen las operaciones y las restricciones admitidas en la versión actual de la API de Google Ads.
Operaciones admitidas
Recupera las campañas y los presupuestos de Servicios locales.
Las campañas de Servicios Locales y los presupuestos se pueden recuperar con el método GoogleAdsService.Search
o GoogleAdsService.SearchStream
para consultar los recursos de la campaña 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 amount_micros
del presupuesto de la campaña asociado.
Establece la estrategia de ofertas para 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:
ManualCpa
estableciendo el campomanual_cpa
Puedes establecer las ofertas de
ManualCpa
medianteLocalServicesCampaignSettings.category_bids
. Puedes recuperar y configurar elLocalServicesCampaignSettings
de las campañas de Servicios Locales a través deCampaign.local_services_campaign_settings
.MaximizeConversions
estableciendo el campomaximize_conversions
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 criterio de campaña.
Crea un AdScheduleInfo
y configúralo como el ad_schedule
de la CampaignCriterion
que se envía a la API de Google Ads con CampaignCriterionService.MutateCampaignCriteria
.
Establecer la segmentación geográfica
Si deseas habilitar la segmentación geográfica para una campaña de Servicios Locales, agrega un LocationInfo
y configúralo como location
del CampaignCriterion
que se envía a la API de Google Ads con CampaignCriterionService.MutateCampaignCriteria
.
Para obtener más información, consulta Segmentación geográfica.
Tipos de servicios específicos como destino
Para habilitar la segmentación de un tipo de servicio específico, agrega un LocalServiceIdInfo
y configúralo con el tipo de servicio.
Debes usar un ID de servicio que coincida con la ubicación y la categoría de segmentación de tu campaña.
Operaciones no admitidas
Las restricciones que se enumeran 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 nuevas campañas de Servicios Locales. |
Operaciones sobre subentidades en 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 campañas de Servicios Locales. |
Recursos de Servicios Locales
A partir de la versión 15 de la API de Google Ads, 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_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
Para que estos recursos muestren datos, debe haber una campaña de Servicios Locales en la cuenta de cliente que realiza la solicitud. Además, 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 a la que están afiliados estos recursos, usa la siguiente consulta:
SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
Líder 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 desde el recurso local_services_lead
. Aquí hay 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 silead_status
es igual aWIPED_OUT
. - Los datos de clientes potenciales para los que el
category_id
forma parte de una categoría de atención médica no están disponibles.
Conversación del cliente potencial de Servicios Locales
El objeto LocalServicesLeadConversation
expone los detalles de las conversaciones que se desarrollaron 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 desde el recurso local_services_lead_conversation
. A continuación, se incluye una consulta de ejemplo que filtra los resultados de 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'
A partir de la versión 17 de la API de Google Ads, puedes usar el método LocalServicesLeadService.AppendLeadConversation
para agregar recursos LocalServicesLeadConversation
a un LocalServicesLead
.
Limitaciones
- Para ingresar a la URL de grabación de llamadas, debes ingresar 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 llevar mucho tiempo, por lo que debes filtrar las conversaciones por cliente potencial, como se muestra a continuación:
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.id = LEAD_ID
Artefacto de verificación de Servicios Locales
LocalServicesVerificationArtifact
expone datos de verificación para las empresas de los anunciantes. Ten en cuenta que estas verificaciones se realizan a nivel de la empresa y no incluyen las verificaciones para empleados. Entre los datos, se incluyen los siguientes:
- Verificaciones de licencias
- Verificaciones de seguros
- Verificaciones de antecedentes
- Verificaciones del registro comercial
Cada vez que se envía una solicitud de verificación a 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 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 utilizará para llevar a cabo este proceso
- Hora de adjudicación de la verificación de antecedentes (si corresponde)
- URL del documento de 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 que ya se envió (si corresponde)
- Detalles de registro de la empresa (ID del cheque, número de registro)
- Motivo del rechazo del registro comercial (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 desde el recurso local_services_verification_artifact
. A continuación, se muestra una consulta de ejemplo que recupera datos para todos los artefactos de verificación relacionados con licencias 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 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 un campo nuevo en el recurso customer
, llamado LocalServicesSetting
.
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. A continuación, se muestra una consulta de ejemplo 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 su perfil de anuncios en nuestros sistemas.
Esta es una consulta de ejemplo que recupera datos de todos los empleados del servicio local 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