GDPR関数

以下の utag.gdpr 関数が利用可能です：

関数	説明
`dns.getDnsState()`	`dns` 同意クッキーの値を返します。
`dns.setDnsState()`	`dns` 同意クッキーの値を構成します。
`getCategories()`	タグのグループ化に利用可能なコンプライアンスカテゴリのリストを `Array` で返します。
`getCategoryLanguage()`	アクティブな言語でのカテゴリ名と説明を含む `Object` を返します。
`getConsentState()`	ユーザーが与えた同意を全面的、拒否、同意なし、または部分的な同意として返します。
`getCookieValues()`	同意クッキーを表す `Object` を返します。
`getLanguage()`	同意マネージャーのコンテンツを表示するために使用される言語を `String` で返します。
`getSelectedCategories()`	顧客が選択したカテゴリを `Array` で返します。
`setAllCategories()`	すべてのカテゴリを同意したか拒否したかの同意状態に構成し、（オプションで）同意を追跡するためにCollect APIを呼び出します。
`setConsentValue()`	同意クッキーの値を有効または無効に構成します。
`setCookie()`	クッキー `Object` に直接書き込む内部関数。
`setCookieValue()`	同意クッキーの個々の値を構成します。
`setPreferencesFromList()`	カテゴリのリストに対して同意状態を `allowed` に構成します。
`setPreferencesValues()`	カテゴリとその同意状態の `Object` からクッキーの値を構成します。
`showConsentPreferences()`	プリファレンスマネージャーのポップアップを表示します。
`showDoNotSellBanner()`	CCPAバナーを表示します。
`showDoNotSellPrompt()`	CCPAバナーを表示します。
`showExplicitConsent()`	明示的な同意のポップアップを表示します。
`updateConsentCookie()`	隠されたウェブビューを使用してアプリからモバイル同意を更新します。

`utag.gdpr.dns.getDnsState()`

dns 同意クッキーの値（true または false）を返します。

`utag.gdpr.dns.setDnsState()`

dns 同意クッキーの値を構成します。認識される値：true、false、1、0、"true"、"false"。

例：

utag.gdpr.dns.setDnsState(true);

`utag.gdpr.getCategories()`

タグのグループ化に利用可能なコンプライアンスカテゴリのリストを Array で返します。パラメータが提供されない場合、すべてのカテゴリが返されます。パラメータとして true または 1 を渡すと、Tealium Consent Preference Managerインターフェースで有効（アクティブ）なカテゴリのみが返されます。

utag.gdpr.getCategories(onlyEnabledCats)

パラメータ	タイプ	説明
`onlyEnabledCats`	`Boolean`	（オプション）`true` または `1` に構成すると、有効（アクティブ）なカテゴリが返されます。

以下の例は、utag.gdpr.getCategories() がすべてのカテゴリを返すときの結果を示しています：

["analytics", "affiliates", "display_ads", "search", "email", "personalization", "social", "big_data", "misc", "cookiematch", "cdp", "mobile", "engagement", "monitoring", "crm"]

以下の例は、utag.gdpr.getCategories() が有効なカテゴリを返すときの結果を示しています：

["analytics", "affiliates", "personalization"]

`utag.gdpr.getCategoryLanguage()`

アクティブな言語でのカテゴリ名と説明を含む Object を返します。カテゴリの言語は、getLanguage() 関数が返す言語です。

カテゴリに関する詳細情報は、同意の構成を管理するを参照してください。

utag.gdpr.getCategoryLanguage(category)

パラメータ	タイプ	説明
`category`	`String`	カテゴリの名前。

以下の例は、言語が英語の場合に utag.gdpr.getCategoryLanguage("analytics") によって返される Object を示しています：

{name: "Cookies that help us improve our website", notes: "These cookies help us understand how people use our website."}

以下の例は、言語がポーランド語の場合に utag.gdpr.getCategoryLanguage("analytics") によって返される Object を示しています：

