This bundle allows you to track your users between visits and add custom metadata to each user.
Out of the box, the bundle will store a cookie named setono_client_id which contains the client id, a created timestamp and a last seen timestamp.
It will also create a new table with metadata for each client id. The metadata functionality is lazy loaded, so if you don't use it, it will not query the database.
To install this bundle, simply run:
composer require setono/client-bundlephp bin/console doctrine:migrations:diff
php bin/console doctrine:migrations:migrateuse Setono\Client\Client;
final class YourController extends AbstractController
{
public function index(Client $client): Response
{
return $this->render('your_template.html.twig', [
'id' => $client->id,
'some_metadata' => $client->metadata->get('some_metadata_key'), // this call will initialize the metadata object from the database
]);
}
}use Setono\Client\Client;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Symfony\Component\HttpKernel\KernelEvents;
use Symfony\Component\HttpKernel\Event\RequestEvent;
use Setono\ClientBundle\Context\ClientContextInterface;
final class YourEventSubscriber implements EventSubscriberInterface
{
public function __construct(private readonly ClientContextInterface $clientContext)
{}
public static function getSubscribedEvents(): array
{
return [
KernelEvents::REQUEST => 'setMetadata',
];
}
public function setMetadata(RequestEvent $event): void
{
if (!$event->isMainRequest() || !$event->getRequest()->query->has('gclid')) {
return;
}
$this->clientContext->getClient()->metadata->set('google_click_id', $event->getRequest()->query->get('gclid'));
}
}The client id is saved in a cookie named setono_client_id (by default). The cookie also holds other information, like
the first and last time the client was seen. You can access the cookie like this:
use Setono\ClientBundle\CookieProvider\CookieProviderInterface;
final class YourService
{
public function __construct(private readonly CookieProviderInterface $cookieProvider)
{}
public function call(): void
{
$cookie = $this->cookieProvider->getCookie();
if(null === $cookie) {
return; // no cookie found
}
$clientId = $cookie->clientId; // the client id
$created = $cookie->firstSeenAt; // the timestamp when the client was first seen
$lastSeen = $cookie->lastSeenAt; // the timestamp when the client was last seen
}
}Here's the configuration you are able to do:
setono_client:
cookie:
# The name of the cookie that holds the client id. NOTICE that if you change this value, all clients with a cookie with the old name will be considered new clients
name: setono_client_id
# The expiration of the cookie. This is a string that can be parsed by strtotime
expiration: '+365 days'
# If you want to use a custom metadata class, you can specify it here
metadata_class: Setono\ClientBundle\Entity\Metadata
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent