同意と環境設定 データ型

プライバシー、Personalizationおよびマーケティング設定に関する同意​ データ型 （以下、「同意と設定 データ型」と呼びます）は、同意管理プラットフォーム（CMP）およびその他のデータ運用ソースから生成される顧客権限と設定の収集をサポートすることを目的としたExperience Data Model （XDM）データ型です。

このドキュメントでは、同意と環境設定のデータタイプによって提供されるフィールドの構造と意図された使用について説明します。

前提条件 prerequisites

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

データタイプ構造 structure

同意と環境設定 データタイプには、同意​と​ 環境設定 ​の情報を取得するために使用されるいくつかのフィールドが用意されています。

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

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

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

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

{
  "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

同意と環境設定 データタイプを使用して顧客から同意データを取り込むには、そのデータタイプを含むスキーマに基づいてデータセットを作成する必要があります。

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

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

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

付録 appendix

以下の節では、同意と環境設定 データタイプに関する追加参照情報を提供します。

val の許容値 choice-values

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

preferred の許容値 preferred-values

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

完全な同意と環境設定 スキーマ full-schema

同意と環境設定 データタイプの完全なスキーマを表示するには、公式XDM リポジトリ ​を参照してください。