⚠️ Deprecation Notice: UDP/REST/JSON Tracking Events Endpoint

The Tracking Events Pipeline has been refined and improved.

As part of this update, the UDP/REST/JSON endpoint has been deprecated and is no longer the recommended integration method for producing tracking events. Please migrate to the gRPC endpoint, which provides better performance, stronger contracts, and improved reliability.

To simplify the migration, a new Rust library has been created that provides native support for producing tracking events via gRPC:

https://github.com/vinted/rs-tracking-events-producer

Future enhancements and support will be focused on the gRPC-based implementation.

Event Tracker

An abstraction for event tracking

Installation

Add event tracker as a dependency to your Cargo.toml:

vinted_event_tracker = { git = "https://github.com/vinted/event-tracker-rs" }

Usage

Configure relay once during the startup.

use serde::Serialize;
use vinted_event_tracker::*;


#[tokio::main]
async fn main() {
    let udp_relay = UdpRelay::new("0.0.0.0:5005").await.unwrap();

    set_relay(udp_relay).unwrap();
}

In your library code, create an event structure and use it for tracking

use serde::Serialize;
use vinted_event_tracker::*;

fn track_search_event() {
    #[derive(Debug, Serialize)]
    struct SearchEvent<'a> {
        total: i32,
        timed_out: bool,
        query: &'a str,
    }

    let event = "event_name";
    let portal = "fr";
    let debug_pin = Some(1234);
    let search_event = SearchEvent {
        total: 123,
        timed_out: false,
        query: "shoes",
    };

    track(event, portal, debug_pin, search_event);
}

Try locally

To run UDP example:

1. Listen for events:

nc -kul 5005

2. In separate session, run example:

cargo run --package vinted_event_tracker --example udp

3. See captured events, like:

{"event":"event","portal":"portal","time":1708000488315,"debug_pin":1234,"iteration":945}