• Ir al menú principal
• Ir al contenido

Base de Conocimiento

Servicios del API de datos v2 de Urchin

Visión general

El API de datos v1 de Urchin ofrece funciones básicas de minería de datos: parámetros y métricas globales, tablas personalizadas, totales y datos sobre visitantes y transacciones. Junto a la clasificación y la paginación, introduce expresiones regulares básicas y filtros numéricos.

El API de datos v2 de Urchin amplía considerablemente los mecanismos de análisis con la introducción de la segmentación de visitas, rutas y transacciones. Ahora, es posible especificar hasta 50 filtros de cada tipo para cada consulta y obtener datos muy valiosos de la base de datos de informes.

Introducción a los servicios web del API de datos v2 de Urchin

Urchin 7.0 incluye las versiones 1 y 2 del API de datos. Aunque la versión 2 es la predeterminada, es posible pasar a la versión 1 del API fácilmente. Para ello, debe configurarse DataApiVersion? en 1 en <urchin_home>/etc/urchin.conf.

Ubicación de WSDL:

AdminService:  http://your_host:your_port/services/v2/adminservice?wsdl
ReportService: http://your_host:your_port/services/v2/reportservice?wsdl   

Identificadores URI de los métodos REST:

AdminService: http://your_host:your_port/services/v2/adminservice
ReportService:http://your_host:your_port/services/v2/reportservice

El explorador de servicios REST también se encuentra en http://your_host:your_port/uapi.html

El Servicio de informes permite extraer la información siguiente:

• Parámetros y métricas globales: tablas 1 a 43
• Tablas personalizadas: tablas definidas por el usuario de <urchin_home>/lib/custom folder
• Parámetros y métricas relacionados con las visitas: tabla 256
• Parámetros y métricas relacionados con las transacciones: tabla 257
• Parámetros y métricas relacionados con las páginas: tabla 259
• Totales y métricas de un periodo de tiempo: tabla 258

Referencia del API de datos v2

Servicio de administrador (v2)

El Servicio de administrador ofrece operaciones para obtener información de la cuenta y del perfil.

Ubicación de WSDL: http://your_host:your_port/services/v2/adminservice?wsdl

Este servicio incluye los métodos siguientes:

• getAccountList: este método no se ha modificado y funciona igual que en la versión 1. Para obtener más información al respecto, consulte el artículo | API de datos?].
• getProfileList: este método no se ha modificado y funciona igual que en la versión 1. Para obtener más información al respecto, consulte el artículo | API de datos?].

Servicio de informes (v2)

El Servicio de informes permite extraer datos y generar informes de Urchin.

Ubicación de WSDL: http://your_host:your_port/services/v2/reportservice?wsdl

Este servicio incluye los métodos siguientes:

• getTableList: este método se ha ampliado con los campos nuevos "nregexfilters" y "nnumericfilters".

Ejemplo de respuesta:

<tns:getTableListResponse xmlns:tns="https://urchin.com/api/urchin/v2/">
<table>
<tableId>257</tableId>
<dimensions>
  <dimension>u:transaction_id</dimension>
  ...


</dimensions>
<metrics>
  <metric>u:transactions</metric>
  ...
</metrics>
<nregexfilters>50</nregexfilters>

<nnumericfilters>50</nnumericfilters>
</table>
</tns:getTableListResponse>

Esta respuesta muestra que la tabla 257 de Urchin puede filtrarse con 50 filtros numéricos y 50 filtros de expresiones regulares. Para obtener más información al respecto, consulte el artículo de ayuda API de datos.

• getData: a partir de la versión 2, este método es totalmente compatible con los filtros numéricos y de expresiones regulares. Para obtener más información al respecto, consulte el artículo de ayuda API de datos.

Filtros

• tablas 1 a 43: contienen parámetros y métricas globales, y solo permiten utilizar filtros por parámetros y métricas de la tabla consultada.
• tabla 256: contiene todos los datos de las visitas y permite utilizar filtros por parámetros de visitas, transacciones y rutas de las tablas 256, 257 y 258, y métricas de visitas de la tabla 256.
• tabla 257: contiene todos los datos de las visitas y las transacciones, y permite utilizar filtros por parámetros de visitas, transacciones y rutas de las tablas 256, 257 y 258, y métricas de transacciones de la tabla 257.
• tabla 256: contiene todos los datos de las visitas y permite utilizar filtros por parámetros de visitas, transacciones y rutas de las tablas 256, 257 y 258, y métricas de visitas de la tabla 256.
• tabla 259: contiene todos los datos de las páginas y las visitas, y permite utilizar filtros por parámetros de visitas, transacciones y rutas de las tablas 256, 257 y 258, y métricas de páginas de la tabla 259.

