README

Buckaroo Magento2 Analytics 扩展

索引

安装和配置
使用方法
服务器端
功能
贡献
版本控制
附加信息

安装和配置

composer require buckaroo/magento2analytics
php bin/magento module:enable Buckaroo_Magento2Analytics
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy

使用方法

一般信息

GA 跟踪在跨浏览器或跨设备交易时无法正确分配转换来源。访客从广告活动着陆到网站，经过订单流程，但支付过程发生在不同的设备或浏览器上，成功页面也在不同的设备上显示。为了处理这种情况，我们通过订单跟踪 Google 客户端 ID，并且可以通过添加 clientId 参数在成功页面上触发跟踪代码的丰富版本。

JavaScript / GTM

clientId 值作为成功页面 URL 中的参数传递，是重定向过程的一部分。这可以在触发 GA/UA/GTM/其他事件的 JavaScript 代码中提取和使用。URL 的标准结构如下：/checkout/onepage/success/?clientId=****/

并且可以提取 clientId

    try{
        currentPageUrl = window.location.href;
        myClientId = currentPageUrl.split('clientId=')[1].split('/')[0];
    } catch(error) {
        myClientId = '';
    }

并发送到 GA/UA 跟踪代码的一部分

    ga('create', 'UA-XXXXX-Y', {
        'storage': 'none',
        'clientId': myClientId
    });

服务器端

与 clientId 相关的信息也存储在数据库中。这可以在服务器端级别使用，通过模型存储库 Buckaroo\Magento2Analytics\Model\AnalyticsRepository 使用 quoteId

use Buckaroo\Magento2Analytics\Model\AnalyticsRepository;
use Magento\Framework\Exception\NoSuchEntityException;

class MyCustomViewModel
{
    public function __construct(
        AnalyticsRepository $analyticsRepo
    ) {
        $this->analyticsRepo = $analyticsRepo;
    }

    public function getClientId($quoteId)
    {
        $clientId = null;
        try {
            $clientIdData = $analyticsRepo->getByQuoteId($quote->getId());
            return $clientIdData->getClientId();    
        } catch(\Exception $e) {
            throw new NoSuchEntityException(__('ClientId not found for quoteId' . $quoteId ));
        }
        
    }
}

功能

基于 Cookie 的成功页面动态 URL 参数

• 新功能使您能够在成功页面上添加无限多的 URL 参数，利用存储在 Cookie 中的信息。这是一个重要的补充，可以更精确地跟踪客户活动和成功页面的交互，从而生成更精确和可操作的 Analytics 数据。

• 新模块易于使用：只需添加另一对 cookie 名称、URL 参数和替换正则表达式（如果您只想提取文本的一部分）。这种灵活性允许您精确控制要捕获和用于 URL 参数的信息。

如何使用
要使用此功能
1. 前往 Buckaroo Magento2_Analytics 模块设置（商店 → 设置 → 配置 → 销售 → Buckaroo → GA 跟踪选项）。

2. 启用 GA 跟踪。
3. 添加一个新的组合，包括您希望根据 Cookie 的值设置的 cookie 名称和 URL 参数。
4.（可选）如果您只需要提取文本的特定部分，提供替换正则表达式。
5. 保存设置。
6. 模块将自动处理其余部分，根据指定的 Cookie 在您的成功页面上设置 URL 参数。

贡献

我们非常感谢开发者对 Buckaroo 插件的贡献。如果您也想做出贡献，请遵循我们的贡献指南。

版本控制

重大变更：需要额外测试/注意的破坏性更改。
小版本变更：不应有重大影响的更改。
补丁：仅包含错误和热修复。

附加信息

支持： https://support.buckaroo.eu/contact
联系方式： support@buckaroo.nl 或 +31 (0)30 711 50 50

buckaroo / magento2analytics

维护者

详细信息