Skip to content

ファネルを構築する ​

ファネルは既存のゴールをステップに並べ、各ステップに到達したセッション数を測ります。 ファネルはアナリティクス group に属します。埋め込みフォームのあとにサイト上のサンクスページが続く、といったように、ジャーニーが distribution をまたぐことがあるためです。

ファネルの作成はウェブコンソールではできません。エージェント、CLI、または API を使い、結果は Analytics → Conversions → Funnels で読みます。各ステップの goal id も必要です。種別 が data のものはファネルのメンバーになれません。

1. distribution をグループに入れる ​

1 つの distribution 上のジャーニーなら、エージェントはその暗黙のグループを使えます。distribution をまたぐジャーニーでは、明示的なグループを作成します。

text
マーケティングサイトとサインアップ埋め込みの distribution を含む、
"Acme signup journey" というアナリティクスグループを作成して。
bash
edge api POST /v1/groups --input - <<'EOF'
{
        "slug": "acme-signup",
        "display_name": "Acme signup journey",
        "distribution_ids": [
          "d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38",
          "92ab45ce-61d8-4f23-a9b0-cc3128e7d456"
        ]
      }
EOF
bash
curl -s -X POST https://api.edge.deca-dev.com/v1/groups \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "slug": "acme-signup",
        "display_name": "Acme signup journey",
        "distribution_ids": [
          "d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38",
          "92ab45ce-61d8-4f23-a9b0-cc3128e7d456"
        ]
      }'

エージェントは edge_group_create を実行します。メンバーはすべて、 現在のワークスペースに属している必要があります。

2. ステップとウィンドウを定義する ​

各ステップは、グループメンバー上のゴールを参照します。ファネルには 2〜8 ステップが必要です。

次から選びます。

  • sequential — 間に別のイベントがあっても、ステップがこの順で起きればよい。
  • strict — 途中に失格となるステップを挟まず、定義した経路をたどる必要がある。
  • session — 固定の 30 分コンバージョンウィンドウ。
  • fixed — 24 hours や 7 days のような正の期間。

distribution をまたぐステップと、24 時間を超える固定ウィンドウでは、Edge がジャーニーの識別子を引き継げるよう、装飾済みリンクが必要です。Edge はそのステップに requires_decoration を付けます。装飾されていないクロスサイトのゼロを、誰もコンバージョンしなかった証拠と見なさないでください。

保存する前に、候補の定義を確認します。

text
Acme signup グループで、料金ページ閲覧のあとサインアップ完了までを
1 セッション内でたどる sequential ファネルを確認して。ボットは除外して。
bash
edge api POST /v1/groups/6a317fca-7df0-41e2-a768-39a2bf51d807/funnels/check --input - <<'EOF'
{
        "mode": "sequential",
        "window_kind": "session",
        "interval": "30 minutes",
        "range": { "preset": "last_28_days" },
        "include_bots": false,
        "steps": [
          {
            "distribution_id": "d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38",
            "goal_id": "2aa61840-c3dc-42ec-9672-f5b872cd71e0"
          },
          {
            "distribution_id": "92ab45ce-61d8-4f23-a9b0-cc3128e7d456",
            "goal_id": "70a113ee-bddc-41b7-9814-674518735e23"
          }
        ]
      }
EOF
bash
curl -s -X POST \
  https://api.edge.deca-dev.com/v1/groups/6a317fca-7df0-41e2-a768-39a2bf51d807/funnels/check \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "mode": "sequential",
        "window_kind": "session",
        "interval": "30 minutes",
        "range": { "preset": "last_28_days" },
        "include_bots": false,
        "steps": [
          {
            "distribution_id": "d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38",
            "goal_id": "2aa61840-c3dc-42ec-9672-f5b872cd71e0"
          },
          {
            "distribution_id": "92ab45ce-61d8-4f23-a9b0-cc3128e7d456",
            "goal_id": "70a113ee-bddc-41b7-9814-674518735e23"
          }
        ]
      }'

エージェントは edge_funnel_check を実行します。確認ではメンバーシップ、 コンテンツ能力、ゴールの所有、プロパティフィルターを検証し、ファネルは保存しません。

3. ファネルを保存する ​

同じ定義を、スラッグと表示名付きでグループのファネルコレクションに送ります。

text
確認したファネルを、表示名 "Pricing to signup"、スラッグ
pricing-to-signup で保存して。
bash
edge api POST /v1/groups/6a317fca-7df0-41e2-a768-39a2bf51d807/funnels --input - <<'EOF'
{
        "slug": "pricing-to-signup",
        "display_name": "Pricing to signup",
        "mode": "sequential",
        "window_kind": "session",
        "interval": "30 minutes",
        "steps": [
          {
            "distribution_id": "d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38",
            "goal_id": "2aa61840-c3dc-42ec-9672-f5b872cd71e0"
          },
          {
            "distribution_id": "92ab45ce-61d8-4f23-a9b0-cc3128e7d456",
            "goal_id": "70a113ee-bddc-41b7-9814-674518735e23"
          }
        ]
      }
EOF
bash
curl -s -X POST \
  https://api.edge.deca-dev.com/v1/groups/6a317fca-7df0-41e2-a768-39a2bf51d807/funnels \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "slug": "pricing-to-signup",
        "display_name": "Pricing to signup",
        "mode": "sequential",
        "window_kind": "session",
        "interval": "30 minutes",
        "steps": [
          {
            "distribution_id": "d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38",
            "goal_id": "2aa61840-c3dc-42ec-9672-f5b872cd71e0"
          },
          {
            "distribution_id": "92ab45ce-61d8-4f23-a9b0-cc3128e7d456",
            "goal_id": "70a113ee-bddc-41b7-9814-674518735e23"
          }
        ]
      }'

エージェントは edge_funnel_create を実行します。

4. 照会して読む ​

edge_funnel_query または POST /v1/groups/{group_id}/funnels/{funnel_id}/query を使います。照会モードは snapshot、trend、step_trend、compare です。

最初のステップが入った母集団です。以降の各ステップは、その母集団からの完了と離脱を示します。明示的に含めない限り、ボットは除外されます。

ファネル定義を変えるとバージョンが増え、保持期間内の過去の結果も変わり得ます。別のジャーニーにスラッグを使い回すのではなく、もう使わない定義はアーカイブしてください。

次に読む ​