{name: "Pliki cookie dotyczące wydajności", notes: "Te pliki cookie gromadzą informacje o tym, jak odw…dynie w celu ulepszania działania naszej witryny."}

`utag.gdpr.getConsentState()`

以下の2つのデータタイプのいずれかを返します：

同意状態（全面的、拒否、または同意なし）を示す数値。
部分的な同意の場合、カテゴリ別の同意を指定する Object の Array。

全面的、拒否、または同意がない場合、以下の同意状態の値のいずれかが返されます：

同意状態	同意値	説明
全面的	`1`	全面的な同意が与えられました（クッキー上の `consent:true`）。
拒否	`-1`	同意が拒否されました（クッキー上の `consent:false`）。
なし	`0`	同意が与えられていません（クッキーが存在しない）。

部分的な同意が与えられた場合、Object の Array が返されます。各 Object は同意カテゴリを表します。Array 内の各 Object では、"ct" キーが同意値（1/0）を表し、"name" キーが同意カテゴリを指定します。

utag.gdpr.getConsentState()

以下の例は、部分的な同意のために返される Object の Array を示しています：

[{"ct":"1","name":"analytics"},
{"ct":"0","name":"affiliates"},
{"ct":"0","name":"display_ads"},
{"ct":"0","name":"search"},
{"ct":"0","name":"email"},
{"ct":"0","name":"personalization"},
{"ct":"0","name":"social"},
{"ct":"0","name":"big_data"},
{"ct":"0","name":"misc"},
{"ct":"0","name":"cookiematch"},
{"ct":"0","name":"cdp"},
{"ct":"0","name":"mobile"},
{"ct":"0","name":"engagement"},
{"ct":"0","name":"monitoring"},
{"ct":"0","name":"crm"}]

`utag.gdpr.getCookieValues()`

この関数を直接使用する代わりに、クッキーを読み取るために getCookieValues() 関数を呼び出す utag.gdpr.getConsentState() のような関数を使用することをお勧めします。

同意クッキーをキーと値のペアとして表す Object を返します。この関数はデフォルトのクッキー名前空間（CONSENTMGR）を使用するか、window.utag_cfg_ovrd.cmcookiens で提供された値を使用します。逆の関数（クッキーに書き込む）は utag.gdpr.setCookie() です。

utag.gdpr.getCookieValues()

以下の例は、部分的な同意のために utag.gdpr.getCookieValues() によって返される Array を示しています：

{
    "c1":"1",
    "c2":"0",
    "c3":"0",
    "c4":"0",
    "c5":"0",
    "c6":"0",
    "c7":"0",
    "c8":"0",
    "C9":"0",
    "c10":"0",
    "c11":"0",
    "c12":"0",
    "c13":"0",
    "c14":"0",
    "c15":"0",
    "ts":"1586965568213",
    "consent":"true"
}

以下の例は、全面的な同意のために utag.gdpr.getCookieValues() によって返される Array を示しています：

utag.gdpr.getCategories(true)

{"consent":"true","ts":"1587026030058"}

`utag.gdpr.getLanguage()`

同意マネージャーのコンテンツを表示するために使用される言語を String で返します。データレイヤーで構成された言語、ブラウザからの言語、またはデフォルトの言語の優先順位によります。

utag.gdpr.getLanguage()

以下の例は、言語が英語（イギリス）の場合に返される String を示しています：

"en-gb"

`utag.gdpr.getSelectedCategories()`

顧客が選択したカテゴリを含む Array を返します。

utag.gdpr.getSelectedCategories()

次の例は、utag.gdpr.getSelectedCategories()によって返されるArrayを示しています：

["analytics", "personalization"]

`utag.gdpr.setAllCategories()`

すべてのカテゴリを同意したか拒否したかの同じ同意状態に構成し、（オプションで）同意を追跡するためにCollect APIを呼び出します。

utag.gdpr.setAllCategories(state, noCollect)

