英語からAIを使用して翻訳されました
この文書はAI技術を使用して翻訳されたことにご注意ください。正確性を維持するよう努めていますが、一部の詳細は元のテキストを完全に反映していない場合があります。情報に不明な点がある場合は、英語版を参照してください。
カテゴリー: 分析
期待されること
この連携機能により、Piano Analyticsのセグメントを使用してカスタージャーニーのどこからでもデータを分析できます。Contentsquareでは、すべてのContentsquare機能（ジャーニー分析、ページ比較、ゾーニング分析、セッションリプレイ）でPiano Analyticsのセグメントを使用できます。セグメントをインポートするには、Pianoコード構成にコードのスニペットを追加する必要があります。このコードは、Piano Analyticsにユニークな識別子をプッシュします。これにより、Piano AnalyticsのセッションとContentsquareのセッションを照合するのに役立ちます。
収集する情報
動的変数
| キー | 値 | データ型 |
| cs_matching_key | {csMatchingKey} | テキスト |
csMatchingKey
ContentsquareのセッションとPianoのセグメントをクロスリファレンスするために使用されるユニークな値を指します。
実装
実装手順
この連携機能を使用するには、以下のタスクを完了する必要があります:
- Piano AnalyticsでAPIキーを作成および取得する
- Piano Analyticsでcs_matching_keyプロパティを作成する
- site_idを取得する（オプション）
- Contentsquare側でPiano Analyticsを実装する
APIキーを作成および取得する
1. Piano Analyticsに移動し、'プロファイルを見る'をクリックします。
2. 'APIキー'タブを開き、'新しいAPIを作成'をクリックします。
3. 名前と説明を入力し、'新しいAPIキーを作成'ボタンをクリックします。
4. APIキーをコピーして安全な場所に保存し、 'このAPIキーを安全な場所にメモして保存したことを確認します'ボックスにチェックを入れます。
cs_matching_keyプロパティを作成する
1. Piano Analytics > 'データモデル' > 'ドラフト'に移動します。
2. 'ドラフトを作成'をクリックして、プロパティを作成するために必要なすべての情報を含むドラフトを作成します。
3. ドラフトページの上部で検証する前に、データ管理でプロパティをテストします。
- 検証前にプロパティキーとタイプを編集でき、タグ原則条件ブロックのみにリセットできます。
- プロパティにタグを付けても宣言されていない場合、データモデルに「プロパティドラフト」として追加されます。プロパティを編集して検証し、データを処理させる必要があります。
- プロパティはcs_matching_keyと呼ばれる必要があります（大文字と小文字を区別します）。
Site_IDを取得する
1. Piano Analytics > 'データクエリ'に移動します。
2. Contentsquareで使用するsite_idを取得するために、非常に基本的なデータセットを作成します：
- 境界 - すべての組織（または取得したいサイトのみを選択）
- プロパティサイト
- プロパティサイトID
- イベント（サイトのボリュームや他の任意の指標を取得するために推奨）
Contentsquare側で実装する
上記のステップをすでに完了している場合は、以下を継続します。
1. 'Pianoとの統合の前提条件を完了しました'にチェックを入れ、'追加'をクリックします。
2. 次のフィールドに入力し、'次へ'をクリックします。
- アクセスキー - Pianoの認証タブに移動してアクセスキーを見つけることができます。
- クライアントシークレット - クライアントシークレットはPianoによってログインに使用されます。
3. 統合の名前を付け、次のフィールドに入力してから'セグメントを選択'をクリックします。
- サイトID - サイトは、タグ付けプランの構造に基づいてアプリまたはウェブサイトに関する情報を保存するパラメータです。
- プロパティ - プロパティには 'cs_matching_key'を選択します。
4. Contentsquareと同期したいPianoで作成したセグメントを選択し、 '選択'をクリックします。
注: インポートされた「訪問者」、「ユーザー」、および「イベント」セグメントは自動的に更新されません。インポート時のセグメントの状態を反映します。定義を変更した場合は、統合を修正し、セグメントを再同期してください。
5. '統合を追加'をクリックします。
6. あなたの'インストール済み'タブにPiano Analyticsの統合が表示され、ステータスは'アクティブ'になります。
統合を編集する方法
統合を編集する方法については、この記事をお読みください。
セグメントの使用方法
1. セグメントが正常にインポートされると、セグメント機能で利用可能になり、'ソース'>'Piano'でフィルタリングして、すべてを一箇所で表示できます。
2. セグメントは、Contentsquareの機能全体で分析のコンテキストを設定する際に使用できます。以下の例に示すように;