Angular-SDK

Paketet @tracio/angular omsluter kärnpaketet @tracio/sdk och exponerar idiomatiska Angular-primitiver: en provider som du sprider in i din applikationskonfiguration och en signalbaserad tjänst som du injicerar var som helst.

Installation

bash

npm install @tracio/angular @tracio/sdk

@angular/core (17, 18 eller 19) är ett peer-beroende och förutsätts redan vara installerat i din app.

Konfiguration

Sprid in provideTracio(config) i din ApplicationConfig.providers.

TypeScript

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

Tjänst

Injicera TracioService för att läsa av identifieringstillståndet genom skrivskyddade signaler:

Medlem	Typ	Beskrivning
`visitorId()`	`Signal<string \| null>`	Den stabila besökaridentifieraren.
`result()`	`Signal<TracioResult \| null>`	Det fullständiga identifieringsresultatet.
`error()`	`Signal<TracioError \| null>`	Det senaste felet, om något.
`isLoading()`	`Signal<boolean>`	Om en hämtning pågår.
`getVisitorData()`	metod	Hämta (om) besökardata imperativt.

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)
}

Anropa getVisitorData() för att skjuta upp eller på nytt utlösa identifieringen — till exempel först efter att användaren har gett sitt samtycke.

Fullständigt exempel

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)
}

Nästa steg

JavaScript-SDK-referens — kärnans @tracio/sdk-API som tjänsten bygger på
Felhantering — felkoder och strategier för återförsök
Översikt över SDK:er — varje ramverkspaket i korthet

Tjänst

Injicera TracioService för att läsa av identifieringstillståndet genom skrivskyddade signaler:

Medlem

Typ

Beskrivning

visitorId()

Signal<string | null>

Den stabila besökaridentifieraren.

result()

Signal<TracioResult | null>

Det fullständiga identifieringsresultatet.

error()

Signal<TracioError | null>

Det senaste felet, om något.

isLoading()

Signal<boolean>

Om en hämtning pågår.

getVisitorData()

metod

Hämta (om) besökardata imperativt.

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)
}

Anropa getVisitorData() för att skjuta upp eller på nytt utlösa identifieringen — till exempel först efter att användaren har gett sitt samtycke.

Fullständigt exempel

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)
}