Angular SDK

Balíček @tracio/angular obaluje jádro @tracio/sdk a poskytuje idiomatické primitivy Angularu: poskytovatele (provider), kterého rozprostřete do konfigurace své aplikace, a signálově založenou službu, kterou můžete injektovat kdekoli.

Instalace

bash

npm install @tracio/angular @tracio/sdk

@angular/core (17, 18 nebo 19) je peer dependency a předpokládá se, že je již ve vaší aplikaci nainstalován.

Nastavení

Rozprostřete provideTracio(config) do ApplicationConfig.providers.

TypeScript

// app.config.ts
import { provideTracio } from "@tracio/angular"
export const appConfig: ApplicationConfig = {
  providers: [provideTracio({ publicKey: "5ca175fc…" })],
}

Služba

Injektujte TracioService a čtěte stav identifikace prostřednictvím signálů jen pro čtení:

Člen	Typ	Popis
`visitorId()`	`Signal<string \| null>`	Stabilní identifikátor návštěvníka.
`result()`	`Signal<TracioResult \| null>`	Kompletní výsledek identifikace.
`error()`	`Signal<TracioError \| null>`	Poslední chyba, pokud nějaká nastala.
`isLoading()`	`Signal<boolean>`	Zda právě probíhá načítání.
`getVisitorData()`	metoda	Imperativní (opětovné) načtení dat návštěvníka.

TypeScript

// home.component.ts
import { Component, inject } from "@angular/core"
import { TracioService } from "@tracio/angular"
@Component({ selector: "app-home", template: `<span>{{ tracio.visitorId() }}</span>` })
export class HomeComponent {
  readonly tracio = inject(TracioService)
}

Zavolejte getVisitorData(), chcete-li identifikaci odložit nebo znovu spustit — například až poté, co uživatel udělí souhlas.

Kompletní příklad

TypeScript

// app.config.ts
import { provideTracio } from "@tracio/angular"
export const appConfig: ApplicationConfig = {
  providers: [provideTracio({ publicKey: "5ca175fc…" })],
}

TypeScript

// home.component.ts
import { Component, inject } from "@angular/core"
import { TracioService } from "@tracio/angular"
@Component({ selector: "app-home", template: `<span>{{ tracio.visitorId() }}</span>` })
export class HomeComponent {
  readonly tracio = inject(TracioService)
}

Další kroky

Referenční příručka JavaScript SDK — základní API @tracio/sdk, na kterém služba staví
Zpracování chyb — chybové kódy a strategie opakování
Přehled SDK — každý balíček pro daný framework na první pohled

Služba

Injektujte TracioService a čtěte stav identifikace prostřednictvím signálů jen pro čtení:

Člen

Typ

Popis

visitorId()

Signal<string | null>

Stabilní identifikátor návštěvníka.

result()

Signal<TracioResult | null>

Kompletní výsledek identifikace.

error()

Signal<TracioError | null>

Poslední chyba, pokud nějaká nastala.

isLoading()

Signal<boolean>

Zda právě probíhá načítání.

getVisitorData()

metoda

Imperativní (opětovné) načtení dat návštěvníka.

TypeScript

// home.component.ts
import { Component, inject } from "@angular/core"
import { TracioService } from "@tracio/angular"
@Component({ selector: "app-home", template: `<span>{{ tracio.visitorId() }}</span>` })
export class HomeComponent {
  readonly tracio = inject(TracioService)
}

Zavolejte getVisitorData(), chcete-li identifikaci odložit nebo znovu spustit — například až poté, co uživatel udělí souhlas.

Kompletní příklad

TypeScript

// app.config.ts
import { provideTracio } from "@tracio/angular"
export const appConfig: ApplicationConfig = {
  providers: [provideTracio({ publicKey: "5ca175fc…" })],
}

TypeScript

// home.component.ts
import { Component, inject } from "@angular/core"
import { TracioService } from "@tracio/angular"
@Component({ selector: "app-home", template: `<span>{{ tracio.visitorId() }}</span>` })
export class HomeComponent {
  readonly tracio = inject(TracioService)
}