英語からAIを使用して翻訳されました

この記事はAI技術を使用して翻訳されたことにご注意ください。正確性を維持するよう努めていますが、一部の詳細は元のテキストを完全に反映していない場合があります。情報に不明な点がある場合は、英語版を参照してください。

ⓘ これは早期アクセスのベータ統合です

カテゴリ: 分析

この統合はWebプロジェクト専用です

期待できること

この統合により、あなたのPiano Analyticsセグメントを使用して顧客の旅のどこからでもデータを分析することができます。Contentsquareは、すべてのContentsquare機能（Journey Analysis、Page Comparator、Zoning Analysis、Session Replay）であなたのPiano Analyticsセグメントを使用することを可能にします。

セグメントをインポートするには、Pianoコード設定にコードのスニペットを追加する必要があります。このコードは、ユニークな識別子をPiano Analyticsにプッシュします。これにより、Piano AnalyticsセッションとContentsquareセッションを照合するのに役立ちます。

収集する情報

動的変数

キー	値	データ型
cs_matching_key	{csMatchingKey}	テキスト

csMatchingKey

これは、PianoセグメントとContentsquareセッションを相互参照するために使用されるユニークな値を指します。

実装

実装手順

ⓘ 前提条件: もしあなたのクッキーポリシーが、注入の前に私たちのクッキーを受け入れることを要求する場合、以下のコードがあなたのクッキー同意ポリシーのロジックにラップされていることを確認するのはあなたの責任です。

コードを統合する方法はいくつかありますが、以下のオプションをカバーします:

カスタムHTML / Javascript実装
Google Tag Manager - Piano Analyticsテンプレート

カスタムHTML / Javascriptの実装

これは、GTMカスタムHTMLタグやカスタムHTML / Javascriptを使用する他のタグマネージャーなど、任意のカスタムコードの実装に使用できます。また、インラインに配置されたコードにも適用できます。

次のコードを既存のPiano Analytics構成に追加する必要があります。これは、Piano Analyticsのpa.sendEvent("page.display", {})コマンドの前に行います。

例えば：

CSマッチングキーのプロパティに、コード内のデフォルトcs_matching_key以外の異なる名前を付けた場合、このセクションのコード内でも変更する必要があることに注意してください：

カスタムHTML / Javascript実装のためのコードの実装方法：

この方法を使用する前に、まず使用しているPianoのAnalytics SDKのバージョンを確認する必要があります：

次のライブラリをPiano Analyticsに使用している場合、最新のSDKバージョンを使用しています：

<script src="https://tag.aticdn.net/piano-analytics.js"></script>

SmartTagライブラリを使用している場合、レガシーバージョンを使用しています。

<script src="https://tag.aticdn.net/[siteid]/smarttag.js"></script>

次のコードは最新のSDKバージョン用です：

/*
 *名前: Piano Analytics CS Integration
 *バージョン: 1.0.0
 */
(function () {
    var version = "1.0.0";

    function callback() {
        if (!disableCallback) {
            disableCallback = true;

            if (window.CS_CONF) {
                CS_CONF.integrations = CS_CONF.integrations || [];
                CS_CONF.integrations.push("Piano Analytics - v" + version);
            }
        }
    }

    var disableCallback = false;

    window._uxa = window._uxa || [];
    _uxa.push(["afterPageView", callback]);

    var cmk = null;
    var cn = "_cs_mk_pa";

    function init(cookieValue) {
        if (cookieValue) {
            cmk = cookieValue;
        } else {
            cmk = Math.random() + "_" + Date.now();

            var tld = (function () {
                var i = 0,
                    domain = document.domain,
                    p = domain.split("."),
                    s = "_cs_tld" + new Date().getTime();
                while (i < p.length - 1 && document.cookie.indexOf(s + "=" + s) == -1) {
                    domain = p.slice(-1 - ++i).join(".");
                    document.cookie = s + "=" + s + ";domain=" + domain + ";SameSite=None;Secure";
                }
                document.cookie = s + "=;expires=Thu, 01 Jan 1970 00:00:01 GMT;domain=" + domain + ";";
                return domain;
            })();

            var now = new Date();
            var time = now.getTime();
            time += 30 * 60 * 1000;
            now.setTime(time);

            document.cookie = cn + "=" + cmk + "; expires=" + now.toUTCString() + ";path=/;domain=" + tld + ";SameSite=None;Secure";
        }

        if (window.pa && typeof pa.setProperty === "function") {
            pa.setProperty("cs_matching_key", cmk, {
                persistent: true,
            });
        }

        _uxa.push([
            "trackDynamicVariable",
            {
                key: "csMatchingKey",
                value: cmk,
            },
        ]);
    }

    var cookies = "; " + document.cookie;
    if (cookies) {
        var getCookie = cookies.split("; " + cn + "=");

        if (getCookie.length == 1) {
            init();
        } else {
            var cookieValue = getCookie[1].split(";")[0];
            init(cookieValue);
        }
    }
})();
//Piano Analytics CS Integration 終了

以下のコードは、レガシーSDKバージョン用です：

