ministryofweb / analytics-campaign-urls

向URL添加活动参数

维护者

详情

github.com/ministryofweb/analytics-campaign-urls

源代码

问题

安装: 650

依赖: 0

建议: 0

安全: 0

星标: 0

关注者: 2

分支: 0

开放问题: 2

3.0.0 2023-12-05 15:50 UTC

Requires

  • php: ^8.1

Requires (Dev)

MIT e3a3e2836f5e6f9d9fbb79528c05f9d42e925445

urlanalyticspiwikgoogle analyticscampaignmatomo

This package is auto-updated.

Last update: 2024-09-07 09:35:31 UTC

README

这个库允许用户轻松地将活动参数（例如，用于Google Analytics、Matomo/Piwik或Plausible）附加到任何给定的URL。

要求

使用当前版本库至少需要PHP 8.1。

该库的2.x版本支持PHP 7.0或更高版本。

安装

composer require ministryofweb/analytics-campaign-urls

使用方法

<?php

use MinistryOfWeb\AnalyticsCampaignUrls\Url;
use MinistryOfWeb\AnalyticsCampaignUrls\Parameters\GoogleAnalytics;
use MinistryOfWeb\AnalyticsCampaignUrls\Parameters\Matomo;

$params = new GoogleAnalytics(
    'summer',
    'banner',
    'website',
);

$campaignUrlGA = Url::addAnalyticsCampaignParams('https://example.com/', $params);
// → https://example.com/?utm_campaign=summer&utm_medium=banner&utm_source=website

$campaignUrlGAWithExistingParam = Url::addAnalyticsCampaignParams('https://example.com/?existingparam=1', $params);
// → https://example.com/?existingparam=1&utm_campaign=summer&utm_medium=banner&utm_source=website

$matomoParams = new Matomo(
    'summer',
    'banner',
    'website',
    'keyword',
    'content'
);

$campaignUrlMatomo = Url::addAnalyticsCampaignParams('https://example.com/', $matomoParams);
// → https://example.com/?pk_campaign=summer&pk_medium=banner&pk_source=website&pk_kwd=keyword&pk_content=content

链接