Synup
Crear clave
v1Recursos/Análisis de perfil/getObtener el informe de embudo

Obtener el informe de embudo

El informe de embudo completo de la página Informes: qué hicieron las personas después de encontrar a sus clientes, por canal (Business Profile, sitio web, búsqueda de Google, redes sociales e invitaciones a reseñas), en las últimas 4 o 12 semanas completas frente al mismo número de semanas anteriores. También devuelve reseñas nuevas, acciones en todos los canales, una clasificación por cliente y desgloses ordenados. Cada cifra proviene de una plataforma, y null significa no informado o historial insuficiente, nunca cero.

get/api/v1/analytics/funnel
analytics:read
Parámetros de consulta
clientIdstringopcional
Limita a un cliente. Omítalo para informar sobre todos los clientes que su clave puede leer.
weeksinteger (4 | 12)opcional
Cuántas semanas completas abarca el período: 4 o 12. Por defecto, 12.
Respuesta
dataobjectopcional
weeksinteger (4 | 12)opcional
periodobjectopcional
El período del informe, de lunes a domingo, como fechas YYYY-MM-DD.
startstringopcional
endstringopcional
previousPeriodobjectopcional
startstringopcional
endstringopcional
weekStartsarray of stringopcional
scopeobjectopcional
clientIdstringopcional
clientNamestringopcional
clientsnumberopcional
foodbooleanopcional
channelsarray of objectopcional
keystring (profile | website | search | social | invites)opcional
El canal: profile, website, search, social o invites.
periodobjectopcional
El período propio de este canal, de lunes a domingo, presente cuando termina antes que el del informe (los datos de Search Console van con retraso).
startstringopcional
endstringopcional
availablebooleanopcional
Si este canal tiene cifras que mostrar.
reasonstring (not_connected | no_data | denied)opcional
Por qué el canal no tiene cifras: not_connected (ningún cliente del alcance tiene la fuente conectada), no_data (conectada, pero aún sin datos en el período) o denied (su acceso no incluye este canal).
coverageobjectopcional
Qué clientes cubren las cifras del canal: clientes que lo informan (clients), de los clientes del alcance (of), cuántos necesitan reconectarse (reconnect), cuántos quedan fuera de la variación (leftOut), la última semana con datos (through) y las plataformas detrás de las cifras (providers).
clientsnumberopcional
ofnumberopcional
reconnectnumberopcional
leftOutnumberopcional
throughstringopcional
providersarray of stringopcional
metricsarray of objectopcional
keystringopcional
La métrica, por ejemplo profileViews, visits o searchClicks.
currentnumberopcional
El total de este período en todos los clientes que informan. Null cuando nadie lo informó.
previousnumberopcional
El total del período anterior en clientes comparables. Null cuando no hay suficiente historial.
changenumberopcional
Variación frente al período anterior en clientes comparables (0.12 = +12 %). Null cuando previous es null o 0.
seriesarray of numberopcional
Los valores de este período, uno por semana, del más antiguo al más reciente. Null en una semana que nadie informó.
rateBasenumberopcional
El denominador de la tasa de este paso cuando no es el valor del paso anterior. Por ejemplo, los eventos clave del sitio web solo vienen de GA4, así que su tasa se calcula solo sobre las visitas de GA4.
reviewsobjectopcional
Reseñas públicas nuevas del período: cantidad, variación, serie semanal, valoración promedio, respuestas y distribución de estrellas.
availablebooleanopcional
reasonstringopcional
currentnumberopcional
previousnumberopcional
changenumberopcional
seriesarray of numberopcional
avgRatingnumberopcional
previousAvgRatingnumberopcional
repliednumberopcional
starsarray of numberopcional
actionsobjectopcional
Acciones en Business Profile, sitio web, redes sociales e invitaciones a reseñas, contadas por acción, no por persona. No incluye los clics de la búsqueda de Google: ya están en las visitas al sitio web.
currentnumberopcional
previousnumberopcional
changenumberopcional
seriesarray of numberopcional
excludedFromChangearray of stringopcional
byClientarray of objectopcional
Una fila por cada cliente con alguna cifra, para clasificar a los clientes. Vacío en un informe de un solo cliente.
clientIdstringopcional
publicIdstringopcional
namestringopcional
actionsnumberopcional
previousnumberopcional
changenumberopcional
topChannelstringopcional
channelsarray of stringopcional
detailsarray of objectopcional
keystring (listingPlatforms | websiteSources | landingPages | goals | events | queries | searchPages | socialPlatforms | reviewPlatforms)opcional
availablebooleanopcional
totalnumberopcional
providersarray of stringopcional
rowsarray of objectopcional
keystringopcional
valuesobjectopcional
kindstringopcional
countedbooleanopcional
providerstringopcional
notRankedbooleanopcional
lastSyncedAtstringopcional
generatedAtstringopcional
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/analytics/funnel
Su clave de API
clientId
weeks
{}

Guías que usan este recurso