Add NewCustomerResolverInterface extension point for new_customer field

Api/NewCustomerResolverInterface.php

@@ -0,0 +1,20 @@
+<?php declare(strict_types=1);
+
+namespace Tagging\GTM\Api;
+
+use Magento\Sales\Api\Data\OrderInterface;
+
+interface NewCustomerResolverInterface
+{
+    /**
+     * Determine whether the given order belongs to a new customer for the
+     * purpose of the `new_customer` field in the GTM data layer and webhook.
+     *
+     * Merchants can override this via a DI preference to replace the default
+     * (guest = new customer) heuristic with e.g. a prior-order-count check.
+     *
+     * @param OrderInterface $order
+     * @return bool
+     */
+    public function isNewCustomer(OrderInterface $order): bool;
+}

DataLayer/Event/Purchase.php

@@ -6,6 +6,7 @@
 
 use Magento\Sales\Api\Data\OrderInterface;
 use Tagging\GTM\Api\Data\EventInterface;
+use Tagging\GTM\Api\NewCustomerResolverInterface;
 use Tagging\GTM\Config\Config;
 use Tagging\GTM\DataLayer\Tag\Order\OrderItems;
 use Tagging\GTM\Util\PriceFormatter;
@@ -16,15 +17,18 @@ class Purchase implements EventInterface
     private OrderItems $orderItems;
     private Config $config;
     private PriceFormatter $priceFormatter;
+    private NewCustomerResolverInterface $newCustomerResolver;
 
     public function __construct(
         OrderItems $orderItems,
         Config $config,
-        PriceFormatter $priceFormatter
+        PriceFormatter $priceFormatter,
+        NewCustomerResolverInterface $newCustomerResolver
     ) {
         $this->orderItems = $orderItems;
         $this->config = $config;
         $this->priceFormatter = $priceFormatter;
+        $this->newCustomerResolver = $newCustomerResolver;
     }
 
     /**
@@ -81,7 +85,7 @@ private function getUserData(OrderInterface $order): array
             'email' => $order->getCustomerEmail() ?? '',
             'first_name' => $order->getCustomerFirstname() ?? '',
             'last_name' => $order->getCustomerLastname() ?? '',
-            'new_customer' => $order->getCustomerIsGuest() ? 'true' : 'false'
+            'new_customer' => $this->newCustomerResolver->isNewCustomer($order) ? 'true' : 'false'
         ];
     }
 

DataLayer/Event/PurchaseWebhookEvent.php

@@ -6,6 +6,7 @@
 
 use Magento\Framework\HTTP\ClientFactory;
 use Magento\Framework\Serialize\Serializer\Json;
+use Tagging\GTM\Api\NewCustomerResolverInterface;
 use Tagging\GTM\DataLayer\Tag\Order\OrderItems;
 use Magento\Sales\Api\Data\OrderInterface;
 use Tagging\GTM\Util\PriceFormatter;
@@ -22,6 +23,7 @@ class PurchaseWebhookEvent
     private $priceFormatter;
     private LoggerInterface $logger;
     private Debugger $debugger;
+    private NewCustomerResolverInterface $newCustomerResolver;
 
     public function __construct(
         Json            $json,
@@ -30,7 +32,8 @@ public function __construct(
         Config          $config,
         PriceFormatter  $priceFormatter,
         LoggerInterface $logger,
-        Debugger $debugger
+        Debugger $debugger,
+        NewCustomerResolverInterface $newCustomerResolver
     ) {
         $this->json = $json;
         $this->clientFactory = $clientFactory;
@@ -39,6 +42,7 @@ public function __construct(
         $this->priceFormatter = $priceFormatter;
         $this->logger = $logger;
         $this->debugger = $debugger;
+        $this->newCustomerResolver = $newCustomerResolver;
     }
 
     public function purchase(OrderInterface $order)
@@ -122,7 +126,7 @@ public function purchase(OrderInterface $order)
                 "email" => $order->getCustomerEmail() ?? '',
                 "first_name" => $order->getCustomerFirstname() ?? '',
                 "last_name" => $order->getCustomerLastname() ?? '',
-                "new_customer" => (string)($order->getCustomerIsGuest() ? "true" : "false")
+                "new_customer" => (string)($this->newCustomerResolver->isNewCustomer($order) ? "true" : "false")
             ];
         } catch (\Exception $e) {
             $this->debugger->debug($e->getMessage());

DataLayer/Tag/Order/UserData.php

@@ -8,18 +8,22 @@
 use Magento\Sales\Api\Data\OrderInterface;
 use Magento\Sales\Api\OrderRepositoryInterface;
 use Tagging\GTM\Api\Data\TagInterface;
+use Tagging\GTM\Api\NewCustomerResolverInterface;
 
 class UserData implements TagInterface
 {
     private CheckoutSession $checkoutSession;
     private OrderRepositoryInterface $orderRepository;
+    private NewCustomerResolverInterface $newCustomerResolver;
 
     public function __construct(
         CheckoutSession $checkoutSession,
-        OrderRepositoryInterface $orderRepository
+        OrderRepositoryInterface $orderRepository,
+        NewCustomerResolverInterface $newCustomerResolver
     ) {
         $this->checkoutSession = $checkoutSession;
         $this->orderRepository = $orderRepository;
+        $this->newCustomerResolver = $newCustomerResolver;
     }
 
     /**
@@ -54,7 +58,7 @@ public function get(): array
             'email' => $order->getCustomerEmail() ?? '',
             'first_name' => $order->getCustomerFirstname() ?? '',
             'last_name' => $order->getCustomerLastname() ?? '',
-            'new_customer' => $order->getCustomerIsGuest() ? 'true' : 'false'
+            'new_customer' => $this->newCustomerResolver->isNewCustomer($order) ? 'true' : 'false'
         ];
     }
 

Model/NewCustomerResolver/IsGuestResolver.php

@@ -0,0 +1,20 @@
+<?php declare(strict_types=1);
+
+namespace Tagging\GTM\Model\NewCustomerResolver;
+
+use Magento\Sales\Api\Data\OrderInterface;
+use Tagging\GTM\Api\NewCustomerResolverInterface;
+
+/**
+ * Default resolver: treats guest orders as new customers.
+ *
+ * Preserves the historical behavior of the module. Override via a DI
+ * preference in your own module to implement a different heuristic.
+ */
+class IsGuestResolver implements NewCustomerResolverInterface
+{
+    public function isNewCustomer(OrderInterface $order): bool
+    {
+        return (bool)$order->getCustomerIsGuest();
+    }
+}

etc/di.xml

@@ -2,6 +2,7 @@
 <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
     <preference for="Tagging\GTM\Api\CheckoutSessionDataProviderInterface" type="Tagging\GTM\SessionDataProvider\CheckoutSessionDataProvider"/>
     <preference for="Tagging\GTM\Api\CustomerSessionDataProviderInterface" type="Tagging\GTM\SessionDataProvider\CustomerSessionDataProvider"/>
+    <preference for="Tagging\GTM\Api\NewCustomerResolverInterface" type="Tagging\GTM\Model\NewCustomerResolver\IsGuestResolver"/>
 
     <type name="Tagging\GTM\Logger\Debugger">
         <arguments>