Envío de eventos a la API de eventos de Driftrock

Aprenda a enviar eventos a Driftrock a través de la API de eventos de Driftrock

Creación de la solicitud POST

Puede realizar solicitudes POST a estas URL:

Si está enviando a una captura Driftrock Webhook por favor utilice https://external-apis.driftrock.com/v2/event

Si está enviando a una captura de afiliado Driftrock por favor utilice https://external-apis.driftrock.com/v2/affiliate_event

Si no está seguro de cuál utilizar, póngase en contacto con su CSM o con nuestro equipo de asistencia.

Cabeceras:

Content-Type: application/json
Accept: application/json
Authorization: Portador xxxx-xxxx-xxxx-xxxx

donde xxxx-xxxx-xxxx-xxxx es una clave api que puedes obtener yendo a Configuración -> Seguridad. Puede utilizar una clave creada previamente o crear una nueva.

Cuerpo:
El cuerpo debe tener formato JSON y contener los campos obligatorios o recomendados:

  • event_type [string] ( obligatorio): debe ser lead, conversion o action.
  • event_name [string] ( required) : díganos qué etiqueta le gustaría asignar a este evento (ej: Usuario registrado, Vista de página, Compra )
  • source_id [cadena] (obligatorio): es necesario para vincular el evento a la captura que ha creado. Puede encontrarlo en el paso 'Conectar' (paso 2) de su captura
  • fields [json]  (required) : this is a json field, where you send us the attributes of this event (eg: "fields": {"email": "test@driftrock.com", "question_1": "test answer"} )
  • event_id [string] (opcional): puede ser cualquier ID que se utilice en su sistema para identificar de forma exclusiva este evento. Tenga en cuenta que si envía dos eventos con el mismo event_id, estarán vinculados a la misma persona en nuestro sistema.
  • person_id [string] (opcional): puede ser cualquier ID que se utilice en su sistema para identificar de forma única a una persona. Tenga en cuenta que si envía dos eventos con el mismo person_id, se vincularán a la misma persona en nuestro sistema.
  • ga_client_id [string] (opcional) : es el ID de Google Analytics que puede proporcionarnos para permitirnos extraer información de marketing.
  • created_at [string] (opcional): si desea proporcionar una marca de tiempo más precisa para cuando se produjo el evento. Si no se proporciona se establecerá en el momento en que Driftrock recibe el evento, esta es una distinción sutil, pero puede ser importante para su caso de negocio. Esto debe ser pasado en formato ISO8601, (por ejemplo: 2019-12-02T10:00:00.000Z)


He aquí un ejemplo de lo que sería un cuerpo sencillo

{
 "event_type": "lead",
 "event_name": "User signed up",
 "source_id": "034feb07-0cd7-4d44-bbdb-ae18a8a4132f",
 "fields": {
   "email": "test@driftrock.com",
   "first_name": "First name",
   "last_name": "Last name",
   ...
 }
}


Envíe su primera pista de prueba.

Si su prueba ha tenido éxito, debería ver la siguiente respuesta:

  • estado: 200
  • payload: {"data": "ok"}

Si su prueba ha fallado, verá la siguiente respuesta:

  • estado: 400
  • payload: {"error": "..."}