# Examples

Copy ready-made code for the most common Screeb tasks, from setup and identity to events, surveys, hooks and logout.

Each example below covers one common task. They assume the SDK is installed as shown in [Install](https://developers.screeb.app/sdk-angular/install). Replace the placeholders with your own values.

For a complete working app, open the example for your SDK in the [examples folder of the Screeb SDK repository](https://github.com/ScreebApp/sdk/tree/master/examples).

## Initialize with a logged-in user

When the user is already logged in at startup, pass their id and properties to the initialization. Screeb then ties the session to that user from the start, with no anonymous user in between.

```ts
// app.module.ts
import { NgModule } from "@angular/core";
import { ScreebModule } from "@screeb/sdk-angular";

@NgModule({
  imports: [
    ScreebModule.forRoot({
      websiteId: "<YOUR-CHANNEL-ID>",
      autoInit: true,
      userId: "<USER-ID>",
      userProperties: { email: "jane@example.com", plan: "pro" },
    }),
  ],
})
export class AppModule {}
```

## Identify the user after login

When the app starts before the user logs in, initialize Screeb without a user, then identify them once they log in. Screeb keeps the activity of the anonymous session and attaches it to that user. See [Identity](https://developers.screeb.app/sdk-angular/identity) for the details.

```ts
import { Component } from "@angular/core";
import { Screeb } from "@screeb/sdk-angular";

@Component({ selector: "app-login", template: "" })
export class LoginComponent {
  constructor(private screeb: Screeb) {}

  async onLogin(userId: string, email: string) {
    await this.screeb.identity(userId, { email, plan: "pro" });
  }
}
```

## Track an event

Track what the user does, with properties that describe it. You can then target surveys at users who did it. See [Event tracking](https://developers.screeb.app/sdk-angular/event-tracking).

```ts
await this.screeb.eventTrack("plan_upgraded", {
  plan: "pro",
  seats: 5,
});
```

## Assign the user to a group

Put the user in a group, such as their company, with properties that describe the group. See [Group assignation](https://developers.screeb.app/sdk-angular/group-assignation).

```ts
await this.screeb.identityGroupAssign("Acme", "company", {
  plan: "enterprise",
});
```

## Start a survey with hidden fields

Start a survey from your code, for example once a checkout completes, and pass hidden fields that Screeb saves with the response. See [Start a survey programmatically](https://developers.screeb.app/sdk-angular/start-survey-programmatically) for the other options.

```ts
await this.screeb.surveyStart("<SURVEY-ID>", undefined, true, {
  source: "checkout",
  cart_value: 149.99,
});
```

## Run code when a survey is completed

Pass hooks to the initialization to run your code on Screeb events. This one logs each completed survey. Hooks always need a `version`. See [Hooks](https://developers.screeb.app/sdk-angular/hooks) for every hook and its payload.

```ts
// app.module.ts
import { NgModule } from "@angular/core";
import { ScreebModule } from "@screeb/sdk-angular";

@NgModule({
  imports: [
    ScreebModule.forRoot({
      websiteId: "<YOUR-CHANNEL-ID>",
      autoInit: true,
      hooks: {
        version: "1.0.0",
        onSurveyCompleted: (payload) => {
          console.log("Survey completed", payload.survey.id);
        },
      },
    }),
  ],
})
export class AppModule {}
```

## Reset the identity on logout

When the user logs out, reset the identity. Screeb starts a new anonymous session, so the next person on the device is not mixed with the previous user.

```ts
await this.screeb.identityReset();
```
