設定すること
- Measurement Protocol 経由で GA4 へのサーバーサイドコンバージョン転送 — 広告ブロッカーを使用しているユーザーにも対応。
- GA4 データストリーム設定から生成した Measurement Protocol API secret。
- 自動イベントマッピング: Elido のコンバージョンイベントが GA4 の組み込み収益化レポートで
purchaseとして表示されます。
Elido は、Measurement Protocol を使用してサーバー側で GA4 にコンバージョンイベントを送信します。これは、ユーザーが広告ブロッカーを使用しているかどうかに関係なく、ページにJavaScript がなくてもコンバージョンが GA4 に表示されることを意味します。
必要なもの#
- GA4 プロパティ (ユニバーサルアナリティクスではありません)。
- プロパティの管理パネルへのアクセス。
- 約5分。
ステップ 1 — Measurement ID を見つける#
- Google Analytics にアクセスします。
- 管理 (左下の歯車アイコン) をクリックします。
- プロパティの下にあるデータストリーム → ウェブをクリックします。
- ウェブデータストリームをクリックします。
- Measurement ID をコピーします —
G-で始まり、例:G-XXXXXXXXXX。
ステップ 2 — Measurement Protocol API secret を作成する#
同じデータストリームページで：
- Measurement Protocol API secrets までスクロールします。
- 作成をクリックします。
- 名前を付けて ("Elido")、作成をクリックします。
- シークレットの値をコピーします。これは一度しか表示されません。紛失した場合は、新しいものを作成してください — 古いシークレットは削除するまで機能し続けます。
ステップ 3 — Elido で設定する#
- ダッシュボード → コンバージョン → GA4 → 転送を設定に移動します。
- Measurement ID と API secret を貼り付けます。
- 保存をクリックします。Elido はすぐにテストイベント (
elido_test) を GA4 に送信します。
Elido がclient_idをマッピングする方法#
GA4 は、イベントをユーザーに紐付けるために client_id を必要とします。Elido はこれを次から派生させます：
- ショートリンクのランディングページが
_gaクッキーを設定しており、その値がコンバージョンピクセル経由で送り返される場合 — Elido はそれを直接読み取ります。 - それ以外の場合、Elido は Elido の
click_id(例:clk_abc123) を安定したUUID形式の文字列にハッシュ化し、それをclient_idとして使用します。
これは、GA4 がこれらのイベントを既存の GA4 ウェブセッションと一致しない可能性のある「ユーザー」の下に表示することを意味します — それらは結合されません。完全なセッション結合のためには、_ga クッキーの値をサーバーに渡し、Elido の Conversions API コール に含めてください。
GA4 のイベント名#
Elido はこれらのイベントを転送します：
| Elido イベント | GA4 イベント名 |
|---|---|
conversion.recorded | purchase (値 + 通貨付き) |
link.clicked (有効な場合) | elido_click |
threshold.exceeded | elido_threshold |
purchase イベントは、GA4 に収益化セクションで組み込みのレポートがあるため使用されます。すべてのイベントには、イベントパラメータとして utm_source、utm_medium、utm_campaign が含まれます。
トラブルシューティング#
リアルタイムにイベントが表示されない — Measurement ID と API secret を確認してください。間違った API secret は HTTP 204 (コンテンツなし) を返しますが、GA4 はペイロードをサイレントに破棄します。Measurement Protocol エンドポイントを直接呼び出して確認してください：
curl -X POST \
"https://www.google-analytics.com/debug/mp/collect?measurement_id=G-XXXX&api_secret=YOUR_SECRET" \
-H "Content-Type: application/json" \
-d '{"client_id":"test","events":[{"name":"elido_test","params":{}}]}'
デバッグ呼び出しが成功すると {"validationMessages":[]} が返されます。
リアルタイムにはイベントが表示されるが、通常のレポートには表示されない — Measurement Protocol イベントが非リアルタイムの GA4 レポートに表示されるまでには、24〜48時間かかることがあります。これは GA4 の制限であり、Elido の問題ではありません。
購入イベントの通貨が間違っている — Elido は、コンバージョンイベントの currency フィールドから通貨を読み取ります。デフォルトは EUR です。あなたの コンバージョン記録 API コール で明示的に設定してください。
重複イベント — あなたのサイトがクライアント側でも GA4 purchase イベントを発火している場合、重複して表示されます。クライアント側のイベントを無効にするか、Elido のマッピング設定で別のイベント名を使用してください。