WP Consent API

説明

WP Consent API は、承認済み同意カテゴリに関するプラグイン間の通信を標準化するプラグインです。本プラグインを利用するには、Cookieバナープラグインと、WP Consent API に対応したプラグインが少なくとも1つ必要です。

本プラグインを使用することで、対応するすべてのプラグインが、現在の同意カテゴリを読み取りおよび登録するために、同じメソッドセットを利用できるようになります。これにより、同意管理プラグインとその他のプラグインが連携して動作し、プライバシー関連法規への準拠が向上します。

警告: 本プラグイン自体は、同意処理を行いません。本プラグインは、Consent API に対応していないプラグインの数を表示し、Cookie バナープラグインと、Cookie を設定したりユーザーデータを追跡したりするプラグインとの間の連携を円滑にすることで、サイトのコンプライアンスを向上させます。

本プラグインは、どのような問題を解決しますか ?

現在、同意管理プラグインによって、Facebook、Google Maps、Twitter などのサードパーティ製サービスをブロックすることが可能です。しかし、WordPress プラグインが PHP クッキーを設定する場合、同意管理プラグインでは、これを阻止できません。

第二に、一部のプラグインは、JavaScript ファイル内にクライアントサイドのトラッキングコードを組み込んでおり、これがブロックされるとサイトが正常に動作しなくなります。

あるいは、そのようなプラグインの JavaScript が minify 処理されている場合、URL が判別不能となり、自動ブロックスクリプトによって検出されなくなる可能性があります。

最後に、ブロック方式を採用するには、データを追跡するあらゆる種類の URL のリストが必要となります。プラグインが準拠する汎用的な API があれば、ウェブマスターがサイトを準拠させる作業を大幅に容易にできます。

この API を使用することで、サードパーティのサービスによるユーザーデータの追跡は阻止されますか ?

この API は、主に WordPress プラグインによるコンプライアンスに準拠したファーストパーティ Cookie やトラッキングを対象としています。たとえば、Facebook などのプラグインが動作する場合、この API の利用が役立ちます。ユーザーが Facebook の iframe を埋め込んだ場合、最初にその iframe やスクリプトを無効にするブロックツールが必要となります。

サードパーティのスクリプトは、同意管理プラグインのブロック機能によってブロックする必要があります。これをコア機能で行うのは介入しすぎであり、またすべてのユーザーに適用できるものでもありません: EU などのオプトイン地域からの訪問者を持つユーザーのみが、このような機能を必要とするからです。また、このような機能には、システムに不具合が生じるリスクもあります。さらに、これらをブロックして適切なプレースホルダーを表示するには、より高度なコードが必要となりますが、前述の理由から、これらすべては WordPress コアの一部であるべきではないと私は考えます。

しくみは ?

特定の同意カテゴリ (たとえば、「マーケティング」) に対して、同意が得られているか否かを示す指標は、以下の2つです:
1) 地域ごとの consent_type (オプトイン、オプトアウト、またはその他の consent_type);
2) 訪問者の選択: 未設定、許可、拒否。

The consent_type is a function that wraps a filter, “wp_get_consent_type”. If there’s no consent management plugin to set it, it will return false. This will cause all consent categories to return true, allowing cookies to be set on all categories.

このフィルターを使用してオプトインが設定されている場合、訪問者の選択値が「許可」である場合にのみ、カテゴリは true を返します。

地域ベースの consent_type が「オプトアウト」の場合、訪問者の選択が設定されていないか、「許可」に設定されていると、true を返します。

クライアントサイドでは、同意管理用プラグインを使用して、同意の種類を動的に変更したり、いくつかのクッキーカテゴリを設定できたりします。

本プラグインは、フックを使用して変更を監視したり、特定のカテゴリの値を確認できます。

カテゴリやその他のほとんどの機能は、フィルターを使って拡張できます。

既存の連携

カテゴリ別に分類し、アルファベット順にソート

見本プラグイン

• 見本プラグイン。このプラグインは基本的にショートコードで構成されており、トラッキング中か否かを示すメッセージを表示する div 要素が含まれています。実際にはトラッキングは行われません 🙂

同意管理プロバイダー

