コンバージョンゴールを定義する
ゴールは、アナリティクスイベントに対する名前付きルールです。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 への訪問をコンバージョンとして数えます。
acme-marketing で、パスがちょうど /thanks の pageview ゴールが
直近 28 日にどうだったかを確認して。ボットは除外して。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
}
EOFcurl -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. ゴールを保存する
acme-marketing に、表示名 "Reached thank-you page"、スラッグ
reached-thanks で、いま確認した pageview ルールのゴールを作成して。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"
}
EOFcurl -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 にできます。
プロパティ句は完全一致です。
{
"properties": [
{ "key": "plan", "op": "eq", "value": "pro" }
]
}プロパティは先に宣言しておく必要があります。プロパティ名の打ち間違いで、永久に空のゴールが静かに作られるのを防ぎます。
観測されたキーを昇格させるには アナリティクスプロパティを宣言する を参照してください。
ゴールを変えると履歴も変わる
述語を編集すると definition_version が増え、保持中のイベントが新しいルールで再評価されます。そのため過去のコンバージョン数も変わり得ます。Edge は変更を記録し、照会範囲内で定義が変わったことを報告します。
もう使わないゴールはアーカイブしてください。アーカイブすると監査履歴は残りますが、 アナリティクスイベントは削除されません。