Saltar al contenido principal

Webservices relacionados con Goals

Las "Goals" de Actito permiten identificar a las personas que visitan su sitio web y obtener información sobre su comportamiento en el sitio: visitas a páginas o confirmaciones de pedidos.

Cuando un perfil alcanza una meta, Actito registra una interacción entre la meta y ese perfil. Además de servir como estadísticas, las Goals se pueden utilizar para dirigirse a perfiles, agregarlos a un segmento o activar comunicaciones.

La creación de una meta no es posible a través de la API. Debe hacerse obligatoriamente a través de la interfaz de Actito. Además, se requiere una manipulación en su sitio web, en las páginas a las que apunta la meta. Para obtener más información al respecto, consulte el capítulo dedicado a las "Goals"

Sin embargo, los webservices relacionados con las goals le permitirán:

Registrar goals a través de un sistema externo

La forma principal de registrar goals se debe a la interacción entre el script insertado en sus páginas web y la cookie generada cuando un perfil hace clic en un enlace presente en un correo electrónico de Actito para el cual el seguimiento de goals está activado.

Esto implica que las goals solo puedan ser alcanzadas por perfiles que ya hayan recibido y hecho clic en un correo electrónico de Actito. Sin embargo, gracias a la mayor conectividad permitida por los webservices de Actito, tiene la posibilidad de registrar interacciones de goals para un perfil que haya alcanzado esta meta a través de un sistema externo.

Tienes dos opciones para hacerlo:

  • Generar tú mismo la cookie obteniendo el actId de un perfil
  • Crear una interacción de objetivo transaccional a través de la API

Obtener el actId de un perfil

El concepto de actId se refiere al identificador único que vincula un perfil con un objetivo. Se almacena en una cookie en el navegador del usuario y su interacción con el script insertado en tus páginas web permite el correcto funcionamiento de los objetivos.

Esta cookie suele ser transmitida a través de un correo electrónico de Actito. Sin embargo, con el fin de establecer una conexión entre Actito y las diferentes plataformas asociadas o tus propios sistemas, puedes crear tú mismo esta cookie y depositarla de la manera más adecuada según tu actividad (por ejemplo, al iniciar sesión en un área de cliente). Esta alternativa te permitirá registrar objetivos para perfiles que aún no han hecho clic en un correo electrónico de Actito.

Para crear esta cookie, es necesario poder obtener el identificador actId para cada perfil. Esto es posible mediante la operación GET/entity/{e}/goal/table/{t}/profile/{p}

La respuesta a esta solicitud será el actId del perfil objetivo. Es una cadena de caracteres que corresponde a un perfil en una base de datos y que se puede utilizar para generar la cookie de objetivo desde tu lado.

Crear una interacción de objetivo transaccional

Es posible crear una interacción de objetivo transaccional para un perfil específico mediante la operación POST/entity/{e}/goals/{g}/profile/{p}/transaction

Esto te permite registrar un objetivo transaccional sin importar la fuente que haya generado esta transacción.

Los parámetros que debes proporcionar en el cuerpo de la llamada para crear una interacción de objetivo transaccional son:

  • amountCent: El monto de la transacción en centavos. En la interfaz de Actito, este monto se convertirá a €.

  • businessId: La clave de identificación de la transacción.

  • comment: Un comentario que acompaña la transacción. Puedes definir lo que deseas mostrar en este campo.

  • source: La fuente de la transacción. En el caso de la creación de una API, este campo se puede configurar para indicar el origen de la transacción.

Crear una interacción de objetivo de visita al sitio web

También es posible crear una interacción de objetivo de visita al sitio web para rastrear perfiles que han visitado una página en tu sitio web.

Esto se puede hacer utilizando la operación POST/entity/{e}/goals/{g}/profile/{p}/websitevisit.

En el cuerpo JSON, el parámetro matchedUrl corresponde a la URL de la página visitada por el perfil. Esto debe ser una URL definida en la definición del objetivo en Actito.