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 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 y los presupuestos de Servicios Locales se pueden recuperar con el método
GoogleAdsService.Search
o
GoogleAdsService.SearchStream
para buscar 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 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:
ManualCpa
configurando el campomanual_cpa
Puedes establecer las ofertas de
ManualCpa
medianteLocalServicesCampaignSettings.category_bids
. Puedes recuperar y configurarLocalServicesCampaignSettings
de campañas de Servicios Locales a través deCampaign.local_services_campaign_settings
.MaximizeConversions
si configuras el campomaximize_conversions
Establecer 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 una AdScheduleInfo
y establécela en el ad_schedule
del CampaignCriterion
que se envía a la API de Google Ads mediante CampaignCriterionService.MutateCampaignCriteria
.
Cómo configurar la segmentación geográfica
Si deseas habilitar la segmentación geográfica para una campaña de Servicios Locales, agrega un LocationInfo
y establécelo en el location
de CampaignCriterion
que se envía a la API de Google Ads con CampaignCriterionService.MutateCampaignCriteria
.
Para obtener más detalles, consulta Segmentación geográfica.
Orienta la app a tipos de servicios específicos
Si deseas habilitar la segmentación para un tipo de servicio específico, agrega un LocalServiceIdInfo
y establécelo en 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 muestran en la siguiente tabla pueden cambiar en versiones futuras de la API de Google Ads.
Operaciones no admitidas | |
---|---|
Cómo crear y quitar campañas | La API de Google Ads bloquea la creación de nuevas campañas de Servicios Locales. |
Operaciones sobre las subentidades de una campaña | La API de Google Ads no permite crear, modificar, quitar ni recuperar grupos de anuncios, anuncios o criterios en las 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 realice la solicitud. Además, 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 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 mensajes o reserva un servicio del anunciante.
Los datos de clientes potenciales de Servicios Locales se pueden recuperar desde el recurso local_services_lead
. A continuación, se muestra 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_details
es nulo silead_status
es igual aWIPED_OUT
. - Los datos de clientes potenciales en los que
category_id
forma parte de una categoría de atención médica no están disponibles.
Conversación con el 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 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 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'
Limitaciones
- Para acceder a la URL de grabación de llamadas, debes ingresar con una dirección de correo electrónico que tenga, como mínimo, 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, 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.id = LEAD_ID
Artefacto de verificación de Servicios Locales
LocalServicesVerificationArtifact
expone los 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 de los empleados. Los datos incluyen lo siguiente:
- 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 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 representa:
- Estado de cada artefacto de verificación
- URL de verificación de antecedentes que se usará para la verificación de antecedentes
- Hora del adjudicación de la verificación de antecedentes (si corresponde)
- URL del documento de seguro para ver la información de seguro ya enviada
- Motivo del rechazo del seguro (si corresponde)
- Detalles de la licencia (tipo, número, nombre y apellidos)
- Motivo del rechazo de la licencia (si corresponde)
- URL del documento de licencia para ver la imagen de 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 del artefacto de verificación se pueden recuperar desde el recurso local_services_verification_artifact
. A continuación, se incluye una consulta de ejemplo 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 manera 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 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. Esta es 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 a su perfil de anuncio a nuestros sistemas.
A continuación, se incluye 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