Consents and Preferences データ型

Consent for Privacy, Personalization and Marketing Preferences データ型（以下「Consents and Preferences データ型」と呼びます）は、Experience Data Model （XDM）データ型です。このデータ型は、同意管理プラットフォーム（CMP）およびその他のソースからデータ操作で生成される顧客の権限と環境設定の収集をサポートすることを目的としています。

このドキュメントでは、Consents and Preferences データ型で提供されるフィールドの構造と意図された使用について説明します。

前提条件 prerequisites

このドキュメントでは、XDMとExperience Platformでのスキーマの使用について理解する必要があります。 続行する前に、次のドキュメントを確認してください。

データタイプ構造 structure

Consents and Preferences データタイプには、同意​および​ 環境設定 ​情報を取得するために使用される複数のフィールドが用意されています。

同意とは、顧客がデータの使用方法を指定できるオプションのことです。 同意の多くは法的側面を持っており、一部の法域では、データを特定の方法で使用する前に許可を得る必要があり、顧客が肯定的な同意を必要としない場合はその使用を停止（オプトアウト）するオプションを提供する必要があります。

環境設定とは、顧客が自社の体験のさまざまな側面をどのように扱うべきかを指定できるオプションのことです。 このカテゴリは次の2つに分類されます。

次のスクリーンショットは、Experience Platform UIでのデータタイプの構造の表現方法を示しています。

次のJSONは、Consents and Preferences データ型が処理できるデータ型の例を示しています。 これらの各フィールドの具体的な使用方法に関する情報は、以下の節で提供されます。

{
  "consents": {
    "collect": {
      "val": "VI",
    },
    "adID": {
      "idType": "IDFA",
      "val": "y"
    },
    "share": {
      "val": "y",
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "u"
      },
      "push": {
        "val": "n",
        "reason": "Too Frequent",
        "time": "2019-01-01T15:52:25+00:00"
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}

consents choices

consentsには、顧客の同意と環境設定を説明する複数のフィールドが含まれています。 これらのフィールドについて詳しくは、以下のサブセクションを参照してください。

"consents": {
  "collect": {
    "val": "VI",
  },
  "adID": {
    "idType": "IDFA",
    "val": "y"
  },
  "share": {
    "val": "y",
  },
  "personalize": {
    "content": {
      "val": "y"
    }
  },
  "marketing": {
    "preferred": "email",
    "any": {
      "val": "u"
    },
    "email": {
      "val": "n",
      "reason": "Too Frequent",
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}

collect

collectは、データの収集に対する顧客の同意を表します。

"collect": {
  "val": "y"
}

adID

adIDは、広告主IDを使用して、このデバイス上のアプリ間で顧客をリンクできるかどうかについての顧客の同意を表します。

"adID": {
  "idType": "IDFA",
  "val": "y"
}

share

shareは、自分のデータをセカンドパーティまたはサードパーティと共有（またはセールス）できるかどうかについての顧客の同意を表します。

"share": {
  "val": "y"
}

personalize personalize

personalizeは、データをパーソナライゼーションに使用する方法に関する顧客の嗜好を取得します。 顧客は、特定のパーソナライゼーションユースケースからオプトアウトするか、パーソナライゼーションから完全にオプトアウトすることができます。

"personalize": {
  "content": {
    "val": "y",
  }
}

marketing marketing

marketingは、データを使用できるマーケティング目的に関する顧客の嗜好を取得します。 顧客は、特定のマーケティングのユースケースからオプトアウトするか、ダイレクトマーケティングを完全にオプトアウトします。

"marketing": {
  "preferred": "email",
  "any": {
    "val": "u"
  },
  "email": {
    "val": "n",
    "reason": "Too Frequent"
  },
  "push": {
    "val": "y"
  },
  "sms": {
    "val": "y"
  }
}

metadata

metadataは、顧客の同意と環境設定に関する一般的なメタデータを、最後に更新されたときにいつでも取得します。

"metadata": {
  "time": "2019-01-01T15:52:25+00:00",
}

データタイプを使用したデータの取り込み ingest

Consents and Preferences データ型を使用して顧客から同意データを取り込むには、そのデータ型を含むスキーマに基づいてデータセットを作成する必要があります。

フィールドにデータタイプを割り当てる手順については、UIでのスキーマの作成に関するチュートリアルを参照してください。 データ型Consents and Preferencesのフィールドを含むスキーマを作成したら、既存のスキーマでデータセットを作成する手順に従って、データセットユーザーガイドの​ データセットの作成に関する節を参照してください。

同意と環境設定の変更の処理

顧客がweb サイト上の同意や嗜好を変更した場合、その変更を収集し、使用するデータ収集ライブラリで同意を設定することですぐに適用する必要があります。 お客様がデータ収集をオプトアウトした場合、すべてのデータ収集は直ちに停止する必要があります。 顧客がパーソナライゼーションをオプトアウトした場合、次のページにパーソナライゼーションが表示されないようにする必要があります。 JavaScript ライブラリを使用するsetConsent、またはタグ拡張機能を使用するSet consent アクションを参照してください。

付録 appendix

以下の節では、Consents and Preferences データタイプに関する追加参照情報を提供します。

val の許容値 choice-values

次の表は、valに使用できる値の概要を示しています。

preferred の許容値 preferred-values

次の表は、preferredに使用できる値の概要を示しています。 preferredの値は、データ収集、プライバシーポリシー、パーソナライゼーションオプションに関するコミュニケーションを受信する際に、顧客が好むチャネルを示します。

完全Consents and Preferences スキーマ full-schema

Consents and Preferences データタイプの完全なスキーマを表示するには、公式XDM リポジトリ ​を参照してください。