パラメータ	タイプ	説明
`state`	`Boolean`	すべてのカテゴリに対する同意を許可するには`true`を構成し、同意を拒否するには`false`を構成します。
`noCollect`	`Boolean`	（オプション）同意を追跡するためにCollect APIを呼び出さないようにするには`true`を構成します。

次の例は、すべてのカテゴリに対する同意を指定し、Collect APIへの呼び出しはありません：

utag.gdpr.setAllCategories(true,true)

次の例は、すべてのカテゴリに対する同意を拒否し、同意を追跡するためにCollect APIを呼び出します：

utag.gdpr.setAllCategories(false)

`utag.gdpr.setConsentValue()`

同意クッキーの値を有効または無効に構成します。この関数は同意のタイムスタンプを更新し、Collect APIへの追跡呼び出しを生成し、キューutag.gdpr.queueに保持されているタグを再生します。

utag.gdpr.setConsentValue()は個々のカテゴリの同意値を変更しません。同意値は関連するAPI呼び出し（setPreferencesFromList()またはsetPreferencesValues()）を介して無効にする必要があります。

utag.gdpr.setConsentValue(_response)

パラメータ	タイプ	説明
`_response`	`Boolean`	同意を有効にするには`true`を構成し、同意を無効にするには`false`を構成します。

次の例は、クッキーの値を"consent:true"に構成し、タイムスタンプを更新します：

utag.gdpr.setConsentValue(true)

次の例は、クッキーの値を"consent:false"に構成し、タイムスタンプを更新します：

utag.gdpr.setConsentValue(0)

`utag.gdpr.setCookie()`

この関数を直接呼び出すことはお勧めしません。

クッキーObjectに直接書き込む内部関数です。同意状態、タイムスタンプ、部分的な同意のためのさまざまなカテゴリを表すためにObjectを使用します。自動的に正しいクッキー名と有効期限を使用します。

utag.gdpr.setCookie(onlyEnabledCats)

パラメータ	タイプ	説明
`cookieData`	`Object`	同意クッキーに保存されているデータを表すキー値のリスト。

例：

var object = {"c6":"1","c1":"0","c2":"0","ts":1587133550264,"consent":"false","c3":"0","c4":"0","c5":"0","c7":"0","c8":"0","c9":"0","c10":"0","c11":"0","c12":"0","c13":"0","c14":"0","c15":"0"}

utag.gdpr.setCookie(object)

`utag.gdpr.setCookieValue()`

同意クッキーの個々の値を構成します。

この関数は、setConsentValue()などの他の高レベルの関数によって使用されます。この方法は慎重に使用し、初期のニーズを満たさない場合にのみ使用してください。

utag.gdpr.setCookieValue(key, value);

パラメータ	タイプ	説明
`key`	`String`	クッキーに構成されるキー。`consent`、`ts`、または`c`値表現によって指定されたカテゴリのいずれかに構成します。例えば、Analyticsの場合は`c1`、Affiliatesの場合は`c2`など。
`value`	`String`	クッキーのキーに構成する値。

次の例は、同意クッキーを"consent:false"に構成します：

utag.gdpr.setCookieValue("consent", false);

次の例は、同意クッキーを"c1:0"に構成します：

utag.gdpr.setCookieValue("c1", 0);

`utag.gdpr.setPreferencesFromList()`

パラメータで渡されたカテゴリのリストに対する同意状態をallowedに構成します。リストに含まれていないカテゴリの同意状態はdeclinedに構成されます。これは部分的な同意のために使用されます。この関数はsetPreferencesValues()関数に依存し、getSelectedCategories()の逆の機能を提供します。

utag.gdpr.setPreferencesFromList(list)

パラメータ	タイプ	説明
`List`	`Array`	有効なカテゴリの`Array`。

次の例は、同意クッキーの"analytics"カテゴリの同意状態を構成します：

utag.gdpr.setPreferencesFromList(["analytics"])

`utag.gdpr.setPreferencesValues()`

