GTMアナリティクス連携

WinkポータルにGTMコンテナIDを入力することで、任意のGoogle Tag Manager（GTM）コンテナをWinkに接続できます。接続後は、あなたの施設に対してコンテナが自動的に読み込まれ、Winkの予約イベントを直接読み取ります。これにより、検索から予約完了までのゲストの全旅程をカバーします。一般的な利用例はリターゲティングや広告用のSojernコンテナですが、どのGTMコンテナでも同様に機能します。

必要な手順

GTMコンテナIDを取得する

GTMコンテナID（形式はGTM-XXXXXXX）を入手してください。Sojernなどのパートナーからの場合は、ピクセルやタグIDではなくGTMコンテナIDを特に依頼してください。
Winkポータルに入力する

app.wink.travelにログインし、アカウントを選択してカスタマイズ設定を開きます。Analytics & integrationsセクションのGTM Container ID欄にGTMコンテナIDを貼り付けて保存します。これで連携が有効になります。
提供元に連携を確認してもらう

Sojernなどのパートナーからのコンテナの場合は、アカウントマネージャーに連携が有効になったことを伝えてください。彼らはwink.travel上でタグが正しく発火しているか、データがアカウントに流れているかを確認できます。

Wink側で行うこと

透明性のために、この連携を実現するためにWinkが設定している内容を説明します：

カスタマイズ設定のAnalytics & integrationsセクションにGTMコンテナID入力欄を用意しています。入力されたIDは形式（GTM-XXXXXXX）を検証し、施設情報に安全に保存されます。
施設が有効なすべてのWinkページで、コンテナがページに直接挿入されます。Winkのwindow.dataLayerを共有し、Wink自身のコンテナと並行して読み込まれ、追加設定は不要です。これはWinkチームの個別作業なしに自動で行われます。
コンテナは非同期で読み込まれるため、ゲストのページ読み込み速度に影響しません。
Winkのトラッキングとあなたのコンテナは並行して動作し、同じ共有dataLayerを読み取ります。Winkが追跡するすべての予約イベントは同時にあなたのコンテナでも利用可能です。
施設が閲覧されていない場合（例：ゲストが別のホテルを閲覧中）はコンテナは読み込まれず、施設に関連するデータのみを受け取ります。
予約完了（purchase）イベントはサンクスページのブラウザ上で発火します。 GTMコンテナIDはブラックボックスのため、Winkはサーバー側からGoogleに呼び出しを行いません。代わりに、コンテナ内のGA4やコンバージョンタグがクライアント側でpurchaseを受け取ります。決済プロバイダーがブラウザをリダイレクトするため、Winkはリダイレクトで中断された分析セッションをpurchase発火前に再接続し、売上を元の訪問に正しく紐付けます。

DataLayerリファレンス

Winkはゲストの旅程全体でGA4互換のイベントをdataLayerにプッシュします。あなたのGTMコンテナはこの共有dataLayerを読み取るため、設定したトリガーや変数は以下のすべてのプロパティにアクセス可能です。

各イベントは標準のGA4拡張Eコマース構造に従い、トップレベルにevent文字列とecommerceオブジェクトを持ちます。イベントプッシュ前にWinkは前回のecommerceペイロードをクリアし、古いデータが新しいトリガーに影響しないようにしています。

dataLayerリセットパターン

Winkはイベントプッシュ前にecommerceオブジェクトをリセットします：

dataLayer.push({ ecommerce: null });   // 前回のイベントをクリア
dataLayer.push({ event: '...', ecommerce: { ... } });

ecommerceプロパティがイベント間で持続することは期待しないでください。必ず同一イベント内のトリガー時に読み取ってください。

予約経路イベント

これらのイベントはゲストが予約ファネルを進む際に自動で発火します。GTMトリガーは以下のイベント名に一致するカスタムイベントトリガーとして設定してください。

ステップ	イベント	発火タイミング
1	`view_item_list`	ホテル在庫のグリッドまたはリストが読み込まれた時
2	`view_item`	ゲストが特定の施設ページを閲覧した時
3	`add_to_cart`	ゲストが部屋をカートに追加した時
4	`begin_checkout`	チェックアウト／支払いページが読み込まれた時
5	`add_payment_info`	ゲストが支払い方法を選択した時
6	`login`	ゲストがSSOで認証した時
7	`purchase`	予約が確定した時
8	`refund`	予約がキャンセルされた時

