Angular SDK

Pachetul @tracio/angular încapsulează nucleul @tracio/sdk și expune primitive Angular idiomatice: un provider pe care îl adaugi în configurația aplicației și un serviciu bazat pe signal-uri pe care îl injectezi oriunde.

Instalare

npm install @tracio/angular @tracio/sdk

@angular/core (17, 18 sau 19) este o peer dependency și se presupune că este deja instalat în aplicația ta.

Configurare

Adaugă provideTracio(config) în ApplicationConfig.providers.

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

Pentru a servi scriptul de pe propriul subdomeniu, transmite endpoint în configurație, de exemplu endpoint: "https://metrics.yoursite.com" — consultă Domenii personalizate.

Serviciu

Injectează TracioService pentru a citi starea de identificare prin signal-uri readonly:

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

Apelează getVisitorData() pentru a amâna sau a redeclanșa identificarea — de exemplu doar după ce utilizatorul își dă consimțământul.

Exemplu complet

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

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

Pașii următori

• Referință SDK JavaScript — API-ul de bază @tracio/sdk pe care se construiește serviciul
• Gestionarea erorilor — coduri de eroare și strategii de reîncercare
• Prezentare generală SDK-uri — fiecare pachet de framework dintr-o privire