add tiktok

config/referrer.php

@@ -16,6 +16,7 @@
         \Elegantly\Referrer\Sources\RequestHeaderSource::class,
         \Elegantly\Referrer\Sources\GoogleClickIdSource::class,
         \Elegantly\Referrer\Sources\MetaClickIdSource::class,
+        \Elegantly\Referrer\Sources\TikTokClickIdSource::class,
     ],
 
     /*
@@ -30,18 +31,18 @@
     |
     */
     'drivers' => [
-        \Elegantly\Referrer\Drivers\ContextDriver::class => [
-            'key' => null,
-        ],
-        \Elegantly\Referrer\Drivers\SessionDriver::class => [
-            'key' => null,
-        ],
-        \Elegantly\Referrer\Drivers\CookieDriver::class => [
-            'key' => null,
-            /**
-             * Lifetime in seconds
-             */
-            'lifetime' => 60 * 60 * 24 * 365,
-        ],
+        // \Elegantly\Referrer\Drivers\ContextDriver::class => [
+        //     'key' => 'referrer',
+        // ],
+        // \Elegantly\Referrer\Drivers\SessionDriver::class => [
+        //     'key' => 'referrer',
+        // ],
+        // \Elegantly\Referrer\Drivers\CookieDriver::class => [
+        //     'key' => Str::slug(env('APP_NAME', 'laravel'), '_').'referrer',
+        //     /**
+        //      * Lifetime in seconds
+        //      */
+        //     'lifetime' => 60 * 60 * 24 * 365,
+        // ],
     ],
 ];

src/Sources/TikTokClickIdSource.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace Elegantly\Referrer\Sources;
+
+use Illuminate\Http\Request;
+
+/**
+ * @see https://business-api.tiktok.com/portal/docs?id=1771100879787009
+ *
+ * @extends ReferrerSource<string|null>
+ */
+class TikTokClickIdSource extends ReferrerSource
+{
+    final public function __construct(
+        public ?string $ttclid = null,
+
+    ) {
+        //
+    }
+
+    public function isEmpty(): bool
+    {
+        return blank($this->ttclid);
+    }
+
+    public static function fromRequest(Request $request): static
+    {
+        return new static(
+            ttclid: $request->string('ttclid')->value() ?: null,
+        );
+    }
+
+    /**
+     * @param array{
+     *      ttclid?: string|null,
+     *  } $values
+     */
+    public static function fromArray(array $values): static
+    {
+        return new static(
+            ttclid: $values['ttclid'] ?? null,
+        );
+    }
+
+    /**
+     * @return array{
+     *      ttclid?: string|null,
+     *  }
+     */
+    public function toArray(): array
+    {
+        return [
+            'ttclid' => $this->ttclid,
+        ];
+    }
+}