`view_item_list`

ホテル在庫のグリッドまたはリストが表示された時に発火。

{
  "event": "view_item_list",
  "ecommerce": {
    "item_list_id": "featured_hotels",
    "item_list_name": "Featured Hotels",
    "items": [ ]
  }
}

`view_item`

ゲストが特定の施設を閲覧した時に発火。

{
  "event": "view_item",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

`add_to_cart`

ゲストが部屋をカートに追加した時に発火。

{
  "event": "add_to_cart",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

`begin_checkout`

チェックアウト／支払いページが読み込まれた時に発火。

{
  "event": "begin_checkout",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "coupon": "SUMMER10",
    "items": [ ]
  }
}

couponは割引コードが適用された場合のみ含まれます。

`add_payment_info`

ゲストが支払い方法を選択または確定した時に発火。

{
  "event": "add_payment_info",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "coupon": "SUMMER10",
    "payment_type": "STRIPE",
    "items": [ ]
  }
}

payment_typeは支払い取得者のタイプから設定されます。couponは割引コード適用時のみ含まれます。

`login`

ゲストがシングルサインオンで認証した時に発火。

{
  "event": "login",
  "ecommerce": {
    "method": "IAM"
  }
}

`purchase`

予約が確定した時に発火。

{
  "event": "purchase",
  "ecommerce": {
    "currency": "USD",
    "transaction_id": "bc-a1b2c3d4",
    "value": 299.00,
    "coupon": "SUMMER10",
    "shipping": 0.00,
    "tax": 0.00,
    "items": [
      {
        "item_id": "rr-xyz789",
        "item_name": "Deluxe Ocean Suite",
        "item_brand": "Grand Resort",
        "item_category": "GUEST_ROOM",
        "price": 299.00,
        "quantity": 1,
        "property_id": "prop-abc123",
        "property_name": "Grand Resort Maldives",
        "property_brand": "Grand Collection",
        "property_chain": "Luxury Hotels International",
        "city_name": "Malé",
        "country_code": "MV",
        "start_date": "2026-06-01",
        "end_date": "2026-06-05",
        "num_adults": 2,
        "num_children": 0,
        "cancellation_policy": "Refundable",
        "rate_plan_id": "rp-summer2026",
        "room_rate_id": "rr-xyz789",
        "room_rate_name": "Summer Escape — Bed & Breakfast",
        "num_perks": 2,
        "room_location": "Overwater",
        "room_view": "Ocean",
        "room_classification": "Suite"
      }
    ]
  }
}

transaction_idは予約契約の一意識別子です。coupon、shipping、taxは該当時のみ含まれます。

`refund`

予約がキャンセルされた時に発火。

{
  "event": "refund",
  "ecommerce": {
    "currency": "USD",
    "transaction_id": "bc-a1b2c3d4",
    "value": 299.00,
    "coupon": "SUMMER10",
    "shipping": 0.00,
    "tax": 0.00,
    "items": [ ]
  }
}

transaction_idは同一予約のpurchaseイベントと一致します。coupon、shipping、taxは該当時のみ含まれます。

アイテムプロパティ

items配列を含むすべてのイベントは同じアイテムスキーマを共有します。すべてのプロパティは任意ですが、必須のものは明記しています。

標準GA4フィールド

これらはGA4がネイティブに理解し、追加設定なしに標準Eコマースレポートに表示されます。

プロパティ	型	必須	説明
`item_id`	string	必須	部屋または商品の一意識別子
`item_name`	string	—	部屋または商品の名称
`affiliation`	string	—	アフィリエイトまたは販売者名
`coupon`	string	—	アイテムに適用されたクーポンコード
`currency`	string	—	ISO 4217通貨コード（例：`USD`）
`creative_name`	string	—	プロモーションで使用されたクリエイティブ名
`creative_slot`	string	—	プロモーションクリエイティブのスロット位置
`discount`	number	—	適用された割引額
`index`	number	—	リスト内の位置（1始まり）
`item_brand`	string	—	ホテルまたはブランド名
`item_category`	string	—	商品タイプ（例：`GUEST_ROOM`、`ACTIVITY`、`ATTRACTION`、`MEETING_ROOM`、`RESTAURANT`、`SPA`）
`item_list_id`	string	—	このアイテムが属するリストの識別子
`item_list_name`	string	—	リストの表示名
`location_id`	string	—	施設の地理座標
`price`	number	—	単価
`promotion_id`	string	—	プロモーションの識別子
`promotion_name`	string	—	プロモーションの表示名
`quantity`	number	—	数量（デフォルトは`1`）