カテゴリとその同意状態のObjectからクッキーの構成値を構成します。この関数は主にsetPreferencesFromList()関数によって呼び出されます。この関数は、キューutag.gdpr.queueに保持されているタグを再生します。

utag.gdpr.setPreferencesValues(state, noCollect)

パラメータ	タイプ	説明
`state`	`Object`	`category:consentState`の形式のキー値ペア。
`noCollect`	`Boolean`	（オプション）同意を追跡するためにCollect APIを呼び出さないようにするには`true`を構成します。

次の例は、"analytics"、"affiliates"、"personalization"カテゴリのクッキー値を構成します：

Var cats = {"analytics":"1","affiliates":"0","personalization":"0"}
utag.gdpr.setPreferencesValues(cats)

`utag.gdpr.showConsentPreferences()`

同意の構成ポップアップを表示します。この関数は、ページ内のカスタマイズで定義されたCSS、HTML、JavaScriptを注入します。明示的な同意のJavaScriptリスナーから呼び出されるか、ユーザーが構成を変更したいページの任意のポイントから呼び出されます。

utag.gdpr.showConsentPreferences(_lang)

パラメータ	タイプ	説明
`_lang`	`String`	オプション。ISO形式で指定された言語、例えば`en`や`en-gb`。

次の例は、デフォルトの言語またはデータレイヤーで構成された言語で同意を表示します：

utag.gdpr.showConsentPreferences()

次の例は、フランス語で同意を表示します：

utag.gdpr.showConsentPreferences("fr-fr")

`utag.gdpr.showDoNotSellBanner()`

CCPAバナーを表示します。デフォルトでは、この関数は強制ルールがtrueに評価されたときに呼び出されます。

utag.gdpr.showDoNotSellBanner(_lang)

パラメータ	タイプ	説明
`_lang`	`String`	オプション。ISO形式で指定された言語、例えば`en`や`en-gb`。

次の例は、デフォルトの言語またはデータレイヤーで構成された言語でCCPAバナーを表示します：

utag.gdpr.showDoNotSellBanner()

次の例は、フランス語でOpt-outバナーを表示します：

utag.gdpr.showDoNotSellBanner("fr-fr")

`utag.gdpr.showDoNotSellPrompt()`

Opt-outポップアップを表示します。バナーを使用していない場合は、この関数をサイトのバナーに統合して、訪問が同意構成を変更する方法を提供します。

utag.gdpr.showDoNotSellPrompt(_lang)

パラメータ	タイプ	説明
`_lang`	`String`	オプション。ISO形式で指定された言語、例えば`en`や`en-gb`。

次の例は、デフォルトの言語またはデータレイヤーで構成された言語でCCPAポップアップを表示します：

<a href="javascript: utag.gdpr.showDoNotSellPrompt()">同意を変更</a>

次の例は、フランス語でOpt-out Modelポップアップを表示します：

<a href="javascript: utag.gdpr.showDoNotSellPrompt('fr-fr')">同意を変更</a>

`utag.gdpr.showExplicitConsent()`

明示的な同意ポップアップを表示します。この関数は、ページ内のカスタマイズで定義されたCSS、HTML、JavaScriptを注入します。明示的な同意が構成されている場合、Tealium Universal Tag utag.jsによってDOM READYイベント時にネイティブに呼び出されます。

utag.gdpr.showExplicitConsent(_lang)

パラメータ	タイプ	説明
`_lang`	`String`	（オプション）ISO形式で指定された言語、例えば`en`や`en-gb`。

次の例は、デフォルトの言語またはデータレイヤーで構成された言語で明示的な同意を表示します：

utag.gdpr.showExplicitConsent()

次の例は、フランス語で明示的な同意を表示します：

utag.gdpr.showExplicitConsent("fr-fr")

`utag.gdpr.updateConsentCookie()`

隠されたwebviewを使用してアプリからモバイル同意を更新します。

utag.gdpr.updateConsentCookie()