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

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

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

カテゴリー: 分析

この統合はWebプロジェクトのみで利用可能です

期待されること

この統合により、カスタマージャーニーのどこからでもPiano Analyticsセグメントを使用してデータを分析することができます。Contentsquareは、すべてのContentsquare機能（ジャーニー分析、ページ比較、ゾーニング分析、セッションリプレイ）でPiano Analyticsセグメントを使用することを可能にします。

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

収集する情報

動的変数

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

csMatchingKey

PianoセグメントとContentsquareセッションをクロスリファレンスするために使用されるユニークな値を指します。

実装

実装手順

ⓘ 前提条件: クッキーを最初に承認する必要があるクッキーポリシーがある場合は、以下のコードがクッキー承認ポリシーロジックでラップされていることを確認するのはあなたの責任です。

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

カスタムHTML / JavaScript実装
Googleタグマネージャー - Piano Analyticsテンプレート

カスタムHTML / JavaScript実装

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

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

例えば:

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

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

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

以下のライブラリを使用している場合、最新の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 連携機能
 *バージョン: 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;安全な";
                }
                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;安全な";
        }

        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 連携機能 終了

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

/*
 *名前: Piano Analytics CS 連携機能
 *バージョン: 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 連携機能終了

Googleタグマネージャー - Piano Analytics テンプレート

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

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

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

/*
 *名前: Piano Analytics CS 連携機能
 *バージョン: 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 連携機能 終了

注: CS マッチングキーのプロパティにデフォルト以外の名前を付けた場合、cs_matching_key というコード内の名前も変更する必要があります。

4. '保存'をクリックすると、ユーザー定義変数に以下のようなものが表示されます:

5. Piano Analytics タグコンテナに移動し、アクションメニューから'プロパティを設定'オプションを選択します。

6. 定義したキーを挿入します。コード内のデフォルトはcs_matching_keyです。このキー名をデフォルトから変更した場合、コード内でも変更し、CSチームにカスタム名を通知する必要があります。

7. 次に、新しいユーザー定義変数を選択します。

8. '永続的'のチェックボックスを有効化します。

9. 変更を保存し、コードを公開します。

動作確認

1. cs_matching_key の値が Contentsquare に次のように送信されるのが確認できるはずです：

2. Piano Analytics に送信されたネットワークリクエスト内でも値を確認できます。

実装の完了

Piano Analytics の実装を完了するには、この文書の指示に従ってください。

ヘルプセンターの結果

技術文書

このセクションの記事

Piano Analytics - コードと構成 🧪