• Abconsent Sirdata CMP。
• Beautiful Cookie Consent Banner。
• Clickio Consent
• Complianz GDPR/CCPA。
• Consent Studio。
• consentmanager。
• Conzent。
• Cookiebot。
• CookieFirst。
• CookieHub。
• CookieTractor。
• CookieYes – Cookie Banner for Cookie Consent。
• GDPR Cookie Compliance。
• GDPR Cookie Consent Plugin – CCPA Ready。
• GetTerms。
• iubenda | All-in-one Compliance。
• Pressidium Cookie Consent。
• TrustArc Cookie Consent Manager

同意要求プラグイン

• AddToAny。
• AFL UTM Tracker Plugin。
• Burst Statistics。
• Google Site Kit。
• Pixel Manager for WooCommerce。
• Woo。
• WP Statistics。

デモサイト

wpconsentapi.org
下記は、デモサイトの構築に使用したプラグインです:

• Complianz
• 見本プラグイン

javascript, consent management plugin

//set consent type
window.wp_consent_type = 'optin'

//dispatch event when consent type is defined. This is useful if the region is detected server side, so the consent type is defined later during the pageload
let event = new CustomEvent('wp_consent_type_defined');
document.dispatchEvent( event );


//consent management plugin sets cookie when consent category value changes
wp_set_consent('marketing', 'allow');

javascript, tracking plugin

//listen to consent change event
document.addEventListener("wp_listen_for_consent_change", function (e) {
  var changedConsentCategory = e.detail;
  for (var key in changedConsentCategory) {
    if (changedConsentCategory.hasOwnProperty(key)) {
      if (key === 'marketing' && changedConsentCategory[key] === 'allow') {
        console.log("just given consent, track user")
      }
    }
  }
});

//basic implementation of consent check:
if (wp_has_consent('marketing')){
  activateMarketing();
  console.log("set marketing stuff now!");
} else {
  console.log("No marketing stuff please!");
}

PHP

//declare compliance with consent level API
$plugin = plugin_basename( __FILE__ );
add_filter( "wp_consent_api_registered_{$plugin}", '__return_true' );

/**
* Example how a plugin can register cookies with the consent API
 * These cookies can then be shown on the front-end, to the user, with wp_get_cookie_info()
 */

function my_wordpress_register_cookies(){
    if ( function_exists( 'wp_add_cookie_info' ) ) {
        wp_add_cookie_info( 'AMP_token', 'AMP', 'marketing', __( 'Session' ), __( 'Store a unique User ID.' ) );
    }
}
add_action('plugins_loaded', 'my_wordpress_register_cookies');


if (wp_has_consent('marketing')){
//do marketing stuff
}

サービスレベル同意

カテゴリベースの同意に加え、この API はサービスレベルの同意制御もサポートしています。これにより、同意管理プラグインは、カテゴリとは独立して、特定のサービス (「google-analytics」や「facebook-pixel」など) に対する同意を許可または拒否できます。wp_has_service_consent() を使用してサービスの同意を確認する際、API はまず、そのサービスに対して明示的な同意が存在するか否かを確認します。明示的な同意が設定されていない場合、そのサービスのカテゴリの同意ステータスにフォールバックします。これにより、きめ細かに制御できます: ユーザーは統計用クッキーを一般的に受け入れる一方で、特定の分析サービスに対しては明示的に拒否できます。

サービス同意は、サーバー側 (PHP) とクライアント側 (JavaScript) の両方で確認および設定できます:

PHP:

//check if a specific service has consent
if ( wp_has_service_consent( 'google-analytics' ) ) {
    //activate google analytics
}

//check if a service is explicitly denied
if ( wp_is_service_denied( 'facebook-pixel' ) ) {
    //service was explicitly denied by user
}

//set service consent
wp_set_service_consent( 'google-analytics', true ); //grant consent
wp_set_service_consent( 'facebook-pixel', false ); //deny consent

//listen for service consent changes
add_action( 'wp_consent_service_changed', function( $service, $consented ) {
    error_log( "Service {$service} consent changed to: " . ( $consented ? 'granted' : 'denied' ) );
}, 10, 2 );

JavaScript:

//check service consent
if ( wp_has_service_consent( 'youtube' ) ) {
    //activate tracking
}

//check if explicitly denied
if ( wp_is_service_denied( 'facebook-pixel' ) ) {
    //service denied
}

//set service consent
wp_set_service_consent( 'youtube', true );

//listen for service consent changes
document.addEventListener( 'wp_consent_api_status_change_service', function( e ) {
    console.log( 'Service: ' + e.detail.service + ', consented: ' + e.detail.value );
});

コードに関するアドバイスはありますか ? GitHub にも参加しています !