From c1a7a3e919d01a6e8d09c3982d8411e5cab7f21c Mon Sep 17 00:00:00 2001 From: Marlo Date: Wed, 14 Aug 2024 15:24:02 +0800 Subject: [PATCH] Update instructions --- README.md | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index bc31697..abd9ba1 100644 --- a/README.md +++ b/README.md @@ -40,16 +40,38 @@ php artisan vendor:publish --tag="clarity-views" ## Usage +### General Tracking + - Create an account: The first thing you need to do is create an account on Microsoft Clarity. You can sign up on their website and follow the steps to create your account. Then, get your tracking code and that's it. - Simply add the blade components to your base layout files. -The `enabled` attribute is optional, but can be used to control the tags integration from blade files that extend the base layout. It accepts `true/false`. +The `enabled` attribute is *optional*, but can be used to control the tags integration from blade files that extend the base layout. It accepts `true/false`. This can still be controlled globally via the `.env` file should you need to disable the integration global on different environments as well. ```html ``` +### Identify API + +To implement the [Identify API](https://learn.microsoft.com/en-us/clarity/setup-and-installation/identify-api), use `identify` component. +Set `CLARITY_IDENTIFICATION_ENABLED` value to `true` on the env file. + +#### Attributes: +* `user` attribute is *required* accepts the User Model instance or any object. The `email` and `name` attributes are used. +* `enabled` attribute is *optional*. +* `custom_session_id` attribute is *optional*. +* `custom_page_id` attribute is *optional*. + +```html +@auth + +@endauth +``` +This will compile as: +```js +window.clarity("identify", "user@example.com", null, null, "Username") +``` ## Testing