Usercentrics - Kameleoon Documentation

Usercentrics 同意管理プラットフォームには、必要かつ最新のデータプライバシー情報がすべて含まれています。 Usercentrics 統合により、Kameleoon は Usercentrics に自動的に接続し、プラットフォーム内の同意ポリシーにアクセスし、Web サイトで実験やパーソナライゼーションを表示する際にこれを使用します。 主なメリット:

追加設定なしで、Usercentrics CMP を通じてユーザーの同意を自動的に管理できます。
同意管理の一貫性を確保し、シームレスなコンプライアンスを実現します。
ユーザーのデータが準拠した方法で使用されていることを安心していただけます。

Usercentrics に Kameleoon を Data Processing Service として追加する

Usercentrics で新しい Data Processing Service を選択する必要があります。手順は以下のとおりです:

Usercentrics の管理インターフェースで Service Settings をクリックします。
Add DPS via Database > Kameleoon をクリックします。

Category ドロップダウンでカテゴリを選択します。

Kameleoon テンプレート ID:

Kameleoon AB Testing&Personalization / Template ID: H1yDxp7JN
Kameleoon Only AB Testing Module / Template ID: 9FYjH37-J
Kameleoon Only Personalization Module / Template ID: 2lh8-reEz

Usercentrics で IAB TCF をセットアップする

IAB TCF 2.2 (Usercentrics & Kameleoon) を有効化するには、以下の手順を完了する必要があります:

Usercentrics で Kameleoon をベンダー (id:820) としてセットアップします。
Usercentrics の管理インターフェースで Service Settings に移動します。
CMP バージョンを Version 2 に設定します。

Configuration をクリックします。
Transparency & Consent Framework 2.2 (TCF) を有効化します。

Kameleoon で IAB TCF 統合を有効化します。

Usercentrics で TCF 2.2 を有効化できない場合は、カスタムスクリプトのセットアップを使用できます。

同意のステータスが不明な場合 (初回訪問時)、Kameleoon をブロックしないでください。そうしないと、このセットアップは無効になります。

このセットアップは、追跡なしで未知の同意ステータスでユーザーにキャンペーンを表示するように最適化されています。プロジェクトのエントリーページで A/B テストの変更を表示することもできます。

Kameleoon で同意管理ポリシーを定義し、Consent required を選択します。
以下の Kameleoon 関数を統合します:
- enableLegalConsent
- disableLegalConsent

Kameleoon の法的同意の詳細については、こちらのドキュメントを参照してください。状態とモードに関するより技術的な情報については、こちらのドキュメントを参照してください。

ページ内、Google Tag Manager、または Kameleoon アプリの Global custom script で、カスタムスクリプトを直接使用できます。 Global custom script でカスタムスクリプトを使用したい場合は、以下の手順に従ってください:

Projects メニューに移動します。
サイトまたはモバイルアプリのカードの Configuration をクリックします。

General セクションを展開します。
選択した Kameleoon テンプレートに応じて、以下のコードブロックのいずれかをコピーして貼り付けます。

A/B テストとパーソナライゼーションが同じサービスにある場合のカスタムスクリプトの例

Kameleoon AB Testing&Personalization / Template ID: H1yDxp7JN

function setConsentStatus(type, status, action) {
        if (status) {
            window.kameleoonQueue.push(function() {
                Kameleoon.API.Core.enableLegalConsent(type);
                console.log('enableLegalConsent ' + type)
            });
        } else if (!status) {
            window.kameleoonQueue.push(function() {
                Kameleoon.API.Core.disableLegalConsent(type);
                console.log('disableLegalConsent ' + type)
            });
        }
    }

    function initKameleoonLegalConsent(type) {
        window.kameleoonQueue = window.kameleoonQueue || [];
        window.kameleoonQueue.push(function() {
            Kameleoon.API.Core.runWhenConditionTrue(() => typeof UC_UI !== 'undefined' 
            && UC_UI.isInitialized() === true
            && window.localStorage.getItem('uc_user_interaction') === 'true', () => {
                const abtesting = UC_UI.getServicesBaseInfo().filter((service) => service && service.id === 'H1yDxp7JN');
                if (abtesting.length > 0) {
                    setConsentStatus('BOTH', abtesting[0].consent.status);
                }
            }, 200);
        });
    }
    initKameleoonLegalConsent();

A/B テストとパーソナライゼーションが異なるサービスにある場合のカスタムスクリプトの例

Kameleoon Only AB Testing Module = Template ID: 9FYjH37-J
Kameleoon Only Personalization Module = Template ID: 2lh8-reEz

function setConsentStatus(type, status, action) {
        if (status) {
            window.kameleoonQueue.push(function() {
                Kameleoon.API.Core.enableLegalConsent(type);
                console.log('enableLegalConsent ' + type)
            });
        } else if (!status) {
            window.kameleoonQueue.push(function() {
                Kameleoon.API.Core.disableLegalConsent(type);
                console.log('disableLegalConsent ' + type)
            });
        }
    }

    function initKameleoonLegalConsent(type) {
        window.kameleoonQueue = window.kameleoonQueue || [];
        window.kameleoonQueue.push(function() {
            Kameleoon.API.Core.runWhenConditionTrue(() => typeof UC_UI !== 'undefined' 
            && UC_UI.isInitialized() === true
            && window.localStorage.getItem('uc_user_interaction') === 'true', () => {
                const abtesting = UC_UI.getServicesBaseInfo().filter((service) => service && service.id === '9FYjH37-J');
                if (abtesting.length > 0) {
                    setConsentStatus('AB_TESTING', abtesting[0].consent.status);
                }
                const perso = UC_UI.getServicesBaseInfo().filter((service) => service && service.id === '2lh8-reEz');
                if (perso.length > 0) {
                    setConsentStatus('PERSONALIZATION',perso[0].consent.status);
                }
            }, 200);
        });
    }
    initKameleoonLegalConsent();

