ファネルを構築する
ファネルは既存のゴールをステップに並べ、各ステップに到達したセッション数を測ります。 ファネルはアナリティクス group に属します。埋め込みフォームのあとにサイト上のサンクスページが続く、といったように、ジャーニーが distribution をまたぐことがあるためです。
ファネルの作成はウェブコンソールではできません。エージェント、CLI、または API を使い、結果は Analytics → Conversions → Funnels で読みます。各ステップの goal id も必要です。種別 が data のものはファネルのメンバーになれません。
1. distribution をグループに入れる
1 つの distribution 上のジャーニーなら、エージェントはその暗黙のグループを使えます。distribution をまたぐジャーニーでは、明示的なグループを作成します。
マーケティングサイトとサインアップ埋め込みの distribution を含む、
"Acme signup journey" というアナリティクスグループを作成して。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"
]
}
EOFcurl -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 を付けます。装飾されていないクロスサイトのゼロを、誰もコンバージョンしなかった証拠と見なさないでください。
保存する前に、候補の定義を確認します。
Acme signup グループで、料金ページ閲覧のあとサインアップ完了までを
1 セッション内でたどる sequential ファネルを確認して。ボットは除外して。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"
}
]
}
EOFcurl -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. ファネルを保存する
同じ定義を、スラッグと表示名付きでグループのファネルコレクションに送ります。
確認したファネルを、表示名 "Pricing to signup"、スラッグ
pricing-to-signup で保存して。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"
}
]
}
EOFcurl -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 です。
最初のステップが入った母集団です。以降の各ステップは、その母集団からの完了と離脱を示します。明示的に含めない限り、ボットは除外されます。
ファネル定義を変えるとバージョンが増え、保持期間内の過去の結果も変わり得ます。別のジャーニーにスラッグを使い回すのではなく、もう使わない定義はアーカイブしてください。