GTM4WP – A Google Tag Manager (GTM) plugin for WordPress

変更履歴

1.22.3

• 修正: WooCommerce の select_item イベントのタイムアウトが 0 のとき、ブラウザの商品ページ読み込みを妨げないよう変更。
• 修正: select_item の eventCallback のタイムアウトが正しく読み取れなかった問題。

1.22.2

• 修正: テンプレートで is_order_received_page() が使えずフォールバックが動いた場合に purchase イベントが発火しなかった問題。

1.22.1

• 修正: 購入追跡に関する追加の修正。Khnaz35 に感謝。

1.22

• 追加: select_item イベントのタイムアウトを変更する WooCommerce オプション。アドブロック利用時の UX 改善に役立つ場合があります。
• 追加: default コマンドの Consent Mode フラグを上書きする WordPress フィルター GTM4WP_WPFILTER_OVERWRITE_COMO_FLAG / gtm4wp_overwrite_consent_mode_flag。同意バナープラグインのサポート負担軽減に利用可能。
• 修正: コンテナ配置をオフにし gtm4wp_the_gtm_tag() を手動呼び出しした際にフロントに不要な出力が出る問題。Michael Bourne に感謝。
• 修正: Bricks テンプレートと WooCommerce 併用時にカート追加の追跡が壊れていた問題。
• 更新: 同梱の WhichBrowser ライブラリを最新版に。PHP エラー対応の暫定措置で、長期的には Matomo Device Detector への移行を予定。
• 更新: GTM コンテナパスに / 文字を許可 (same tag gateway 対応)。
• 更新 / 修正: WooCommerce の購入追跡を v1.20 以前のロジックに戻しました (新方式の方が問題を増やしたため)。影響を受けた方にはお詫びします。

1.21.1

• 修正: product_qty 未定義により add_to_cart が阻害される場合がある問題。diegoarda に感謝。
• 修正: WebToffee 連携がレガシー 2.x 製品ラインにのみ必要である旨を明記。
• 修正: サイト内検索の追跡での反射型 XSS。godzeo に感謝 !

1.21

!!! 警告 !!!
WooCommerce 連携に大きな変更があります。
テーマが必須フック woocommerce_thankyou をサポートしているか確認してください。

• 追加: 可変商品のページ読み込み時に親商品データで view_item を発火する WooCommerce オプション。
• 追加: WooCommerce の可変商品で item_group_id に親商品 ID を含める。
• 追加: CSP 用に script に nonce を付与する GTM4WP_WPFILTER_GET_CSP_NONCE (定数) / gtm4wp_get_csp_nonce フィルター。
• 更新: purchase イベントを woocommerce_thankyou で発火するよう変更。実行タイミングが同意状態チェックの後になるため、より多くの環境で正しく動作します。
• 更新: GTM4WP_WPFILTER_EEC_ORDER_DATA / gtm4wp_eec_order_data フィルターに、$order_data の後に WC_Order 全体を渡す第2引数を追加。
• 更新: カートに商品がない場合、バックエンドから view_cart / begin_checkout を発火しないように変更。WooCommerce フック未対応テーマでの誤計測を防止。
• 修正: 管理画面での load_plugin_textdomain() 関連の PHP 通知。

1.20.3

• 修正: 「_load_textdomain_just_in_time was called incorrectly」通知 – WordPress 6.7 互換。

1.20.2

• 修正: 商品バリエーションの追跡で誤った ID パラメータ (item_id ではなく id)。micmaf に感謝。
• 修正: 商品一覧で「オプションを選択」「商品を見る」クリック時は add_to_cart を計測しないよう変更。
• 修正: WooCommerce でカート数更新時の JavaScript 参照エラー。Sakuk3 に感謝。
• 修正: customerBillingEmailHash を orderData.customer.billing.email_hash と同様にハッシュ (拡張コンバージョンは orderData の値を使用)。
• 追加: GTM4WP 管理画面に必要な WooCommerce の最低バージョン (現状 5.0+) を表示。

1.20.1

• 修正: コンテナ配置がオフかつ console.log もオフの場合に GTM を読み込まないよう変更。morvy に感謝。
• 修正: EC データレイヤーの item_id を数値に変換していた変更を元に戻し、他連携との互換のため文字列のまま保持。
• 修正: スクロールトラッキングで要素 ID が不正なときの JavaScript エラー。
• 変更: WooCommerce と orderData 変数でのユーザーデータ正規化・ハッシュを改善 (拡張コンバージョン向け)。
• 変更: PHP コードの最適化 (hans2103)。
• 追加: WooCommerce 注文完了ページの orderData を変更するフィルター。GTM4WP_WPFILTER_EEC_ORDER_DATA 定数または gtm4wp_eec_order_data 文字列で利用。