カスタムアイテムスコープパラメータ

これらはWink固有の予約コンテキストを含みます。GA4はこれらを自動的にレポートに表示しないため、レポートや探索で使用するにはGA4プロパティでアイテムスコープのカスタムディメンションとして登録する必要があります。設定方法は以下のGA4のカスタムディメンションを参照してください。

プロパティ	型	説明
`property_id`	string	Wink施設識別子
`property_name`	string	施設表示名
`property_brand`	string	施設が属するブランド
`property_chain`	string	施設が属するチェーン
`property_url_name`	string	施設のURL用スラッグ
`city_name`	string	施設所在地の都市名
`country_code`	string	ISO 3166-1 alpha-2国コード
`start_date`	string	チェックイン日（`YYYY-MM-DD`形式）
`end_date`	string	チェックアウト日（`YYYY-MM-DD`形式）
`num_adults`	number	予約の大人人数
`num_children`	number	予約の子供人数
`cancellation_policy`	string	`Refundable`、`Non-Refundable`、`Refundable-With-Restrictions`、`Non-Refundable-With-Restrictions`のいずれか
`rate_plan_id`	string	レートプラン識別子
`room_rate_id`	string	特定の部屋レート識別子
`room_rate_name`	string	部屋レートの表示名
`num_perks`	number	レートに含まれる特典数
`room_location`	string	部屋の位置（例：`Overwater`、`Garden`）
`room_view`	string	部屋の眺望（例：`Ocean`、`City`）
`room_classification`	string	部屋の分類やランク（例：`Suite`、`Standard`）
`bed_type`	string	部屋のベッド構成（例：`King`、`Twin`）

GA4のカスタムディメンション

GA4はカスタムアイテムパラメータを、明示的にアイテムスコープのカスタムディメンションとして登録しない限りレポートに反映しません。すべての20項目を登録する必要はなく、レポートで使いたいものだけ登録してください。

カスタム定義を開く

GA4で、左下の歯車アイコンの管理 → プロパティを選択 → データ表示 → カスタム定義へ進みます。
新しいカスタムディメンションを作成

カスタムディメンションを作成をクリックします。
ディメンションの詳細を入力
- ディメンション名 — GA4レポートに表示される人間が読めるラベル（下表参照）
- スコープ — アイテムを選択
- イベントパラメータ — dataLayerに出てくる正確なパラメータ名（下表参照）
- 説明 — 任意ですが推奨
保存して繰り返す

保存をクリックし、追跡したいパラメータごとに繰り返します。

カスタムディメンション作成時の参照用テーブルです。イベントパラメータは大文字小文字を区別し、正確に一致させてください。

ディメンション名	イベントパラメータ	型
施設ID	`property_id`	テキスト
施設名	`property_name`	テキスト
施設ブランド	`property_brand`	テキスト
施設チェーン	`property_chain`	テキスト
施設URL名	`property_url_name`	テキスト
都市名	`city_name`	テキスト
国コード	`country_code`	テキスト
チェックイン日	`start_date`	テキスト
チェックアウト日	`end_date`	テキスト
大人人数	`num_adults`	数値
子供人数	`num_children`	数値
キャンセルポリシー	`cancellation_policy`	テキスト
レートプランID	`rate_plan_id`	テキスト
部屋レートID	`room_rate_id`	テキスト
部屋レート名	`room_rate_name`	テキスト
特典数	`num_perks`	数値
部屋の位置	`room_location`	テキスト
部屋の眺望	`room_view`	テキスト
部屋の分類	`room_classification`	テキスト
ベッドタイプ	`bed_type`	テキスト

その他利用可能なイベント

