記事

WordPressの同意API · 2026年8月15日

WordPressのWP Consent API: Cookieバナーが同意を共有する仕組み

WordPressの同意管理は、プラグイン間の連携でうまくいかないことがあります。バナーが1つの判断を保存し、分析は別のスイッチを使い、追跡プラグインにはマーケティングの拒否が伝わらない、といった状態です。WP Consent APIは、対応プラグインがこうした選択を共有するための共通の表現を提供します。

クリーム色の紙の上で同意トークンをつなぐ陶器の橋を写した静物写真。

APIの実際の役割から始める

WordPress.orgの公式WP Consent APIページでは、プラグイン間で受け入れられた同意カテゴリがどのように通信されるかを標準化するプラグインとして記述している。 これは同意のバナーではなく、あなたのサイトが何をロードできるかを決めません。 これには、バナープラグインと、APIをサポートする少なくとも他のプラグインが必要です。

この違いはWordPressを運用するチームにとって重要です。対応プラグインが、保存や追跡を始める前にstatisticsやmarketingなどのカテゴリへの同意を確認できる場合、APIが役立ちます。バナーには引き続き、わかりやすい選択肢を表示し、訪問者の判断を保存して、変更時にAPIを更新する役割があります。

バナーカテゴリを意図的にマップ

WP Consent APIはfunctional、preferences、statistics、statistics-anonymous、marketingなどのカテゴリを使用します。多くのWordPressバナーは似たカテゴリモデルを使用しますが、完全に同じではありません。名前が自動的に一致するとは考えず、各APIカテゴリをどのバナーカテゴリで制御するか決めたうえで、拒否とカスタム選択の両方をテストしてください。

ACookiesは必須機能を許可し、preferencesをpreferencesに、analyticsをstatisticsとstatistics-anonymousに、marketingをmarketingに対応付けます。これは次の条件で行われます: wp_set_consent が利用できる場合です。同じバナーの選択で、次のようなGoogle Consent Modeのシグナルも更新できます: analytics_storage, ad_storage, ad_user_data、および ad_personalization.

シグナリングとブロッキングを混同しないでください

WP Consent APIのページでは、Cookieの設定やデータ追跡が許可されているかをプラグインが判断する枠組みを提供すると説明しています。すべての外部iframe、外部スクリプト、テーマに直接書かれたコードを、それ自体でブロックするわけではありません。同意管理の実装によるブロック、遅延読み込み、代替表示が引き続き必要です。

Google Consent Modeは別の仕事を持っている。 GoogleはConsent Modeが同意選択に基づいてGoogleタグの振る舞いを調整することを説明し,そのウェブサイトの設定ガイドは広告ユーザデータとパーソナライゼーションのための追加v2信号をリストしている。 WP Consent APIの補完であり、WordPressプラグイン間通信の代替ではない。

WordPress-first レビューワークフローを使う

WP Consent APIへの対応を、サイト全体の確認の一部として扱ってください。どのWordPressプラグインが対応し、どのスクリプトをバナーが管理し、どのタグに手動ルールが必要かを調べます。その後、実際のページをスキャンしてCookieとネットワークリクエストを確認し、Googleタグがある場合はTag Assistantでシグナルを検証します。

  • WP Consent API プラグインは、スタックがブリッジを必要とする場合にのみ存在することを確認します。
  • 文章を公開する前に、バナーカテゴリとAPIカテゴリを対応付けます。
  • すべてに同意、任意Cookieを拒否、個別設定の各操作をテストします。
  • プラグイン、キャッシュ、GTM、テーマコードを変更した後に公開サイトを再スキャンします。
  • 手動ブロックルールを必要とする残りのスクリプトを文書化します。
重要: この記事は、WordPressの実装に関する技術的なガイドであり、法的な助言ではありません。 同意行動の検査を容易にするために,実際の文言,目的,保持,地域要求を正しい専門家の支援で見直す。

よくある質問

WP Consent API はCookieバナーを置き換えますか?

いいえ。WordPress.orgの公式プラグインページによると、WP Consent APIにはCookieバナープラグインと、APIに対応する別のプラグインが必要です。通信を標準化する仕組みであり、それ自体では同意を取得しません。

WP Consent API はすべてのサードパーティスクリプトをブロックしますか?

いいえ。対応プラグインはAPIで同意カテゴリを読み取れますが、外部スクリプトやiframeには、同意管理の仕組みによるブロックや読み込みの遅延が引き続き必要です。

ACookies はどのように WP Consent API シグナルを使用しますか?

APIが利用できる場合、ACookiesは訪問者向けカテゴリを、functional、preferences、statistics、statistics-anonymous、marketingなどのWP Consent APIカテゴリに対応付けます。

参考文献