1.20

大規模クリーンアップリリース !

非推奨機能を多数削除しました。
WooCommerce 連携のコードを整理・再構成したため、GTM4WP の内部データ構造に依存したカスタムコードがある場合は、本番の前にステージングなどで更新してください !

• 削除: WooCommerce 向け非推奨 Universal Analytics イベント。
• 削除: 非推奨フィルター GTM4WP_WPFILTER_AFTER_DATALAYER/gtm4wp_after_datalayer。
• 削除: 非推奨フィルター GTM4WP_WPFILTER_ADDGLOBALVARS/gtm4wp_add_global_vars。
• 削除: ブラウザの「追跡しない」をデータレイヤーに載せる非推奨機能 (ブラウザ機能自体が非推奨のため削除)。
• 削除: 非推奨の Google Optimize 連携。
• 削除: 非推奨定数 GTM4WP_OPTION_BLACKLIST_MACRO_* および GTM4WP_OPTION_BLACKLIST_。
• 削除: 非推奨の WordPress フィルター GTM4WP_WPFILTER_GETTHEGTMTAG (v1.16 で非推奨)。
• 変更: 内部の関数名・変数名を多数変更。依存は非推奨ですが、使っていた場合はコードを確認してください。
• 変更: WP フィルター gtm4wp_datalayer_on_pageload を gtm4wp_woocommerce_datalayer_on_pageload に改名 (呼び出しタイミングを明確化)。
• 変更: WooCommerce 連携の orderData データレイヤーに、拡張コンバージョン向けキーを追加:
  • orderData.customer.billing.first_name_hash
  • orderData.customer.billing.last_name_hash
  • orderData.customer.billing.phone_hash
• 非推奨: orderData.customer.billing.emailhash。orderData.customer.billing.email_hash (アンダースコア) に更新してください。
• 追加: 各 EC アクションの商品配列に stockstatus キー。WP_Product->get_stock_status() の値。hans2103 に感謝。
• 追加: WebToffee GDPR Cookie Consent プラグイン連携。同意の変更時や保存済み同意の読み込み時に GTM イベントを発火できます。
• 修正: ページ上で未発火の場合、チェックアウト送信時に add_payment_info / add_shipping_info が発火しなかった問題。
• 修正: IP アドレスは REMOTE_ADDR のみ参照。プラグイン設定でカスタム HTTP ヘッダーを指定可能。

1.19.1

• 修正: 商品カテゴリー判定時の追加チェックで特定ケースの PHP エラーを防止。
• 修正: 管理画面説明文の Consent Mode フラグ名の誤り。

1.19

警告 !
Universal Analytics / GA3 の EC イベントは 非推奨 です !
次の GTM4WP イベントや旧 EC データレイヤーに依存しないよう GTM を更新してください:
* gtm4wp.productClickEEC
* gtm4wp.addProductToCartEEC
* gtm4wp.removeFromCartEEC
* gtm4wp.checkoutOptionEEC
* gtm4wp.checkoutStepEEC
* gtm4wp.changeDetailViewEEC
* gtm4wp.orderCompletedEEC

上記イベントの代わりに、新しい GA4 の EC イベント (add_to_cart、purchase など) を使えます。
Universal Analytics 用 GTM タグでは、データレイヤーの GA4 EC データを使うオプションがあります。
GA360 で EC データを引き続き収集している場合は、GA4 EC イベントで発火するよう GTM 設定を更新してください。

• 更新: WooCommerce 連携で Yoast SEO と Rank Math SEO のプライマリカテゴリー選択に対応。
• 更新: gtm4wp_admin_page_capability フィルターで管理画面に必要な権限を変更可能 (emreerkan に感謝)。
• 修正: add_to_cart で整数価格に .00 が付かなかった問題。
• 追加: 新しい GA4 イベントの push 前に EC オブジェクトをクリアするオプション。
• 追加: 同意管理ツールが未対応の場合に備え、Google Consent Mode の default コマンドに対応。

1.18.1

• 修正: blocking_cookie 未定義の PHP 通知。

1.18

• 修正: 注文完了ページでの新規顧客判定エラー (morvy に感謝)。
• 修正: WooCommerce 注文完了ページで get_meta() on null エラー (Dekadinious に感謝)。
• 更新: WordPress / WooCommerce の互換性を更新。
• 更新: Google Optimize は 2023 年 9 月終了のため連携を非推奨化。
• 追加: Cookie 設定後に block_gtm4wp_geoip という Cookie を作成。値を “yes”、”true”、”on”、”1” のいずれかにすると、そのユーザーでは GeoIP (と天気 API) を無効化。