/*
 *名前: Piano Analytics CS Integration
 *バージョン: 1.0.0 (レガシー)
 */
(function () {
    var version = "1.0.0";

    function callback() {
        if (!disableCallback) {
            disableCallback = true;

            if (window.CS_CONF) {
                CS_CONF.integrations = CS_CONF.integrations || [];
                CS_CONF.integrations.push("Piano Analytics - v" + version);
            }
        }
    }

    var disableCallback = false;

    window._uxa = window._uxa || [];
    _uxa.push(["afterPageView", callback]);

    var cmk = null;
    var cn = "_cs_mk_pa";

    function init(cookieValue) {
        if (cookieValue) {
            cmk = cookieValue;
        } else {
            cmk = Math.random() + "_" + Date.now();

            var tld = (function () {
                var i = 0,
                    domain = document.domain,
                    p = domain.split("."),
                    s = "_cs_tld" + new Date().getTime();
               while (i < p.length - 1 && document.cookie.indexOf(s + "=" + s) == -1) {
                    domain = p.slice(-1 - ++i).join(".");
                    document.cookie = s + "=" + s + ";domain=" + domain + ";SameSite=None;Secure";
                }
                document.cookie = s + "=;expires=Thu, 01 Jan 1970 00:00:01 GMT;domain=" + domain + ";";
                return domain;
            })();

            var now = new Date();
            var time = now.getTime();
            time += 30 * 60 * 1000;
            now.setTime(time);

            document.cookie = cn + "=" + cmk + "; expires=" + now.toUTCString() + ";path=/;domain=" + tld + ";SameSite=None;Secure";
        }

        // "tag"をあなたのAT Internet Track Tagの名前に置き換えてください
        tag.setProp("cs_matching_key", cmk, true);

        _uxa.push([
            "trackDynamicVariable",
            {
                key: "csMatchingKey",
                value: cmk,
            },
        ]);
    }

    var cookies = "; " + document.cookie;
    if (cookies) {
        var getCookie = cookies.split("; " + cn + "=");

        if (getCookie.length == 1) {
            init();
        } else {
            var cookieValue = getCookie[1].split(";")[0];
            init(cookieValue);
        }
    }
})();
//Piano Analytics CS Integration 終了

Google Tag Manager - Piano Analytics テンプレート

1. GTMで 'ユーザー定義変数'を'変数'セクションに作成します。

2. 'カスタムJavaScript'をクリックして、カスタムJavaScriptページ変数を追加します。

3. 変数に統合に関連する名前を付け、以下のコードをカスタムJavaScriptコードエディタにコピー＆ペーストします。

/*
 *名前: Piano Analytics CS Integration
 *バージョン: 1.0.0 (csMatchingKey + GTM)
 */

function paCSintegration() {
    var version = "1.0.0";

    function callback() {
        if (!disableCallback) {
            disableCallback = true;

            if (window.CS_CONF) {
                CS_CONF.integrations = CS_CONF.integrations || [];
                CS_CONF.integrations.push("Piano Analytics - v" + version);
            }
        }
    }

    var disableCallback = false;

    window._uxa = window._uxa || [];
    _uxa.push(["afterPageView", callback]);

    var cmk = null;
    var cn = "_cs_mk_pa";

    function init(cookieValue) {
        if (cookieValue) {
            cmk = cookieValue;
        } else {
            cmk = Math.random() + "_" + Date.now();

            var tld = (function () {
                var i = 0,
                    domain = document.domain,
                    p = domain.split("."),
                    s = "_cs_tld" + new Date().getTime();
                while (i < p.length - 1 && document.cookie.indexOf(s + "=" + s) == -1) {
                    domain = p.slice(-1 - ++i).join(".");
                    document.cookie = s + "=" + s + ";domain=" + domain + ";SameSite=None;Secure";
                }
                document.cookie = s + "=;expires=Thu, 01 Jan 1970 00:00:01 GMT;domain=" + domain + ";";
                return domain;
            })();

            var now = new Date();
            var time = now.getTime();
            time += 30 * 60 * 1000;
            now.setTime(time);

            document.cookie = cn + "=" + cmk + "; expires=" + now.toUTCString() + ";path=/;domain=" + tld + ";SameSite=None;Secure";
        }

        if (window.pa && typeof pa.setProperty === "function") {
            pa.setProperty("cs_matching_key", cmk, {
                persistent: true,
            });
        }

        _uxa.push([
            "trackDynamicVariable",
            {
                key: "csMatchingKey",
                value: cmk,
            },
        ]);
    }

    var cookies = "; " + document.cookie;
    if (cookies) {
        var getCookie = cookies.split("; " + cn + "=");

        if (getCookie.length == 1) {
            init();
        } else {
            var cookieValue = getCookie[1].split(";")[0];
            init(cookieValue);
        }
    }

    return cmk;
}
//Piano Analytics CS Integration 終了

注意: CS マッチングキーのプロパティ名をコード内のデフォルトであるcs_matching_key以外の名前に変更した場合、このセクションのコード内でも変更する必要があります。