README

这是一个帮助激活 Pimcore 及 Pimcore 电子商务框架服务器端 Matomo 跟踪的包。

要配置和激活跟踪，请按照以下说明操作

激活

通过在 Pimcore 扩展管理器中激活它来激活该包。

配置

配置跟踪器

要配置跟踪器，只需在 Symfony 容器上注册一个服务，如下所示。重要的是要在服务中添加 `` 标签，并且类必须是（或 Pimcore\Bundle\ServerSideMatomoTrackingBundle\Tracking\Tracker 的子类）。

    my_serverside_tracker:
        class: Pimcore\Bundle\ServerSideMatomoTrackingBundle\Tracking\Tracker
        arguments:
            - 33  # matomo site id
            - https://my-endpoint.com/matomo # matomo service url
            - default  # pimcore site id (default is 'default') 
        tags: [ pimcore.serverside_matomo_tracking.tracker ]

• 要禁用跟踪器的 cookies，使用以下示例中的 `disableCookieSupport` 调用。
• 要使用客户端 IP（而不是服务器 IP）进行跟踪，您必须设置 Matomo 超级用户的令牌身份验证（以便允许覆盖 IP 地址）。

    my_serverside_tracker:
        class: Pimcore\Bundle\ServerSideMatomoTrackingBundle\Tracking\Tracker
        arguments:
            - 33  # matomo site id
            - https://my-endpoint.com/matomo # matomo service url
            - default  # pimcore site id (default is 'default') 
        tags: [ pimcore.serverside_matomo_tracking.tracker ]
        calls:
            - [disableCookieSupport]
            - [setTokenAuth, ['<MY_SECRET_MATOMO_TOKEN>']]        

配置电子商务跟踪

要配置电子商务跟踪，必须向容器配置额外的电子商务跟踪器，并扩展电子商务框架配置。

    my_ecommerce_framework_matomo_tracker:
          class: Pimcore\Bundle\ServerSideMatomoTrackingBundle\Tracking\EcommerceFramework\ServerSideMatomoTracker
          arguments:
              - '@my_serverside_tracker'  # id of server side matomo tracker

pimcore_ecommerce_framework:
    tracking_manager:
        trackers:
            serverside_matomo_tracking:
                id: my_ecommerce_framework_matomo_tracker   # id of matomo e-commerce tracker 
                # Service id for item builder for tracker
                item_builder_id: AppBundle\Ecommerce\Tracking\TrackingItemBuilder  
                enabled: true