Skip to content

コンバージョンゴールを定義する ​

ゴールは、アナリティクスイベントに対する名前付きルールです。Edge は照会時にルールを評価するため、新しいゴールでも保持期間内の既存イベントを集計できます。

ゴールの作成はウェブコンソールではできません。エージェント、CLI、または API を使ってください。できたコンバージョンは、コンソールの Analytics → Conversions → Goals ビューに現れます。

1. 何を数えるかを決める ​

ゴールの種別は pageview、custom_event、outbound_link、file_download、 form_submission、not_found です。

distribution の 種別 によって、発火できるものが決まります。

  • site と page はすべてのゴール種別をサポートします。
  • embed_script と embed_iframe はカスタムイベントとフォーム送信をサポートします。リンク、ダウンロード、not-found のゴールは使えますが、既定では推奨されません。
  • data はゴールをサポートしません。

Edge は、一度もコンバージョンし得ないゴールを作るのではなく、非互換な定義を拒否します。

2. 既存イベントに対してルールを確認する ​

この例では、/thanks への訪問をコンバージョンとして数えます。

text
acme-marketing で、パスがちょうど /thanks の pageview ゴールが
直近 28 日にどうだったかを確認して。ボットは除外して。
bash
edge api POST /v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/goals/check --input - <<'EOF'
{
        "goal_type": "pageview",
        "predicate": {
          "path": { "op": "eq", "value": "/thanks" }
        },
        "source_constraint": "any",
        "range": { "preset": "last_28_days" },
        "include_bots": false
      }
EOF
bash
curl -s -X POST \
  https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/goals/check \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "goal_type": "pageview",
        "predicate": {
          "path": { "op": "eq", "value": "/thanks" }
        },
        "source_constraint": "any",
        "range": { "preset": "last_28_days" },
        "include_bots": false
      }'

エージェントは edge_goal_check を実行します。結果には合計とユニークの コンバージョン、コンバージョン率、一致イベントの小さなサンプルが含まれます。確認では何も保存されません。

パスルールは eq、prefix、matches をサポートします。matches では * が 1 つのパス セグメントに、** が残りの任意のセグメントに一致します。

3. ゴールを保存する ​

text
acme-marketing に、表示名 "Reached thank-you page"、スラッグ
reached-thanks で、いま確認した pageview ルールのゴールを作成して。
bash
edge api POST /v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/goals --input - <<'EOF'
{
        "slug": "reached-thanks",
        "display_name": "Reached thank-you page",
        "description": "A visitor reached the post-signup thank-you page.",
        "goal_type": "pageview",
        "predicate": {
          "path": { "op": "eq", "value": "/thanks" }
        },
        "source_constraint": "any"
      }
EOF
bash
curl -s -X POST \
  https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/goals \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "slug": "reached-thanks",
        "display_name": "Reached thank-you page",
        "description": "A visitor reached the post-signup thank-you page.",
        "goal_type": "pageview",
        "predicate": {
          "path": { "op": "eq", "value": "/thanks" }
        },
        "source_constraint": "any"
      }'

エージェントは edge_goal_create を実行します。次の照会が読み込む時点で Analytics に現れます。待つべきバックフィルジョブはありません。

イベントとプロパティのルール ​

custom_event ゴールには正確な event_name が必要です。form_submission ゴールの既定は サーバーイベントです。ゴール種別が許す範囲で、source_constraint は any、client、server にできます。

プロパティ句は完全一致です。

json
{
  "properties": [
    { "key": "plan", "op": "eq", "value": "pro" }
  ]
}

プロパティは先に宣言しておく必要があります。プロパティ名の打ち間違いで、永久に空のゴールが静かに作られるのを防ぎます。

観測されたキーを昇格させるには アナリティクスプロパティを宣言する を参照してください。

ゴールを変えると履歴も変わる ​

述語を編集すると definition_version が増え、保持中のイベントが新しいルールで再評価されます。そのため過去のコンバージョン数も変わり得ます。Edge は変更を記録し、照会範囲内で定義が変わったことを報告します。

もう使わないゴールはアーカイブしてください。アーカイブすると監査履歴は残りますが、 アナリティクスイベントは削除されません。

次に読む ​