ご不明な点があれば、Kameleoon カスタマーサクセスマネージャーまでお気軽にお問い合わせください。

Usercentrics 同意バナーを A/B テストする

サイトごとに 1 つの同意実験のみを実行することをおすすめします。

Usercentrics 同意バナーで A/B テストを実行するには、まずゴールを作成する必要があります:

Configure > Goals > New goal をクリックします。
Website Selection で、アカウント作成時に定義した Web サイトを選択します。
Type で Custom Goal を選択します。
- 現在、Usercentrics はカスタムゴール用のいくつかのカスタムイベントをサポートしています。詳細はこちらをご覧ください。
Next をクリックします。
Name your goal フィールドにゴールの名前を入力します。
Describe your goal に Kameleoon.API.Goals.processConversion (内部に Unique ID を含む) を入力します。
- ID は New goal ポップインの関数テキストの末尾で確認できます。

新しいゴールを作成した後、実験を作成する必要があります:

Experiments ダッシュボードに移動します。
New Experiment をクリックします。作成する実験のタイプを尋ねるポップインが開きます。
In the code editor > JS/CSS をクリックします。
Name、Website、および 実験を開始したいページの URL を入力します。
Validate をクリックします。コードエディタが開きます。

Experiment (左メニューの Variations の真上) をクリックし、右側のメニューで Test specific code をクリックします。
以下のコードを追加します:

window.UC_AB_VARIANT = "variant0";
 window.addEventListener('UC_UI_CMP_EVENT', function (data) {
      console.log("TEST: source =>", data.detail.source);
      console.log("TEST: type =>", data.detail.type);
      console.log("TEST: Variant =>", data.detail.abTestVariant);
      //These are our custom events for each basic action
      //in our Consent Management Platform
      if (data.detail.type === "CMP_SHOWN") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "ACCEPT_ALL") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "DENY_ALL") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "SAVE") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "MORE_INFORMATION_LINK") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "IMPRINT_LINK") Kameleoon.API.Goals.processConversion(Your Unique ID);
      if (data.detail.type === "PRIVACY_POLICY_LINK") Kameleoon.API.Goals.processConversion(Your Unique ID);
  });

variant0 は空のバリアントとして定義されているデフォルトのバリアントで、同意管理プラットフォームに変更を加えないことを意味します。デフォルトのバリアントが別の名前である場合は、それに応じて変更してください。デフォルトのバリアントに移動するには window.UC_AB_VARIANT=”variant0” を使用します。
イベントリスナーは、カスタムイベント のいずれかを発火するたびにトリガーされます。A/B テスト用カスタムイベント に関する追加情報はこちらをご覧ください。
3 つの console.log はイベントに関する重要な情報を返します。たとえば、コードに示されているように ACCEPT_ALL をトラッキングするには、これらのログが表示されます:

 TEST: source => FIRST_LAYER
 TEST: type => ACCEPT_ALL
 TEST: Variant => variant1

必要に応じて、この実験に追加のゴールを追加できます。新しいゴールを追加するには、最後の「if」文の下に以下のコードを追加するだけです。 if (data.detail.type === "Consent Management Platform event here") Kameleoon.API.Goals.processConversion(goalID)

Variations タブに戻ります。
Variation 1 に、以下のコードを追加します: window.UC_AB_VARIANT = "variant1";
バリアントに別の名前を付けた場合は、variant1 を置き換えてください。
Finalize タブで、トラフィック分布、ターゲティング、トラッキング、ゴールを選択します。
- ここで、作成したゴールを追加します。ゴールの一意の ID で検索できます。検索に問題がある場合は、ゴール ID の最初の桁のみを使用してみてください。
Publish をクリックして実験のセットアップを最終化します。

このガイドでは、Usercentrics 内部 A/B テストについて説明しています。

​Usercentrics に Kameleoon を Data Processing Service として追加する

​Usercentrics で IAB TCF をセットアップする

​Kameleoon Legal Consent のカスタム統合

​A/B テストとパーソナライゼーションが同じサービスにある場合のカスタムスクリプトの例

​A/B テストとパーソナライゼーションが異なるサービスにある場合のカスタムスクリプトの例

​Usercentrics 同意バナーを A/B テストする

Usercentrics に Kameleoon を Data Processing Service として追加する

Usercentrics で IAB TCF をセットアップする

Kameleoon Legal Consent のカスタム統合

A/B テストとパーソナライゼーションが同じサービスにある場合のカスタムスクリプトの例

A/B テストとパーソナライゼーションが異なるサービスにある場合のカスタムスクリプトの例

Usercentrics 同意バナーを A/B テストする