Nota: para ver todos los parámetros y las métricas de estas tablas, debe extraer la información a través del método "getTableList" del Servicio de informes, o bien utilizar el explorador de servicios, que encontrará en http://your_host:your_port/uapi.html.

Por ejemplo: extraiga los datos de las visitas mediante la solicitud REST.

Ejemplo de solicitud REST:

http://<urchin host>:<port>/services/v2/reportservice/data?login=admin&password=urchin&ids=7&start-date=2008-01-01&end-date=2010-01-01
&dimensions=u:session_id,u:visitor_id,u:session_ip,u:session_start_time,u:session_end_time&metrics=u:pages,u:visits&table=256

Ejemplo de respuesta REST:

<tns:getDataResponse xmlns:tns="https://urchin.com/api/urchin/v2/">
<record>

  <recordId>1</recordId> 
<dimensions>
  <dimension name="u:session_id">1262784738</dimension> 
  <dimension name="u:visitor_id">HWH2-C43FX-GSPE</dimension> 
  <dimension name="u:session_ip">10.6.28.81</dimension> 
  <dimension name="u:session_start_time">2010-01-06T07:32:37-08:00</dimension> 
  <dimension name="u:session_end_time">2010-01-06T07:32:49-08:00</dimension> 


</dimensions>
<metrics>
  <u:pages xmlns:u="https://urchin.com/api/urchin/v2/">1</u:pages> 
  <u:visits xmlns:u="https://urchin.com/api/urchin/v2/">1</u:visits> 
</metrics>

</record>

</tns:getDataResponse>

Ejemplos de consulta

Obtener las visitas de yahoo.com en las que se han consultado varias páginas y ordenarlas por ID de visitante:

http://<urchin host>:<port>/services/v2/reportservice/data?login=admin&password=urchin&ids=7&start-date=2008-01-01&end-date=2010-01-01
&dimensions=u:visitor_id,u:session_ip,u:utm_campaign&metrics=u:pages,u:visits,u:transactions&sort=u:visitor_id&filters=u:utm_source%3D~yahoo,u:pages%3E1&table=256

Obtener los visitantes de google.com y el número de reservas que han realizado:

http://<urchin host>:<port>/services/v2/reportservice/data?login=admin&password=urchin&ids=7&start-date=2008-01-01&end-date=2010-01-01


&dimensions=u:visitor_id&metrics=u:pages,u:visits,u:transactions&filters=u:utm_source%3D~google,u:request_stem%3D~cart.html&table=256

Obtener todas las transacciones resultantes de las búsquedas realizadas en bing.com durante un trimestre concreto:

http://<urchin host>:<port>/services/v2/reportservice/data?login=admin&password=urchin&ids=7&start-date=2008-01-01&end-date=2010-01-01
&dimensions=u:transaction_id&metrics=u:transactions,u:revenue,u:tax,u:shipping,u:items&filters=u:utm_source%3D~msn,u:utm_term%3D~schwag&table=257

Obtener las métricas diarias correspondientes a un periodo concreto:

http://<urchin host>:<port>/services/v2/reportservice/data?login=admin&password=urchin&ids=7&start-date=2008-01-01&end-date=2010-01-01


&dimensions=u:day&metrics=u:pages,u:visits&table=258

Obtener todas las páginas que ha visitado un usuario concreto durante un periodo de tiempo:

http://<urchin host>:<port>/services/v2/reportservice/data?login=admin&password=urchin&ids=7&start-date=2008-01-01&end-date=2010-01-01
&dimensions=u:request_stem&metrics=u:pages&filters=u:visitor_id%3D~N8T3-DU4N9-7RPL&table=259

Cómo habilitar la versión antigua del API de datos de Urchin en Urchin 7.0

De forma predeterminada, las versiones de Urchin 7.0 acabadas de instalar o de actualizar utilizan la versión más reciente del API de datos. Para cambiarla por otra versión, consulte la sección "¿Cómo se cambia la versión del API de datos de Urchin?" del artículo Preguntas frecuentes sobre el API de datos de Urchin.

Se ha visto este articulo:0 veces
Ultima modificacion:2010-08-25 10:11:29