Informes

Los informes te permiten recuperar información sobre el rendimiento de los anuncios y los clientes potenciales de tus cuentas vinculadas.

Informes de la cuenta

Los informes de la cuenta muestran el rendimiento y las métricas asociados con las cuentas de Servicios Locales vinculadas de una cuenta de administrador. Puedes ver estos datos durante un período específico. Es posible que los datos estén desactualizados hasta por 30 minutos.

Para obtener el informe, envía una solicitud HTTP GET a https://localservices.googleapis.com/v1/accountReports:search con los siguientes parámetros de URL configurables:

Parámetros de URL
query	Obligatorio Contiene uno o más valores de ID, uno de los cuales debe ser el ID de la cuenta de administrador para la búsqueda. query puede aceptar varios valores separados por punto y coma: Obligatorio: manager_customer_id:<manager_cid> Opcional: customer_id:<linked_cid> Ejemplo: query=manager_customer_id:123;customer_id:456
startDate.day	Opcional Día del mes en que comienza el período del informe. Puede tomar valores entre 1 y 31, inclusive. El valor predeterminado es 1.
startDate.month	Opcional Es el mes de inicio del período del informe. Puede tomar valores entre 1 y 12, inclusive. El valor predeterminado es el mes actual.
startDate.year	Opcional Año en el que comienza el período del informe, en formato YYYY. El valor predeterminado es el año actual.
endDate.day	Opcional Día del mes en que finaliza el período del informe. Puede tomar valores entre 1 y 31, inclusive. El valor predeterminado es el día actual.
endDate.month	Opcional Mes en el que finaliza el período del informe. Puede tomar valores entre 1 y 12, inclusive. El valor predeterminado es el mes actual.
endDate.year	Opcional Año en que finaliza el período del informe, en formato YYYY. El valor predeterminado es el año actual.
pageSize	Opcional Es un número entero positivo que indica la cantidad de entradas que se devolverán. El valor predeterminado es 1000 y el máximo es 10000.
pageToken	Opcional Una string. Ingresa el next_page_token de la respuesta anterior en este campo.

Los campos de la tabla anterior se usan para construir un SearchAccountReportsRequest. Para cada ID de cliente en la solicitud, se incluye un objeto AccountReports correspondiente en SearchAccountReportsResponse. Cada informe de la cuenta se correlaciona de forma individual con una cuenta de cliente vinculada que muestra anuncios de Servicios Locales.

Nota: Los protos para la solicitud, la respuesta y las estructuras de datos están disponibles y vinculados después del lanzamiento.

En la siguiente tabla, se muestran los campos de AccountReports:

Campos
accountId	Es el ID de cliente vinculado a una cuenta de Servicios Locales.
businessName	Nombre de la empresa del cliente.
averageWeeklyBudget	Es el presupuesto semanal promedio actual del cliente.
averageFiveStarRating	Calificación promedio de cinco estrellas, que se calcula a partir de todas las opiniones disponibles del cliente.
totalReview	Es la cantidad total de opiniones disponibles para el cliente.
impressionsLastTwoDays	Es la cantidad total de impresiones que tuvo la cuenta en los últimos dos días.
phoneLeadResponsiveness	Es la capacidad de respuesta de los clientes potenciales telefónicos de la cuenta durante los últimos 90 días. Para calcularlo, se divide la cantidad total de llamadas conectadas de clientes potenciales telefónicos facturados entre la cantidad total de llamadas recibidas.
currentPeriodChargedLeads	Es la cantidad de clientes potenciales pagados en el período del intervalo de fechas especificado.
previousPeriodChargedLeads	Es la cantidad de clientes potenciales pagados en el período anterior. Por ejemplo, si el período se establece del 21 al 30 de enero, el período anterior sería del 11 al 20 de enero.
currentPeriodTotalCost	Es la suma del costo de los clientes potenciales facturados en el período especificado.
previousPeriodTotalCost	Es la suma del costo de los clientes potenciales cobrados en el período anterior. Por ejemplo, si el período se establece del 21 al 30 de enero, el período anterior sería del 11 al 20 de enero.
currencyCode	Es el código de moneda de la cuenta del cliente.
currentPeriodPhoneCalls	Cantidad de llamadas telefónicas en el período del rango de fechas especificado, tanto conectadas como no conectadas.
previousPeriodPhoneCalls	Cantidad de llamadas telefónicas en el período anterior, tanto conectadas como no conectadas.
currentPeriodConnectedPhoneCalls	Cantidad de llamadas telefónicas conectadas en el período del rango de fechas especificado con una duración superior a 30 segundos.
previousPeriodConnectedPhoneCalls	Cantidad de llamadas telefónicas conectadas en el período anterior con una duración superior a 30 segundos.

Ejemplos

URL de solicitud HTTP

https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:{manager_customer_id}

Ejemplo de solicitud HTTP completa

GET /v1/accountReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]

Informes detallados de clientes potenciales

