Angular SDK

@tracio/angular paketi, çekirdek @tracio/sdk paketini sarmalar ve deyimsel Angular ilkelerini sunar: uygulama yapılandırmanıza yaydığınız bir sağlayıcı ve her yerde enjekte edebileceğiniz signal tabanlı bir servis.

Kurulum

bash

npm install @tracio/angular @tracio/sdk

@angular/core (17, 18 veya 19) bir peer bağımlılığıdır ve uygulamanızda zaten kurulu olduğu varsayılır.

Ayarlama

provideTracio(config) ifadesini ApplicationConfig.providers içine yayın.

TypeScript

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

Servis

Tanımlama durumunu salt okunur signal'lar aracılığıyla okumak için TracioService'i enjekte edin:

Üye	Tür	Açıklama
`visitorId()`	`Signal<string \| null>`	Kararlı ziyaretçi tanımlayıcısı.
`result()`	`Signal<TracioResult \| null>`	Tam tanımlama sonucu.
`error()`	`Signal<TracioError \| null>`	Varsa son hata.
`isLoading()`	`Signal<boolean>`	Bir getirme işleminin sürüp sürmediği.
`getVisitorData()`	metot	Ziyaretçi verisini emirle (yeniden) getir.

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

Tanımlamayı ertelemek veya yeniden tetiklemek için getVisitorData() çağırın — örneğin yalnızca kullanıcı onay verdikten sonra.

Tam örnek

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

Sonraki adımlar

JavaScript SDK Referansı — servisin üzerine kurulduğu çekirdek @tracio/sdk API'si
Hata Yönetimi — hata kodları ve yeniden deneme stratejileri
SDK'lara genel bakış — her framework paketi bir bakışta

Servis

Tanımlama durumunu salt okunur signal'lar aracılığıyla okumak için TracioService'i enjekte edin:

Üye

Tür

Açıklama

visitorId()

Signal<string | null>

Kararlı ziyaretçi tanımlayıcısı.

result()

Signal<TracioResult | null>

Tam tanımlama sonucu.

error()

Signal<TracioError | null>

Varsa son hata.

isLoading()

Signal<boolean>

Bir getirme işleminin sürüp sürmediği.

getVisitorData()

metot

Ziyaretçi verisini emirle (yeniden) getir.

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

Tanımlamayı ertelemek veya yeniden tetiklemek için getVisitorData() çağırın — örneğin yalnızca kullanıcı onay verdikten sonra.

Tam örnek

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