以下のイベントはWinkのdataLayerに存在しますが、標準の予約ファネルには含まれません。プラットフォーム上の他の操作で発火する可能性があります。

`add_to_wishlist`

{
  "event": "add_to_wishlist",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

`remove_from_cart`

{
  "event": "remove_from_cart",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

`select_item`

{
  "event": "select_item",
  "ecommerce": {
    "item_list_id": "featured_hotels",
    "item_list_name": "Featured Hotels",
    "items": [ ]
  }
}

`view_cart`

{
  "event": "view_cart"
}

このイベントにはecommerceペイロードは含まれません。

`view_promotion`

{
  "event": "view_promotion",
  "ecommerce": {
    "creative_name": "Summer Banner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Summer Sale",
    "items": [ ]
  }
}

`select_promotion`

{
  "event": "select_promotion",
  "ecommerce": {
    "creative_name": "Summer Banner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Summer Sale",
    "items": [ ]
  }
}

`search`

{
  "event": "search",
  "ecommerce": {
    "search_term": "beachfront resort"
  }
}

`select_content`

{
  "event": "select_content",
  "ecommerce": {
    "content_type": "hotel",
    "content_id": "prop_12345"
  }
}

`share`

{
  "event": "share",
  "ecommerce": {
    "method": "copy_link",
    "content_type": "hotel",
    "item_id": "prop_12345"
  }
}

`sign_up`

{
  "event": "sign_up",
  "ecommerce": {
    "method": "email"
  }
}

`generate_lead`

{
  "event": "generate_lead",
  "ecommerce": {
    "currency": "USD",
    "value": 0.00
  }
}

`join_group`

{
  "event": "join_group",
  "ecommerce": {
    "group_id": "group_abc"
  }
}

`earn_virtual_currency`

{
  "event": "earn_virtual_currency",
  "ecommerce": {
    "virtual_currency_name": "WinkPoints",
    "value": 100
  }
}

`spend_virtual_currency`

{
  "event": "spend_virtual_currency",
  "ecommerce": {
    "virtual_currency_name": "WinkPoints",
    "value": 50,
    "item_name": "Room Upgrade"
  }
}

`level_start`

{
  "event": "level_start",
  "ecommerce": {
    "level_name": "Gold"
  }
}

`level_end`

{
  "event": "level_end",
  "ecommerce": {
    "level_name": "Gold",
    "success": true
  }
}

`level_up`

{
  "event": "level_up",
  "ecommerce": {
    "level": 2,
    "character": "traveler"
  }
}

`post_score`

{
  "event": "post_score",
  "ecommerce": {
    "score": 980,
    "level": 2,
    "character": "traveler"
  }
}

`unlock_achievement`

{
  "event": "unlock_achievement",
  "ecommerce": {
    "achievement_id": "first_booking"
  }
}

`tutorial_begin`

{
  "event": "tutorial_begin",
  "ecommerce": {}
}

`tutorial_complete`

{
  "event": "tutorial_complete",
  "ecommerce": {}
}

`virtualPageView`

これはWink独自のカスタムイベントで、標準のGA4イベントセットには含まれません。すべてのページ遷移でプッシュされ、デバイスやセッションのコンテキストを含みます。ecommerceオブジェクトは含みません。

{
  "event": "virtualPageView",
  "device": "Desktop",
  "deviceAgent": "Mozilla/5.0 ...",
  "os": "MacOS",
  "path": "/hotels/grand-resort",
  "title": "Grand Resort — Wink",
  "userId": "user_abc123",
  "startDate": "2026-06-01",
  "endDate": "2026-06-05",
  "guests": "2",
  "rooms": "1"
}

プロパティ	説明
`device`	検出されたデバイスタイプ — `Desktop`、`Android`、`iPhone`、`iPad`など
`deviceAgent`	生のユーザーエージェント文字列
`os`	検出されたOS — `Windows`、`MacOS`、`Linux`、`UNIX`
`path`	現在のページパス
`title`	現在のページタイトル
`userId`	認証済みユーザー識別子（未ログイン時は省略）
`startDate`	現在の検索セッションのチェックイン日
`endDate`	現在の検索セッションのチェックアウト日
`guests`	現在の検索セッションのゲスト人数
`rooms`	現在の検索セッションの部屋数