Importante: Los informes de clientes potenciales detallados están obsoletos. Usa la API de Google Ads para recuperar los clientes potenciales y las conversaciones asociados con tus cuentas de Servicios Locales.

Los informes de clientes potenciales detallados muestran una vista en profundidad de los clientes potenciales asociados con las cuentas de Servicios Locales vinculadas de una cuenta de administrador. Puedes ver estos datos durante un período específico. Para un período determinado, el informe incluye los clientes potenciales creados o aquellos cuyo estado de disputa se actualizó. Es posible que los datos estén desactualizados hasta por 30 minutos.

Nota: Los clientes de la API solo pueden solicitar informes detallados de clientes potenciales para un período de hasta 31 días. Esto se debe a la gran cantidad de clientes potenciales que puede mostrar el informe.

Para obtener el informe, envía una solicitud HTTP GET a https://localservices.googleapis.com/v1/detailedLeadReports:search con los siguientes parámetros de URL configurables:

Parámetros de URL
query	Obligatorio Contiene uno o más valores de ID, uno de los cuales debe ser el ID de la cuenta de administrador para la búsqueda. query puede aceptar varios valores separados por punto y coma: Obligatorio: manager_customer_id:<manager_cid> Opcional: customer_id:<linked_cid> Ejemplo: query=manager_customer_id:123;customer_id:456
startDate.day	Opcional Día del mes en que comienza el período del informe. Puede tomar valores entre 1 y 31, inclusive. El valor predeterminado es 1.
startDate.month	Opcional Es el mes de inicio del período del informe. Puede tomar valores entre 1 y 12, inclusive. El valor predeterminado es el mes actual.
startDate.year	Opcional Año en el que comienza el período del informe, en formato YYYY. El valor predeterminado es el año actual.
endDate.day	Opcional Día del mes en que finaliza el período del informe. Puede tomar valores entre 1 y 31, inclusive. El valor predeterminado es el día actual.
endDate.month	Opcional Mes en el que finaliza el período del informe. Puede tomar valores entre 1 y 12, inclusive. El valor predeterminado es el mes actual.
endDate.year	Opcional Año en que finaliza el período del informe, en formato YYYY. El valor predeterminado es el año actual.
pageSize	Opcional Es un número entero positivo que indica la cantidad de entradas que se devolverán. El valor predeterminado es 1000 y el máximo es 10000.
pageToken	Opcional Una string. Ingresa el next_page_token de la respuesta anterior en este campo.

Los campos anteriores se usan para construir un SearchDetailedLeadReportsRequest. Para cada ID de cliente en la solicitud, se incluye un DetailedLeadReports correspondiente en SearchDetailedLeadReportsResponse. Cada Informe de clientes potenciales detallado se correlaciona de forma individual con un cliente potencial específico asociado a una cuenta de cliente vinculada que muestra anuncios de Servicios locales.

En la siguiente tabla, se muestran los campos de DetailedLeadReports:

Campos
leadId	Es el identificador único de un cliente potencial.
accountId	Identifica la cuenta que recibió el cliente potencial.
businessName	Es el nombre de la empresa asociado a la cuenta.
leadCreationTimestamp	Es la marca de tiempo de cuando se creó el cliente potencial. Incluye la fecha en formato M/D/YYYY y la hora en formato HH:MM:SS. Ejemplo: 11/1/2019 12:13:20
leadType	Tipo de cliente potencial: MESSAGE o PHONE_CALL.
leadCategory	Es la categoría de servicio asociada al cliente potencial. Ejemplo: housecleaner
geo	Ubicaciones de la ciudad de origen de la cuenta asociada. Ejemplo: San Francisco, California, United States
messageLead	Información asociada solo con los clientes potenciales de mensajes: customerName, jobType, postalCode y consumerPhoneNumber.
phoneLead	Información asociada solo con los clientes potenciales telefónicos: chargedCallTimestamp, chargedConnectedCallDurationSeconds y consumerPhoneNumber.
bookingLead	Información asociada solo con las oportunidades de negocios de reserva: customerName, consumerPhoneNumber, jobType, consumerEmail y bookingAppointmentTimestamp.
chargeStatus	Indica si se cobró el cliente potencial. Puede ser true o false.
currencyCode	Es el código de moneda de la cuenta para la que se creó el cliente potencial.
disputeStatus	Es el estado de la disputa del cliente potencial.
aggregatorInfo	Es información específica para los socios agregadores externos. Este campo solo se propaga para los clientes de la API que están asociados con socios agregadores externos. Nota: Esto no se aplica a los clientes estándar de Mi centro de clientes (MCC).
timezone	Es la zona horaria de la cuenta asociada con el cliente potencial. Se proporciona en el formato de la base de datos de zonas horarias de IANA.

Ejemplos

URL de solicitud HTTP

https://localservices.googleapis.com/v1/detailedLeadReports:search?query=manager_customer_id:{manager_customer_id}

Ejemplo de solicitud HTTP completa

GET /v1/detailedReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]